Oracle Repository API and Model Reference Guide


Contents


API Methods


Element Definitions


Index  

oracle.repos.services.connection
Class RepositoryConnection

java.lang.Object
  |
  +--oracle.repos.services.data.DataEventSource
        |
        +--oracle.repos.services.connection.RepositoryConnection
Direct Known Subclasses:
CASEConnection, CmdLineConnection
public class RepositoryConnection
extends DataEventSource
implements Cloneable, CWLogSettingsListener

This is the interface used by clients to manipulate the contents of a structured repository. Once a RepositoryConnection has been connected to a repository instance the client can perform data manipulation, workarea, version, naming and dependency related operations through API service objects obtained within the context of the RepositoryConnection objects

See Also:
WorkareaService, NamingService, DependencyService, VersionService

Inner Class Summary
static interface RepositoryConnection.ConnectionMode
           
static interface RepositoryConnection.ConnectionState
           
static interface RepositoryConnection.iStaticStrings
           
static interface RepositoryConnection.MetaDataLoad
           
static interface RepositoryConnection.ValidationScope
           

 

Field Summary
protected  MetaDataElement m_containingConnection
           
 Connection m_sqlConnection
           

 

Constructor Summary
protected RepositoryConnection()
           
  RepositoryConnection(Connection connection)
          Create a new RepositoryConnection, based on an existing JDBC connection.
  RepositoryConnection(RepositoryConnectDetails connect)
          Create a new RepositoryConnection, creating a new JDBC connection to a database.
  RepositoryConnection(String strConnect)
          Create a new RepositoryConnection, creating a new JDBC connection to a database with the specified username, password and Net8 service alias.
  RepositoryConnection(String strUser, String strPass, String strNet8)
          Create a new RepositoryConnection, creating a new JDBC connection to a database with the specified username, password and Net8 service alias.

 

Method Summary
 int abortActivity()
           
(package private)  void addDiagramToSession(RepositoryDiagram deDiag)
          remember the diagram used during this connection
 void addElementToWorkareasPrivateConfiguration(DataElement de)
          addElementToWorkareasPrivateConfiguration
 void addExchangeException(Exception e)
          During nested calls to doElementDataExchange(), subclass implementations of DataElement may trap explicit exceptions, typically property type, name or range exceptions, and store them against the RepositoryConnection for examination at the end of the load or save operation using getExchangeExceptions.
 void addRepositoryListener(RepositoryListener repositoryListener, int nOperationMask, Vector vecMetaElements)
          Adds a repository listener to this repository service.
(package private)  int cacheStatement(String strQuery, PreparedStatement stmt)
          Change the prepared statement with the SQL statement as a key.
protected  void checkCompatibleServer()
          Checks server compatiblility by comparing server version with the connection's compatible version numbers.
protected  int checkValidUser()
           
 void clearMode(int nMode)
           
 Object clone()
          Clones the object.
 void close()
          Closes this repository connection.
 int closeActivity()
           
 void compileWorkarea(oracle.repos.services.GID workareaId)
           
 RepositoryDiagram createDiagram(DataElement deDiagram)
          creates a diagram
 RepositoryDiagram createDiagram(String name, String diagramType, boolean bWriteThrough)
           
 void doPostConnectActions()
          Requests connection to perform post connect actions.
 Enumeration enumerateMetaDataElements()
          Returns an enumeration of the MetaDataElements cached in this Connection.
(package private)  RepositoryDiagram findDiagramInSession(RID ridDiag)
          find the diagram used during this connection
(package private)  RepositoryDiagram findDiagramInSession(String strDiagramName)
           
 IdentifiedItem getActiveApplicationSystem()
           
 IdentifiedItem getActiveWorkArea()
           
(package private)  PreparedStatement getCachedStatement(int nStatementId)
          Get the cached statement by ID (int)
