|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.ibm.j2ca.base.WBIManagedConnectionFactory
A managed connection factory for the container-managed configuration and creation of physical connections to the underlying EIS. A subclass of WBIManagedConnectionFactory should:
createConnectionFactory
createManagedConnection
Constructor Summary | |
---|---|
WBIManagedConnectionFactory()
|
Method Summary | |
---|---|
void |
addPropertyChangeListener(java.beans.PropertyChangeListener listener)
|
void |
addPropertyChangeListener(java.lang.String propertyName,
java.beans.PropertyChangeListener listener)
|
java.lang.Object |
createConnectionFactory()
Returns a connection factory instance. |
abstract java.lang.Object |
createConnectionFactory(javax.resource.spi.ConnectionManager connMgr)
Returns a connection factory instance. |
abstract javax.resource.spi.ManagedConnection |
createManagedConnection(javax.security.auth.Subject subject,
javax.resource.spi.ConnectionRequestInfo connectionRequestInfo)
Returns a new managed connection instance. |
boolean |
equals(java.lang.Object o)
|
java.lang.String |
getBiDiContext_PasswordEIS()
|
java.lang.String |
getBiDiContext_PasswordSkip()
|
java.lang.String |
getBiDiContext_UserNameEIS()
|
java.lang.String |
getBiDiContext_UserNameSkip()
|
com.ibm.j2ca.base.bidi.WBIBiDiContext |
getBiDiContext()
|
java.lang.String |
getBiDiContextEIS()
|
java.lang.String |
getBiDiContextMetadata()
|
java.lang.String |
getBiDiContextSkip()
|
java.lang.String |
getBiDiContextSpecialFormat()
|
java.lang.String |
getBiDiTranslatedPassword(java.lang.String password)
|
java.lang.String |
getBiDiTranslatedUserName(java.lang.String user)
|
LogUtils |
getLogUtils()
|
java.io.PrintWriter |
getLogWriter()
|
java.lang.String |
getPassword()
|
javax.resource.spi.security.PasswordCredential |
getPasswordCredential(javax.security.auth.Subject subject,
WBIConnectionRequestInfo info)
Returns an instance of the matching PasswordCredential from the subject. |
protected java.beans.PropertyChangeSupport |
getPropertyChangeSupport()
Provides a PropertyChangeSupport instance that can be used to notify any listeners of property changes on the factory. |
java.lang.Boolean |
getReauthSupported()
|
javax.resource.spi.ResourceAdapter |
getResourceAdapter()
Returns the resource adapter instance associated with this factory. |
java.lang.String |
getUserName()
|
int |
hashCode()
|
javax.resource.spi.ManagedConnection |
matchManagedConnections(java.util.Set connectionSet,
javax.security.auth.Subject subject,
javax.resource.spi.ConnectionRequestInfo requestInfo)
Selects the matching ManagedConnection from the candidate set provided by the caller. |
void |
removePropertyChangeListener(java.beans.PropertyChangeListener listener)
|
void |
removePropertyChangeListener(java.lang.String propertyName,
java.beans.PropertyChangeListener listener)
|
void |
setBiDiContext_PasswordEIS(java.lang.String biDiContext_PasswordEIS)
|
void |
setBiDiContext_PasswordSkip(java.lang.String biDiContext_PasswordSkip)
|
void |
setBiDiContext_UserNameEIS(java.lang.String biDiContext_UserNameEIS)
|
void |
setBiDiContext_UserNameSkip(java.lang.String biDiContext_UserNameSkip)
|
void |
setBiDiContextEIS(java.lang.String biDiContextEIS)
|
void |
setBiDiContextMetadata(java.lang.String biDiContextMetadata)
|
void |
setBiDiContextSkip(java.lang.String biDiContextSkip)
|
void |
setBiDiContextSpecialFormat(java.lang.String biDiContextSpecialFormat)
|
void |
setLogUtils(LogUtils utils)
|
void |
setLogWriter(java.io.PrintWriter out)
|
void |
setPassword(java.lang.String newValue)
|
void |
setReauthSupported(java.lang.Boolean newValue)
|
void |
setResourceAdapter(javax.resource.spi.ResourceAdapter resourceAdapter)
Sets the resource adapter instance associated with this factory. |
void |
setUserName(java.lang.String newValue)
|
protected void |
validate()
Validates the configuration properties defined for this managed connection factory instance. |
protected void |
verifyBiDiFormatValues()
|
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public WBIManagedConnectionFactory()
Method Detail |
public abstract javax.resource.spi.ManagedConnection createManagedConnection(javax.security.auth.Subject subject, javax.resource.spi.ConnectionRequestInfo connectionRequestInfo) throws javax.resource.ResourceException
A subclass should evaluate the connection details and the security credentials and return a new WBIManagedConnection instance configured appropriately.
Subject
instance passed provides security credentials and the
ConnectionRequestInfo
parameter is simply a null pointer.
The ManagedConnection
instance returned from this
invocation need not represent a valid physical connection, but it must be
able to provide an XAResource instance for the underlying EIS via method
ManagedConnection.getXAResource().
This requirement relates to transaction recovery and enables the resource
adapter container to get an XAResource
instance for the
EIS to begin recovery even when the container lacks appropriate
connection parameters from a client. For more information, see the Java
Connector Architecture 1.5 specification.
createManagedConnection
in interface javax.resource.spi.ManagedConnectionFactory
javax.resource.ResourceException
public abstract java.lang.Object createConnectionFactory(javax.resource.spi.ConnectionManager connMgr) throws javax.resource.ResourceException
A subclass should return its own EIS-specific WBIConnectionFactory instance.
createConnectionFactory
in interface javax.resource.spi.ManagedConnectionFactory
javax.resource.ResourceException
public java.lang.Object createConnectionFactory() throws javax.resource.ResourceException
A subclass can choose to override this method if it wishes to provide its own ConnectionManager instance for use in non-managed environments.
createConnectionFactory
in interface javax.resource.spi.ManagedConnectionFactory
javax.resource.ResourceException
public int hashCode()
hashCode
in interface javax.resource.spi.ManagedConnectionFactory
public boolean equals(java.lang.Object o)
equals
in interface javax.resource.spi.ManagedConnectionFactory
public javax.resource.spi.ManagedConnection matchManagedConnections(java.util.Set connectionSet, javax.security.auth.Subject subject, javax.resource.spi.ConnectionRequestInfo requestInfo) throws javax.resource.ResourceException
Subject
or the ConnectionRequestInfo
. This value is compared with the security info of the ManagedConnection from the candidate set. If there is no match, method returns
null to the caller. If the match is found, the next step is to match remining properties of the ConnectionRequestInfo. The Connector has the knowledge to verify that particluar value of the
property can be overwritten, so after finding compatible properties the ManagedConnection is returned to the caller. If there is no match or properties are not 'compatible', the method returns
null. When ConnectionRequestInfo
and Subject
are null, the security info and properties of the ManagedConnections from the candidate set are compared with the default values of the
ManagedConnectionFactory. If there is a match, the ManagedConnection is returned to the caller, otherwise null is returned.
b) Connector supports reauthentication - Only properties from the ConnectionRequestInfo have to match. The Connector has the knowledge to verify that particluar value of the property can be
overwritten, so if it finds compatible properties, it overwrites them and then returns ManagedConnection to the caller. If there is no match or properties are not 'compatible', the method
returns null. When ConnectionRequestInfo is null, the security info and properties of the ManagedConnections from the candidate set are compared with the default values of the
ManagedConnectionFactory. If there is a match, the ManagedConnection is returned to the caller, otherwise null is returned.
matchManagedConnections
in interface javax.resource.spi.ManagedConnectionFactory
javax.resource.ResourceException
public java.lang.String getBiDiContextEIS()
public void setBiDiContextEIS(java.lang.String biDiContextEIS)
public java.lang.String getBiDiContextMetadata()
public void setBiDiContextMetadata(java.lang.String biDiContextMetadata)
public java.lang.String getBiDiContextSpecialFormat()
public void setBiDiContextSpecialFormat(java.lang.String biDiContextSpecialFormat)
public java.lang.String getBiDiContextSkip()
public void setBiDiContextSkip(java.lang.String biDiContextSkip)
public com.ibm.j2ca.base.bidi.WBIBiDiContext getBiDiContext()
public void setReauthSupported(java.lang.Boolean newValue)
public java.lang.Boolean getReauthSupported()
public java.lang.String getUserName()
public void setUserName(java.lang.String newValue) throws java.beans.PropertyVetoException
java.beans.PropertyVetoException
public java.lang.String getPassword()
public void setPassword(java.lang.String newValue) throws java.beans.PropertyVetoException
java.beans.PropertyVetoException
public javax.resource.spi.security.PasswordCredential getPasswordCredential(javax.security.auth.Subject subject, WBIConnectionRequestInfo info) throws javax.resource.spi.SecurityException
javax.resource.spi.SecurityException
public void addPropertyChangeListener(java.beans.PropertyChangeListener listener)
public void addPropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener)
public void removePropertyChangeListener(java.beans.PropertyChangeListener listener)
public void removePropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener)
protected java.beans.PropertyChangeSupport getPropertyChangeSupport()
protected void validate() throws javax.resource.spi.InvalidPropertyException
A subclass should override this method and add checks for its custom configuration properties (as well as call super.validate)
javax.resource.spi.InvalidPropertyException
public void setResourceAdapter(javax.resource.spi.ResourceAdapter resourceAdapter) throws javax.resource.ResourceException
getResourceAdapter()
enable a resource adapter container to
associate a ResourceAdapter instance with this ManagedConnectionFactory.
The primary value is that the factory can access any configuration
properties globally defined on the ResourceAdapter.
setResourceAdapter
in interface javax.resource.spi.ResourceAdapterAssociation
javax.resource.ResourceException
getResourceAdapter()
public javax.resource.spi.ResourceAdapter getResourceAdapter()
getResourceAdapter
in interface javax.resource.spi.ResourceAdapterAssociation
setResourceAdapter(javax.resource.spi.ResourceAdapter)
public java.io.PrintWriter getLogWriter() throws javax.resource.ResourceException
getLogWriter
in interface javax.resource.spi.ManagedConnectionFactory
javax.resource.ResourceException
public void setLogWriter(java.io.PrintWriter out) throws javax.resource.ResourceException
setLogWriter
in interface javax.resource.spi.ManagedConnectionFactory
javax.resource.ResourceException
public void setLogUtils(LogUtils utils)
public LogUtils getLogUtils()
public void setBiDiContext_UserNameEIS(java.lang.String biDiContext_UserNameEIS)
public java.lang.String getBiDiContext_UserNameEIS()
public void setBiDiContext_UserNameSkip(java.lang.String biDiContext_UserNameSkip)
public java.lang.String getBiDiContext_UserNameSkip()
public void setBiDiContext_PasswordEIS(java.lang.String biDiContext_PasswordEIS)
public java.lang.String getBiDiContext_PasswordEIS()
public void setBiDiContext_PasswordSkip(java.lang.String biDiContext_PasswordSkip)
public java.lang.String getBiDiContext_PasswordSkip()
public java.lang.String getBiDiTranslatedUserName(java.lang.String user)
public java.lang.String getBiDiTranslatedPassword(java.lang.String password)
protected void verifyBiDiFormatValues() throws javax.resource.ResourceException
javax.resource.ResourceException
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |