oracle.cle.persistence
Class DeploymentConnector

java.lang.Object
  |
  +--oracle.cle.persistence.DeploymentConnector

Direct Known Subclasses:

DeploymentAutoConnector

public class DeploymentConnector

extends java.lang.Object

Classes of this type can automatically get a connection via the DeploymentManager and ConnectionManager by specifying reference class and the appropriate property files.

See Also:

ConnectionManager, DeploymentManager

Constructor Summary

DeploymentConnector()

Method Summary

protected void	deploymentKeyNotFound(java.lang.String aString) Run internally by getDeploymentKey() method when a deploymentKey is not found in the DeploymentManager
java.lang.Object	getConnection(java.lang.Class aClass) Call this method to get the Connection specific to the specified class.
java.lang.Object	getConnection(java.lang.Class aClass, java.lang.Object sessionId) Call this method to get the Connection specific to the specified class.
java.lang.Object	getConnection(java.lang.Class aClass, java.lang.Object sessionId, java.lang.String connectionId) Call this method to get the Connection specific to the specified class.
java.lang.Object	getConnection(java.lang.Class aClass, java.util.Properties dynamicConnectionProperties) Call this method to get the Connection specific to the specified class.
java.lang.Object	getConnection(java.lang.Class aClass, java.util.Properties dynamicConnectionProperties, java.lang.Object sessionId) Call this method to get the Connection specific to the specified class.
java.lang.Object	getConnection(java.lang.Class aClass, java.lang.String connectionId) Call this method to get the Connection specific to the specified class.
java.lang.Object	getConnection(java.lang.String aClassString) Call this method to get the Connection specific to the specified class string.
java.lang.Object	getConnection(java.lang.String aClassString, java.lang.Object sessionId) Call this method to get the Connection specific to the specified class string.
java.lang.Object	getConnection(java.lang.String aClassString, java.lang.Object sessionId, java.lang.String connectionId) Call this method to get the Connection specific to the specified class string.
java.lang.Object	getConnection(java.lang.String aClassString, java.util.Properties dynamicConnectionProperties) Call this method to get the Connection specific to the specified class string.
java.lang.Object	getConnection(java.lang.String aClassString, java.util.Properties dynamicConnectionProperties, java.lang.Object sessionId) Call this method to get the Connection specific to the specified class string.
java.lang.Object	getConnection(java.lang.String aClassString, java.util.Properties dynamicConnectionProperties, java.lang.Object sessionId, java.lang.String connectionId) Call this method to get the Connection specific to the specified class string.
java.lang.Object	getConnection(java.lang.String aClassString, java.util.Properties dynamicConnectionProperties, java.lang.String connectionId) Call this method to get the Connection specific to the specified class string.
java.lang.Object	getConnection(java.lang.String aClassString, java.lang.String connectionId) Call this method to get the Connection specific to the specified class string.
protected java.lang.String	getDeploymentKey(java.lang.Class aClass) Determines which persistence environment to use for the given identifier
protected java.lang.String	getDeploymentKey(java.lang.Object anObject) Determines which persistence environment to use for the given identifier
protected java.lang.String	getDeploymentKey(java.lang.String aString) Determines which persistence environment to use for the given identifier
java.lang.Object	getProvider(java.lang.Class aClass) Call this method to get the Persistence Provider specific to the specified class.
java.lang.Object	getProvider(java.lang.String aClassString) Call this method to get the Persistence Provider specific to the specified class string.
protected void	providerNotSupported(java.lang.String providerString) Run by query methods when a provider is not found in the Connection Manager
void	releaseConnection(java.lang.Class aClass)
void	releaseConnection(java.lang.Class aClass, java.lang.Object sessionId) Releases the connection associated to the sessionId passed in.
void	releaseConnection(java.lang.Class aClass, java.lang.Object sessionId, java.lang.String connectionId) Releases the connection associated to the sessionId passed in.
void	releaseConnection(java.lang.Class aClass, java.lang.String connectionId) Releases the connection associated to the sessionId passed in.
void	releaseConnection(java.lang.String aClassString) Releases the connection associated to the sessionId passed in.
void	releaseConnection(java.lang.String aClassString, java.lang.Object sessionId) Releases the connection associated to the sessionId passed in.
void	releaseConnection(java.lang.String aClassString, java.lang.Object sessionId, java.lang.String connectionId) Releases the connection associated to the sessionId passed in.
void	releaseConnection(java.lang.String aClassString, java.lang.String connectionId) Releases the connection associated to the sessionId passed in.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DeploymentConnector