(package private)  PreparedStatement getCachedStatement(String strQuery)
          Get the cached statement by SQL statement (String)
 String[] getCompatibleVersionNumbers()
           
 ConfigurationService getConfigurationService()
          Returns a ConfigurationService object for performing configuration operations on the current repository
 RepositoryConnectDetails getConnectDetails()
          Returns the a class describing the connection.
 Connection getConnection()
          Returns the underlying JDBC connection for this RepositoryConnection.
 int getConnectionState()
          Returns the unique identifier of this repository instance.
 String getConnectString()
          Returns the complete connect string for the connection
 oracle.repos.services.GID getCurrentActivityId()
          Get ID of current activity.
 oracle.repos.services.GID getCurrentActivityParentId()
          Get ID of current activity's parent.
 int getDataElementLoadMode()
          Get mode of loading data elements Dictates how Data Elements are loaded from database
 int getDefaultRowPrefetch()
           
 DependencyService getDependencyService()
          Returns a NamingService object for performing dependency-specific operations on the current repository
 RepositoryDiagram getDiagram(RID id)
          retrieve a diagram from the repository by its id
 RepositoryDiagram getDiagram(String strName)
          retrieve a diagram from the repository by its name
 Vector getDiagrams(String strDiagType)
          returns diagrams of strDiagType.
 Vector getDiagrams(String[] arrstrDiagType)
          returns diagrams of types defined by arrstrDiagType.
 DataEventSource getDynamicContainer()
          Implemented by DataEventSource subtypes - dynamic the static container (if any)
 DataElement getElement(RID ridId)
           
 String getFullPath(oracle.repos.services.GID id, String formatType, char fileSep)
           
 String getFullPath(oracle.repos.services.GID id, String formatType, char fileSep, String containerSep)
          getFullPath
 String getFullPathByIVID(oracle.repos.services.GID ivid, String formatType, char fileSep)
           
 oracle.repos.services.GID getLastContainerID()
           
 Vector getLoadedDiagrams()
          return the diagram used during this connection
 int getMaximumPatchMilestoneNumber()
          Gets the highest patch milestone number installed on server.
 int getMaximumPatchNumber()
          Gets the highest patch number installed on server.
  MetaDataElement getMetaDataElement(oracle.repos.services.GID gidTypeId)
           
 MetaDataElement getMetaDataElement(MetaDataElementDescriptor descMDE)
          Get meta data element from cache or load from database if not in cache
 MetaDataElement getMetaDataElement(String strTypeName)
          Get meta data element from cache or load from database if not in cache
 MetaDataElement getMetaDataElement(String strProductName, String strTypeName)
           
 MetaDataElement getMetaDataElement(String strProduct, String strType, int nPrimaryProperty)
           
 MetaDataElementList getMetaDataElements( MetaDataElementDescriptorList lisMdeDesc, boolean bDefer, boolean bAddToSession)
           
 int getMetaDataLoadMode()
          Get mode of loading meta data Dictates how Meta data is loaded from database
 MetaDataService getMetaDataService()
          Returns a MetaDataService object for retrieving meta data information
 int getMode()
           
 NamingService getNamingService()
          Returns a NamingService object for performing naming-specific operations on the current repository
 oracle.repos.services.GID getNewIdValue()
           
 RID getNewRID()
           
 int getNumberOfOpenActivities()
           
 String getOwningUserName()
           
 PatchService getPatchService()
          Returns a PatchService object for performing patch-specific operations on the current repository
 String getRepositoryBroadcastNotifier()
          Get Broadcast notifier of repository
 String getRepositoryUUID()
          Get UUID of repository
 DeliverableVersion getRepositoryVersion()
          getRepositoryVersion returns a DeliverableVersion of the Repository
 RID getRIDFromFullPath(String strFullPath, char chSeparator)
          Returns the RID of an element from its full path
 int getState()
           
 DataEventSource getStaticContainer()
          Implemented by DataEventSource subtypes - returns the static container (if any)
 TransactionService getTransactionService()
          Returns a TransactionService object for performing transaction operations on the current repository
 String getUID()
          Get Repository Unique ID.
 int getValidationPolicy()
          Returns the validation policy mask for this DataSet.
 String getValueFromRMInfo(String strName)
          RM$INFO holds named value pairs for details of current repository.
 VersionService getVersionService()
          Returns a VersionService object for performing version-specific operations on the current repository
 WorkareaService getWorkareaService()
          Returns a WorkareaService object for performing workarea-specific operations on the current repository.
 boolean isDesignerRepository()
          isDesignerRepository returns a true or false Is Legacy Repository
(package private)  boolean isDiagramInSession(RID ridDiag)
          is diagram used during this connection
 boolean isInMode(int nMode)
           
 boolean isOPSLogin()
           
 boolean isOracleRepository()
          isOracleRepository returns a true or false Is new Oracle Repository
protected  boolean isRepositoryUser()
           
 boolean isVersioningSupported()
          return true is repoistory supports versioning.
 boolean isWorkAreaNull()
           
 MetaDataElementList loadAllMetaDataElements(boolean bDefer, boolean bAddToSession)
           
MetaDataElementList loadMetaDataElements(MetaDataElementDescriptorList lisMdeDesc, boolean bDefer, boolean bAddToSession)
           
MetaDataElementList loadMetaDataElements(String strProductName, MetaDataElementDescriptorList lisMdeDesc, boolean bDefer, boolean bAddToSession)
           
 Vector loadPatches()
          loadPatches return a Vector of Strings of installed patches on the Repository
 Vector loadServerDeliverableVersions()
           
 void onCWLogSettingsChange()
          Called by CWLog just after it has changed any aspect of its configuration.
 int openActivity()
           
 AccessRights queryAccessRights(DataElement de)
           
 AccessRights queryAccessRights(DataElement de, String strGrantee)
           
 AccessRights queryAccessRights(oracle.repos.services.GID containerIRID)
           
  AccessRights queryAccessRights(oracle.repos.services.GID containerIRID, String strGrantee)
           
 MetaDataElement queryPACType(RID ridId)
           
 oracle.repos.services.GID queryPACTypeId(RID ridId)
           
(package private)  int readText(oracle.repos.services.GID eid, String txt_type, String buf, boolean trusted)
           
 void registerMetaElementAPI(String strClassName)
          Registers a MetaElementAPI implementation to manipulate a named meta-data type.
 void removeDiagramFromSession(RepositoryDiagram repDiag)
          remove the diagram from this session
 void removeRepositoryListener(RepositoryListener repositoryListener)
          Removes the specified RepositoryListener from the set being notified by this RepositoryConnection
 void saveDiagram(RepositoryDiagram repDiag, DataElementDescriptorList lisElements)
           
 void setActiveApplicationSystem(IdentifiedItem appsys)
           
 void setActiveApplicationSystem(String strName, RID id)
           
 void setActiveAppSys(oracle.repos.services.GID gidIRID)
           
 void setActiveWorkArea(IdentifiedItem wkArea)
           
 void setActiveWorkArea(String strName)
           
 void setActiveWorkArea(String strName, RID id)
           
 void setCompatibleVersionNumbers(String strCompatibleVersionNumbers)
          Sets the array of repository version numbers, of form n.n.n.n.n, that it is compatible to connect to.
 void setCompatibleVersionNumbers(String[] strCompatibleVersionNumber)
          Sets the array of repository version numbers, of form n.n.n.n.n, that it is compatible to connect to.
 int setConnection(Connection connection)
          Connects this instance to a repository using an existing JDBC connection.
 int setConnection(RepositoryConnectDetails connDetails)
          Connects this instance to a repository using the specified username, password and Net8 alias, creating a new JDBC connection in the process.
 int setConnection(String strConnect)
          Connects this instance to a repository using the specified username, password and Net8 alias, creating a new JDBC connection in the process.
 int setConnection(String strUser, String strPass, String strNet8)
          Connects this instance to a repository using the specified username, password and Net8 alias, creating a new JDBC connection in the process.
 void setDataElementLoadMode(int nType)
          Set mode of loading data elements Dictates how Data elements are loaded from database
static void setDefaultDiagnosticsOn()
          Deprecated. 24-Feb-00 DON'T DO THIS.
 void setDefaultProductforLoadingMetaData(String strProduct)
           
 void setDefaultRowPrefetch(int nMaxSize)
           
(package private)  void setLastContainerID(oracle.repos.services.GID gidLastContainerID)
           
 void setMetaDataLoadMode(int nType)
          Set mode of loading meta data Dictates how Meta data is loaded from database
 void setMode(int nMode)
           
(package private)  void setServerRmTrace(boolean bOn)
           
 void setValidationPolicy(int nValidationPolicy)
          Sets validation policy mask for this DataSet.
 boolean usingOracleExtensions()
           
protected  int validateConnection()
          Static method which returns the last RepositoryConnection instance which has been successfully connected to a repository.
(package private)  int writeText(oracle.repos.services.GID eid, String txt_type, String buf, boolean trusted)
           

 

Methods inherited from class oracle.repos.services.data.DataEventSource
addDataListener, dispatchEvent, enumerateDataListeners, removeDataListener

 

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Field Detail

m_sqlConnection

public Connection m_sqlConnection

m_containingConnection

protected MetaDataElement m_containingConnection
Constructor Detail

RepositoryConnection

public RepositoryConnection(String strUser,
                            String strPass,
                            String strNet8)
                     throws ReposServiceException
Create a new RepositoryConnection, creating a new JDBC connection to a database with the specified username, password and Net8 service alias.
Parameters:
strUser - the username
strPass - the password
strNet8 - the Net8 service alias
Throws:
ReposServiceException - on error