public DeploymentConnector()

Method Detail

getConnection

public java.lang.Object getConnection(java.lang.Class aClass)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class.

getConnection

public java.lang.Object getConnection(java.lang.Class aClass,
                                      java.lang.Object sessionId)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class.

getConnection

public java.lang.Object getConnection(java.lang.Class aClass,
                                      java.lang.Object sessionId,
                                      java.lang.String connectionId)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class. Only specify a connectionId for the second, third, etc. connection of the same type, i.e. for the first connection it is recommended to use the equivalent method without the connectionId argument. This will give a better performance.

Parameters:

aClass - : Class the class for which the connection is obtained

sessionId - : Object the sessionId

connectionId - : an identifier to differentiate between multiple connections of the same type. E.g. "1".

getConnection

public java.lang.Object getConnection(java.lang.Class aClass,
                                      java.lang.String connectionId)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class. Only specify a connectionId for the second, third, etc. connection of the same type, i.e. for the first connection it is recommended to use the equivalent method without the connectionId argument. This will give a better performance.

Parameters:

aClass - : Class the class for which the connection is obtained

connectionId - : an identifier to differentiate between multiple connections of the same type. E.g. "1".

getConnection

public java.lang.Object getConnection(java.lang.Class aClass,
                                      java.util.Properties dynamicConnectionProperties,
                                      java.lang.Object sessionId)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class.

Parameters:

aClass - : Class the class for which the connection is obtained

dynamicConnectionProperties - ; Properties specialized properties for the connection

sessionId - : Object the sessionId

getConnection

public java.lang.Object getConnection(java.lang.Class aClass,
                                      java.util.Properties dynamicConnectionProperties)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class.

Parameters:

aClass - : Class the class for which the connection is obtained

dynamicConnectionProperties - ; Properties specialized properties for the connection

getConnection

public java.lang.Object getConnection(java.lang.String aClassString,
                                      java.lang.Object sessionId)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class string.

getConnection

public java.lang.Object getConnection(java.lang.String aClassString)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class string.

getConnection

public java.lang.Object getConnection(java.lang.String aClassString,
                                      java.lang.Object sessionId,
                                      java.lang.String connectionId)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class string. Only specify a connectionId for the second, third, etc. connection of the same type, i.e. for the first connection it is recommended to use the equivalent method without the connectionId argument. This will give a better performance.

Parameters:

aClassString - : String name of the class used as deploymentKey

sessionId - : Object the sessionId

connectionId - : an identifier to differentiate between multiple connections of the same type. E.g. "1".

getConnection

public java.lang.Object getConnection(java.lang.String aClassString,
                                      java.lang.String connectionId)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class string. Only specify a connectionId for the second, third, etc. connection of the same type, i.e. for the first connection it is recommended to use the equivalent method without the connectionId argument. This will give a better performance.

Parameters:

aClassString - : String name of the class used as deploymentKey

connectionId - : an identifier to differentiate between multiple connections of the same type. E.g. "1".

getConnection

public java.lang.Object getConnection(java.lang.String aClassString,
                                      java.util.Properties dynamicConnectionProperties,
                                      java.lang.Object sessionId)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class string.

Parameters:

aClassString - : String name of the class used as deploymentKey

dynamicConnectionProperties - : Properties the dynamic properties

sessionId - : Object the sessionId

getConnection

public java.lang.Object getConnection(java.lang.String aClassString,
                                      java.util.Properties dynamicConnectionProperties)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class string.

Parameters:

aClassString - : String name of the class used as deploymentKey

dynamicConnectionProperties - : Properties the dynamic properties

getConnection