RepositoryConnection

public RepositoryConnection(String strConnect)
                     throws ReposServiceException
Create a new RepositoryConnection, creating a new JDBC connection to a database with the specified username, password and Net8 service alias.
Parameters:
strUser - the username
strPass - the password
strNet8 - the Net8 service alias
Throws:
ReposServiceException - on error

RepositoryConnection

protected RepositoryConnection()

RepositoryConnection

public RepositoryConnection(Connection connection)
                     throws ReposServiceException
Create a new RepositoryConnection, based on an existing JDBC connection.
Parameters:
connection - the existing JDBC connection.
Throws:
ReposServiceException - on error

RepositoryConnection

public RepositoryConnection(RepositoryConnectDetails connect)
                     throws ReposServiceException
Create a new RepositoryConnection, creating a new JDBC connection to a database.
Parameters:
RepositoryConnectDetails -  
Throws:
ReposServiceException - on error
Method Detail

clone

public Object clone()
Clones the object.
Overrides:
clone in class DataEventSource
Returns:
a new copy of the object.

compileWorkarea

public void compileWorkarea(oracle.repos.services.GID workareaId)
                     throws ReposServiceException

getStaticContainer

public DataEventSource getStaticContainer()
Implemented by DataEventSource subtypes - returns the static container (if any)
Overrides:
getStaticContainer in class DataEventSource

getDynamicContainer

public DataEventSource getDynamicContainer()
Implemented by DataEventSource subtypes - dynamic the static container (if any)
Overrides:
getDynamicContainer in class DataEventSource

setConnection

public int setConnection(String strConnect)
                  throws ConnectionValidationException,
                         ReposServiceException
Connects this instance to a repository using the specified username, password and Net8 alias, creating a new JDBC connection in the process. Any existing connection is implicitly closed.
Parameters:
strUser - the username/password@Net8 service alias
Throws:
ReposServiceException - on error

setConnection

public int setConnection(String strUser,
                         String strPass,
                         String strNet8)
                  throws ConnectionValidationException,
                         ReposServiceException
Connects this instance to a repository using the specified username, password and Net8 alias, creating a new JDBC connection in the process. Any existing connection is implicitly closed.
Parameters:
strUser - the username
strPass - the password
strNet8 - the Net8 service alias
Throws:
ReposServiceException - on error

setConnection

public int setConnection(RepositoryConnectDetails connDetails)
                  throws ConnectionValidationException,
                         ReposServiceException
Connects this instance to a repository using the specified username, password and Net8 alias, creating a new JDBC connection in the process. Any existing connection is implicitly closed.
Parameters:
connection - details
Throws:
oracle.repos.services.ConnectionValidationException - if the connection fails any validation check.
ReposServiceException - on any other error.
See Also:
RepositoryConnection.validateConnection()

doPostConnectActions

public void doPostConnectActions()
                          throws ReposServiceException
Requests connection to perform post connect actions.

isOPSLogin

public boolean isOPSLogin()

setConnection

public int setConnection(Connection connection)
                  throws ReposServiceException
Connects this instance to a repository using an existing JDBC connection. Any existing connection is implicitly closed.
Parameters:
connection - the existing JDBC connection.
Throws:
ReposServiceException - on error

getConnection

public Connection getConnection()
Returns the underlying JDBC connection for this RepositoryConnection. Typically, client should call getQueryConnection to obtain a read-only wrapper for this JDBC connection.
Returns:
the underlying JDBC connection

getConnectDetails

public RepositoryConnectDetails getConnectDetails()
Returns the a class describing the connection. Used to get username, password and host name
Returns:
the RepositoryConnectDetails

getConnectString

public String getConnectString()
Returns the complete connect string for the connection
Returns:
the username/password@host

getWorkareaService

public WorkareaService getWorkareaService()
                                   throws ReposServiceException
Returns a WorkareaService object for performing workarea-specific operations on the current repository.
Throws:
ReposServiceException - on error

getVersionService

public VersionService getVersionService()
Returns a VersionService object for performing version-specific operations on the current repository

getPatchService

public PatchService getPatchService()
Returns a PatchService object for performing patch-specific operations on the current repository

getMetaDataService

public MetaDataService getMetaDataService()
Returns a MetaDataService object for retrieving meta data information

getConfigurationService

public ConfigurationService getConfigurationService()
Returns a ConfigurationService object for performing configuration operations on the current repository

getTransactionService

public TransactionService getTransactionService()
Returns a TransactionService object for performing transaction operations on the current repository

getNamingService

public NamingService getNamingService()
Returns a NamingService object for performing naming-specific operations on the current repository

getDependencyService

public DependencyService getDependencyService()
Returns a NamingService object for performing dependency-specific operations on the current repository

getConnectionState

public int getConnectionState()
Returns the unique identifier of this repository instance.
Returns:
the repository UUID
Throws:
ReposServiceException - on error

getActiveWorkArea

public IdentifiedItem getActiveWorkArea()

isWorkAreaNull

public boolean isWorkAreaNull()

setActiveWorkArea

public void setActiveWorkArea(IdentifiedItem wkArea)
                       throws ReposServiceException

setActiveWorkArea

public void setActiveWorkArea(String strName,
                              RID id)
                       throws ReposServiceException

setActiveWorkArea

public void setActiveWorkArea(String strName)
                       throws ReposServiceException

getActiveApplicationSystem

public IdentifiedItem getActiveApplicationSystem()

setActiveApplicationSystem

public void setActiveApplicationSystem(IdentifiedItem appsys)
                                throws ReposServiceException

setActiveApplicationSystem

public void setActiveApplicationSystem(String strName,
                                       RID id)
                                throws ReposServiceException

setLastContainerID

void setLastContainerID(oracle.repos.services.GID gidLastContainerID)

getLastContainerID

public oracle.repos.services.GID getLastContainerID()

getMetaDataLoadMode

public int getMetaDataLoadMode()
Get mode of loading meta data Dictates how Meta data is loaded from database
Returns:
- int - meta data load mode defined by
See Also:
RepositoryConnection.MetaDataLoad

setMetaDataLoadMode

public void setMetaDataLoadMode(int nType)
Set mode of loading meta data Dictates how Meta data is loaded from database
Parameters:
nType - - meta data load mode defined by
See Also:
RepositoryConnection.MetaDataLoad

getDataElementLoadMode

public int getDataElementLoadMode()
Get mode of loading data elements Dictates how Data Elements are loaded from database
Returns:
- int - data load mode defined by
See Also:
MetaDataElement.DataElementLoadMode

setDataElementLoadMode

public void setDataElementLoadMode(int nType)
Set mode of loading data elements Dictates how Data elements are loaded from database
Parameters:
nType - - data load mode defined by
See Also:
MetaDataElement.DataElementLoadMode

registerMetaElementAPI

public void registerMetaElementAPI(String strClassName)
                            throws ReposServiceException
Registers a MetaElementAPI implementation to manipulate a named meta-data type. The RepositoryConnection will use the registered MetaElementAPI instance to manipulate repository elements as required.
Parameters:
strClassName - the MetaElementAPI class to register.
Throws:
ReposServiceException - thrown on error

addRepositoryListener

public void addRepositoryListener(RepositoryListener repositoryListener,
                                  int nOperationMask,
                                  Vector vecMetaElements)
                           throws ReposServiceException
Adds a repository listener to this repository service. When changes are committed to this RepositoryConnection the listener's onRepositoryConnectionChanged method is notified. The client may optionally specify a both an operation and meta-element filter for notification messages.
Parameters:
repositoryListener - the listener instance.
nOperationMask - the mask of RepositoryListener.REPOS_ELEMENT_OP_* filter masks.
vecMetaElements - a Vector of java.lang.String meta-element names with which to filter notifications. May be null.
Throws:
ReposServiceException - thrown on error

removeRepositoryListener

public void removeRepositoryListener(RepositoryListener repositoryListener)
                              throws ReposServiceException
Removes the specified RepositoryListener from the set being notified by this RepositoryConnection
Throws:
ReposServiceException - thrown on error

addExchangeException

public void addExchangeException(Exception e)
During nested calls to doElementDataExchange(), subclass implementations of DataElement may trap explicit exceptions, typically property type, name or range exceptions, and store them against the RepositoryConnection for examination at the end of the load or save operation using getExchangeExceptions.
Parameters:
e - the exception to add.

close

public void close()
           throws ReposServiceException
Closes this repository connection. The underlying JDBC connection is terminated without implicitly committing data, all JDBC resources and any default dataset are released.
Throws:
ReposServiceException - thrown on error

validateConnection

protected int validateConnection()
                          throws ReposServiceException
Static method which returns the last RepositoryConnection instance which has been successfully connected to a repository. Not intended for end-client use

isRepositoryUser

protected boolean isRepositoryUser()

checkValidUser