public java.lang.Object getConnection(java.lang.String aClassString,
                                      java.util.Properties dynamicConnectionProperties,
                                      java.lang.String connectionId)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class string. Only specify a connectionId for the second, third, etc. connection of the same type, i.e. for the first connection it is recommended to use the equivalent method without the connectionId argument. This will give a better performance.

Parameters:

aClassString - : String name of the class used as deploymentKey

dynamicConnectionProperties - : Properties the dynamic properties

connectionId - : an identifier to differentiate between multiple connections of the same type. E.g. "1".

getConnection

public java.lang.Object getConnection(java.lang.String aClassString,
                                      java.util.Properties dynamicConnectionProperties,
                                      java.lang.Object sessionId,
                                      java.lang.String connectionId)
                               throws java.lang.Exception

Call this method to get the Connection specific to the specified class string. Only specify a connectionId for the second, third, etc. connection of the same type, i.e. for the first connection it is recommended to use the equivalent method without the connectionId argument. This will give a better performance.

Parameters:

aClassString - : String name of the class used as deploymentKey

dynamicConnectionProperties - : Properties the dynamic properties

sessionId - : Object the sessionId

connectionId - : an identifier to differentiate between multiple connections of the same type. E.g. "1".

releaseConnection

public void releaseConnection(java.lang.Class aClass,
                              java.lang.Object sessionId)
                       throws java.lang.Exception

Releases the connection associated to the sessionId passed in. This method will call the connection manager to release the connection.

releaseConnection

public void releaseConnection(java.lang.Class aClass)
                       throws java.lang.Exception

releaseConnection

public void releaseConnection(java.lang.String aClassString,
                              java.lang.Object sessionId)
                       throws java.lang.Exception

Releases the connection associated to the sessionId passed in. This method will call the connection manager to release the connection.

releaseConnection

public void releaseConnection(java.lang.String aClassString)
                       throws java.lang.Exception

Releases the connection associated to the sessionId passed in. This method will call the connection manager to release the connection.

releaseConnection

public void releaseConnection(java.lang.Class aClass,
                              java.lang.Object sessionId,
                              java.lang.String connectionId)
                       throws java.lang.Exception

Releases the connection associated to the sessionId passed in.

releaseConnection

public void releaseConnection(java.lang.Class aClass,
                              java.lang.String connectionId)
                       throws java.lang.Exception

Releases the connection associated to the sessionId passed in.

releaseConnection

public void releaseConnection(java.lang.String aClassString,
                              java.lang.String connectionId)
                       throws java.lang.Exception

Releases the connection associated to the sessionId passed in. This method will call the connection manager to release the connection. "null" value for sessionId is replaced with the value in the CLEUtil.sessionId

releaseConnection

public void releaseConnection(java.lang.String aClassString,
                              java.lang.Object sessionId,
                              java.lang.String connectionId)
                       throws java.lang.Exception

Releases the connection associated to the sessionId passed in. This method will call the connection manager to release the connection. "null" value for sessionId is replaced with the value in the CLEUtil.sessionId

getProvider

public java.lang.Object getProvider(java.lang.Class aClass)
                             throws java.lang.Exception

Call this method to get the Persistence Provider specific to the specified class.

getProvider

public java.lang.Object getProvider(java.lang.String aClassString)
                             throws java.lang.Exception

Call this method to get the Persistence Provider specific to the specified class string.

getDeploymentKey

protected java.lang.String getDeploymentKey(java.lang.String aString)

Determines which persistence environment to use for the given identifier

getDeploymentKey

protected java.lang.String getDeploymentKey(java.lang.Object anObject)

Determines which persistence environment to use for the given identifier

getDeploymentKey

protected java.lang.String getDeploymentKey(java.lang.Class aClass)

Determines which persistence environment to use for the given identifier

providerNotSupported

protected void providerNotSupported(java.lang.String providerString)

Run by query methods when a provider is not found in the Connection Manager

See Also:

ConnectionManager

deploymentKeyNotFound

protected void deploymentKeyNotFound(java.lang.String aString)

Run internally by getDeploymentKey() method when a deploymentKey is not found in the DeploymentManager

See Also:

DeploymentManager