protected int checkValidUser()
                      throws ReposServiceException

checkCompatibleServer

protected void checkCompatibleServer()
                              throws ReposServiceException
Checks server compatiblility by comparing server version with the connection's compatible version numbers. Does nothing if no compatible version numbers have been specified for the connection.
Throws:
ReposServiceException - if versions are not fully compatible.
See Also:
RepositoryConnection.setCompatibleVersionNumbers()

cacheStatement

int cacheStatement(String strQuery,
                   PreparedStatement stmt)
             throws ReposServiceException
Change the prepared statement with the SQL statement as a key. Add a numeric key as well for ease of use or when the use dynamically built the SQL statement and no longer has it. Scope is package
Parameters:
strQuery - the SQL select statement
PreparedStatement - the prepared statement for the SQL
Throws:
ReposServiceException - on error Statement already cached. User should close statement and use returned cache statement id.

getCachedStatement

PreparedStatement getCachedStatement(String strQuery)
Get the cached statement by SQL statement (String)
Parameters:
strQuery - the SQL select statement
Throws:
none -  

getCachedStatement

PreparedStatement getCachedStatement(int nStatementId)
Get the cached statement by ID (int)
Parameters:
strQuery - the SQL select statement
Throws:
none -  

getNewIdValue

public oracle.repos.services.GID getNewIdValue()
                                        throws ReposServiceException

getNewRID

public RID getNewRID()
              throws ReposServiceException

setServerRmTrace

void setServerRmTrace(boolean bOn)
                throws ReposServiceException

readText

int readText(oracle.repos.services.GID eid,
             String txt_type,
             String buf,
             boolean trusted)

writeText

int writeText(oracle.repos.services.GID eid,
              String txt_type,
              String buf,
              boolean trusted)

openActivity

public int openActivity()
                 throws ReposServiceException

getNumberOfOpenActivities

public int getNumberOfOpenActivities()

getCurrentActivityId

public oracle.repos.services.GID getCurrentActivityId()
                                               throws ReposServiceException
Get ID of current activity.
Returns:
current activity's ID.

getCurrentActivityParentId

public oracle.repos.services.GID getCurrentActivityParentId()
                                                     throws ReposServiceException
Get ID of current activity's parent.
Returns:
current activity's parent ID.

closeActivity

public int closeActivity()
                  throws ReposServiceException

abortActivity

public int abortActivity()
                  throws ReposServiceException

loadServerDeliverableVersions

public Vector loadServerDeliverableVersions()
                                     throws ReposServiceException

getRepositoryVersion

public DeliverableVersion getRepositoryVersion()
                                        throws ReposServiceException
getRepositoryVersion returns a DeliverableVersion of the Repository
Throws:
ReposServiceException -  

isDesignerRepository

public boolean isDesignerRepository()
                             throws ReposServiceException
isDesignerRepository returns a true or false Is Legacy Repository
Throws:
ReposServiceException -  

isOracleRepository

public boolean isOracleRepository()
                           throws ReposServiceException
isOracleRepository returns a true or false Is new Oracle Repository
Throws:
ReposServiceException -  

loadPatches

public Vector loadPatches()
                   throws ReposServiceException
loadPatches return a Vector of Strings of installed patches on the Repository
Throws:
ReposServiceException -  

getMaximumPatchNumber

public int getMaximumPatchNumber()
                          throws ReposServiceException
Gets the highest patch number installed on server.
Returns:
highest patch niumber, e.g. for ci04012.M23.102 answers 102. 0 if no patches loaded.
Throws:
ReposServiceException -  

getMaximumPatchMilestoneNumber

public int getMaximumPatchMilestoneNumber()
                                   throws ReposServiceException
Gets the highest patch milestone number installed on server.
Returns:
highest patch milestone number, e.g. for ci04012.M23.102 answers 23. 0 if no patches loaded or patch number doesn't contain a milestone number.
Throws:
ReposServiceException -  

setValidationPolicy

public void setValidationPolicy(int nValidationPolicy)
Sets validation policy mask for this DataSet.
Parameters:
nValidationPolicy - the new validation policy.

getValidationPolicy

public int getValidationPolicy()
Returns the validation policy mask for this DataSet.
Returns:
the DataSet validation policy.

setActiveAppSys

public void setActiveAppSys(oracle.repos.services.GID gidIRID)
                     throws ReposServiceException

getMetaDataElement

public MetaDataElement getMetaDataElement(MetaDataElementDescriptor descMDE)
                                   throws ReposServiceException
Get meta data element from cache or load from database if not in cache
Parameters:
- - description of meta data element to load
Returns:
the MetaDataElement
See Also:
MetaDataElement, MetaDataElementDescriptor

getMetaDataElements

public MetaDataElementList getMetaDataElements(MetaDataElementDescriptorList lisMdeDesc,
                                               boolean bDefer,
                                               boolean bAddToSession)
                                        throws ReposServiceException

getMetaDataElement

public MetaDataElement getMetaDataElement(String strTypeName)
                                   throws ReposServiceException
Get meta data element from cache or load from database if not in cache
Parameters:
- - description of meta data element to load
Returns:
the MetaDataElement
See Also:
MetaDataElement, MetaDataElementDescriptor

getMetaDataElement

public MetaDataElement getMetaDataElement(String strProductName,
                                          String strTypeName)
                                   throws ReposServiceException

getMetaDataElement

public MetaDataElement getMetaDataElement(oracle.repos.services.GID gidTypeId)
                                   throws ReposServiceException

loadMetaDataElements

public MetaDataElementList loadMetaDataElements(String strProductName,
                                                MetaDataElementDescriptorList lisMdeDesc,
                                                boolean bDefer,
                                                boolean bAddToSession)
                                         throws ReposServiceException

loadMetaDataElements

public MetaDataElementList loadMetaDataElements(MetaDataElementDescriptorList lisMdeDesc,
                                                boolean bDefer,
                                                boolean bAddToSession)
                                         throws ReposServiceException

getMetaDataElement

public MetaDataElement getMetaDataElement(String strProduct,
                                          String strType,
                                          int nPrimaryProperty)
                                   throws ReposServiceException

loadAllMetaDataElements

public MetaDataElementList loadAllMetaDataElements(boolean bDefer,
                                                   boolean bAddToSession)
                                            throws ReposServiceException

enumerateMetaDataElements

public Enumeration enumerateMetaDataElements()
Returns an enumeration of the MetaDataElements cached in this Connection.
Returns:
Enumeration of MetaDataElements

getElement

public DataElement getElement(RID ridId)
                       throws ReposServiceException,
                              DanglingReferenceException,
                              DataElementConsolidateException,
                              DataElementDeletedException

getFullPath

public String getFullPath(oracle.repos.services.GID id,
                          String formatType,
                          char fileSep,
                          String containerSep)
                   throws ReposServiceException
getFullPath
Parameters:
id - is the irid of ivid of the object
formatType - is one of "NAME", "BRANCH", "VLABEL"
fileSep - is the desired separator between components. '\0' for default.
containerSep - is the desired separator after the container name.
Returns:
the full path of an object
Throws:
ReposServiceException -  

getFullPath

public String getFullPath(oracle.repos.services.GID id,
                          String formatType,
                          char fileSep)
                   throws ReposServiceException

getFullPathByIVID

public String getFullPathByIVID(oracle.repos.services.GID ivid,
                                String formatType,
                                char fileSep)
                         throws ReposServiceException

createDiagram

public RepositoryDiagram createDiagram(String name,
                                       String diagramType,
                                       boolean bWriteThrough)
                                throws ReposServiceException

createDiagram

public RepositoryDiagram createDiagram(DataElement deDiagram)
                                throws ReposServiceException
creates a diagram
Parameters:
deDiagram - - the DataElement for the diagram

addDiagramToSession

void addDiagramToSession(RepositoryDiagram deDiag)
remember the diagram used during this connection

isDiagramInSession

boolean isDiagramInSession(RID ridDiag)
is diagram used during this connection

findDiagramInSession

RepositoryDiagram findDiagramInSession(RID ridDiag)
find the diagram used during this connection

findDiagramInSession

RepositoryDiagram findDiagramInSession(String strDiagramName)

removeDiagramFromSession

public void removeDiagramFromSession(RepositoryDiagram repDiag)
remove the diagram from this session

getLoadedDiagrams

public Vector getLoadedDiagrams()
return the diagram used during this connection

getDiagram

public RepositoryDiagram getDiagram(RID id)
                             throws ReposServiceException
retrieve a diagram from the repository by its id

getDiagram

public RepositoryDiagram getDiagram(String strName)
                             throws ReposServiceException
retrieve a diagram from the repository by its name

getDiagrams

public Vector getDiagrams(String strDiagType)
                   throws ReposServiceException
returns diagrams of strDiagType. if strDiagType is null then diagrams of all types are returned

getDiagrams

public Vector getDiagrams(String[] arrstrDiagType)
                   throws ReposServiceException
returns diagrams of types defined by arrstrDiagType. if strDiagType is null then diagrams of all types are returned

saveDiagram

public void saveDiagram(RepositoryDiagram repDiag,
                        DataElementDescriptorList lisElements)
                 throws ReposServiceException

getUID

public String getUID()
              throws ReposServiceException
Get Repository Unique ID.

getState

public int getState()

usingOracleExtensions

public boolean usingOracleExtensions()

setDefaultRowPrefetch

public void setDefaultRowPrefetch(int nMaxSize)
                           throws ReposServiceException

getDefaultRowPrefetch

public int getDefaultRowPrefetch()

setMode

public void setMode(int nMode)

getMode

public int getMode()

clearMode

public void clearMode(int nMode)

isInMode

public boolean isInMode(int nMode)

queryAccessRights

public AccessRights queryAccessRights(DataElement de)
                               throws ReposServiceException

queryAccessRights

public AccessRights queryAccessRights(DataElement de,
                                      String strGrantee)
                               throws ReposServiceException

queryAccessRights

public AccessRights queryAccessRights(oracle.repos.services.GID containerIRID)
                               throws ReposServiceException

queryAccessRights

public AccessRights queryAccessRights(oracle.repos.services.GID containerIRID,
                                      String strGrantee)
                               throws ReposServiceException

getOwningUserName

public String getOwningUserName()
                         throws ReposServiceException

getRIDFromFullPath

public RID getRIDFromFullPath(String strFullPath,
                              char chSeparator)
                       throws ReposServiceException
Returns the RID of an element from its full path
Parameters:
strFullPath - the full path of the element
chSeparator - the separator used in the full path if chSeparator is '\0' then the default is used from the naming service.

onCWLogSettingsChange

public void onCWLogSettingsChange()
Description copied from interface: CWLogSettingsListener
Called by CWLog just after it has changed any aspect of its configuration.

The implementation should call methods on CWLog to figure out what has changed.

Specified by:
onCWLogSettingsChange in interface CWLogSettingsListener

setDefaultDiagnosticsOn

public static final void setDefaultDiagnosticsOn()
Deprecated. 24-Feb-00 DON'T DO THIS.
Lazy way of intializing diagnostics.
Parameters:
-  
Returns:
 
Throws:
RepositoryConnection.ConnectionState -  

addElementToWorkareasPrivateConfiguration

public void addElementToWorkareasPrivateConfiguration(DataElement de)
                                               throws ReposServiceException
addElementToWorkareasPrivateConfiguration
Parameters:
de - - Data Element to add to private configurations
Throws:
ReposServiceException - - means database error or no active work area.

queryPACTypeId

public oracle.repos.services.GID queryPACTypeId(RID ridId)
                                         throws ReposServiceException

queryPACType

public MetaDataElement queryPACType(RID ridId)
                             throws ReposServiceException

isVersioningSupported

public boolean isVersioningSupported()
return true is repoistory supports versioning.

getValueFromRMInfo

public String getValueFromRMInfo(String strName)
                          throws ReposServiceException
RM$INFO holds named value pairs for details of current repository. return the value that matches the name specified by user.
Returns:
value of entry in rm$info with name specified

getRepositoryUUID

public String getRepositoryUUID()
                         throws ReposServiceException
Get UUID of repository
Returns:
UUID

getRepositoryBroadcastNotifier

public String getRepositoryBroadcastNotifier()
                                      throws ReposServiceException
Get Broadcast notifier of repository

setDefaultProductforLoadingMetaData

public void setDefaultProductforLoadingMetaData(String strProduct)

setCompatibleVersionNumbers

public void setCompatibleVersionNumbers(String[] strCompatibleVersionNumber)
Sets the array of repository version numbers, of form n.n.n.n.n, that it is compatible to connect to.
Parameters:
strCompatibleVersionNumber - where each element is of form n.n.n.n.n

setCompatibleVersionNumbers

public void setCompatibleVersionNumbers(String strCompatibleVersionNumbers)
Sets the array of repository version numbers, of form n.n.n.n.n, that it is compatible to connect to.
Parameters:
strCompatibleVersionNumber - a " " or "," separated string of compatible version numbers. Each version number has form n.n.n.n.n.

getCompatibleVersionNumbers

public String[] getCompatibleVersionNumbers()
BM0463 - JR0670 - JDev446
SUMMARY:  INNER | FIELD | CONSTR | METHOD DETAIL:  FIELD | CONSTR | METHOD