public class FBManagedConnectionFactory extends java.lang.Object implements javax.resource.spi.ManagedConnectionFactory, FirebirdConnectionProperties, java.io.Serializable
| Constructor and Description |
|---|
FBManagedConnectionFactory()
Create a new pure-Java FBManagedConnectionFactory.
|
FBManagedConnectionFactory(GDSType gdsType)
Create a new FBManagedConnectionFactory based around the given GDSType.
|
FBManagedConnectionFactory(GDSType gdsType,
FBConnectionProperties connectionProperties) |
| Modifier and Type | Method and Description |
|---|---|
FBManagedConnectionFactory |
canonicalize()
The
canonicalize method is used in FBDriver to reuse
previous fbmcf instances if they have been create. |
java.lang.Object |
createConnectionFactory()
The
createConnectionFactory method creates a DataSource
with a default stand alone ConnectionManager. |
java.lang.Object |
createConnectionFactory(javax.resource.spi.ConnectionManager cxManager)
The
createConnectionFactory method creates a DataSource
using the supplied ConnectionManager. |
javax.resource.spi.ManagedConnection |
createManagedConnection(javax.security.auth.Subject subject,
javax.resource.spi.ConnectionRequestInfo cri)
Creates a new physical connection to the underlying EIS resource manager,
ManagedConnectionFactory uses the security information (passed as
Subject) and additional ConnectionRequestInfo (which is specific to
ResourceAdapter and opaque to application server) to create this new
connection.
|
boolean |
equals(java.lang.Object other) |
void |
forget(FBManagedConnection mc,
javax.transaction.xa.Xid xid) |
java.lang.String |
getAuthPlugins()
Get the list of authentication plugins to try.
|
int |
getBlobBufferLength()
Deprecated.
|
int |
getBlobBufferSize() |
int |
getBuffersNumber() |
FBConnectionProperties |
getCacheKey() |
java.lang.String |
getCharSet() |
int |
getConnectTimeout()
Get the current connect timeout.
|
java.lang.String |
getDatabase() |
FbDatabaseFactory |
getDatabaseFactory() |
DatabaseParameterBuffer |
getDatabaseParameterBuffer()
Get the database parameter buffer corresponding to the current connection
request information.
|
java.lang.String |
getDataTypeBind()
Get the
dataTypeBind configuration. |
java.lang.String |
getDbCryptConfig()
Get the database encryption plugin configuration.
|
FBConnectionRequestInfo |
getDefaultConnectionRequestInfo() |
java.lang.String |
getDefaultIsolation()
Get the default transaction isolation level as string.
|
FBTpb |
getDefaultTpb() |
int |
getDefaultTransactionIsolation()
Get the default transaction isolation level.
|
java.lang.String |
getEncoding() |
GDSType |
getGDSType()
Get the GDS implementation type around which this factory is based.
|
java.lang.String |
getGeneratedKeysEnabled()
Get the
generatedKeysEnabled configuration. |
java.lang.String |
getLocalEncoding()
Deprecated.
use
getCharSet() instead. |
java.io.PrintWriter |
getLogWriter()
Get the log writer for this
ManagedConnectionFactory
instance. |
java.lang.String |
getNonStandardProperty(java.lang.String key)
Get the property that does not have corresponding getter method by its
name.
|
java.lang.String |
getPassword() |
java.lang.String |
getRoleName() |
java.lang.String |
getSessionTimeZone()
Get the
sessionTimeZone. |
int |
getSocketBufferSize() |
int |
getSoTimeout()
Get the current Socket blocking timeout (SoTimeout).
|
java.lang.String |
getSqlDialect() |
FBTpb |
getTpb(int defaultTransactionIsolation) |
java.lang.String |
getTpbMapping()
Get the used TPB mapping.
|
java.lang.Integer |
getTransactionIsolation()
Deprecated.
|
java.lang.String |
getTransactionIsolationName()
Deprecated.
|
TransactionParameterBuffer |
getTransactionParameters(int isolation)
Get the transaction parameter buffer corresponding to the current
connection request information.
|
java.lang.String |
getType() |
java.lang.String |
getUserName() |
java.lang.String |
getWireCrypt()
Get the wire encryption level value.
|
int |
hashCode() |
boolean |
isDefaultResultSetHoldable()
Get the default ResultSet holdability.
|
boolean |
isIgnoreProcedureType()
Get the value for
ignoreProcedureType. |
boolean |
isTimestampUsesLocalTimezone() |
boolean |
isUseFirebirdAutocommit()
Get whether to use Firebird autocommit (experimental).
|
boolean |
isUseStandardUdf() |
boolean |
isUseStreamBlobs() |
boolean |
isWireCompression()
Get if wire compression should be enabled.
|
javax.resource.spi.ManagedConnection |
matchManagedConnections(java.util.Set connectionSet,
javax.security.auth.Subject subject,
javax.resource.spi.ConnectionRequestInfo cxRequestInfo)
Returns a matched connection from the candidate set of connections.
|
void |
recover(FBManagedConnection mc,
javax.transaction.xa.Xid xid) |
void |
setAuthPlugins(java.lang.String authPlugins)
Sets the authentication plugins to try.
|
void |
setBlobBufferLength(int value)
Deprecated.
|
void |
setBlobBufferSize(int bufferSize) |
void |
setBuffersNumber(int buffersNumber) |
void |
setCharSet(java.lang.String charSet) |
void |
setConnectTimeout(int connectTimeout)
Set the connect timeout.
|
void |
setDatabase(java.lang.String database) |
void |
setDataTypeBind(java.lang.String dataTypeBind)
Sets the
dataTypeBind configuration. |
void |
setDbCryptConfig(java.lang.String dbCryptConfig)
Sets the database encryption plugin configuration.
|
void |
setDefaultConnectionManager(javax.resource.spi.ConnectionManager defaultCm) |
void |
setDefaultIsolation(java.lang.String isolation)
Set the default transaction isolation level as string.
|
void |
setDefaultResultSetHoldable(boolean isHoldable)
Sets the default ResultSet holdability.
|
void |
setDefaultTransactionIsolation(int defaultIsolationLevel)
Set the default transaction isolation level.
|
void |
setEncoding(java.lang.String encoding) |
void |
setGeneratedKeysEnabled(java.lang.String generatedKeysEnabled)
Sets the
generatedKeysEnabled configuration. |
void |
setIgnoreProcedureType(boolean ignoreProcedureType)
Sets the value
ignoreProcedureType. |
void |
setLocalEncoding(java.lang.String localEncoding)
Deprecated.
use
setCharSet(String) instead. |
void |
setLogWriter(java.io.PrintWriter out)
Set the log writer for this
ManagedConnectionFactory
instance. |
void |
setNonStandardProperty(java.lang.String propertyMapping)
Set the property that does not have corresponding setter method.
|
void |
setNonStandardProperty(java.lang.String key,
java.lang.String value)
Set the property that does not have corresponding setter method.
|
void |
setPassword(java.lang.String password) |
void |
setRoleName(java.lang.String roleName) |
void |
setSessionTimeZone(java.lang.String sessionTimeZone)
Sets the
sessionTimeZone. |
void |
setSocketBufferSize(int socketBufferSize) |
void |
setSoTimeout(int soTimeout)
Set the Socket blocking timeout (SoTimeout).
|
void |
setSqlDialect(java.lang.String sqlDialect) |
void |
setTimestampUsesLocalTimezone(boolean timestampUsesLocalTimezone) |
void |
setTpbMapping(java.lang.String tpbMapping)
Set path to the properties file with the TPB mapping.
|
void |
setTransactionIsolation(java.lang.Integer value)
Deprecated.
|
void |
setTransactionIsolationName(java.lang.String name)
Deprecated.
|
void |
setTransactionParameters(int isolation,
TransactionParameterBuffer tpb)
Set transaction parameters for the specified transaction isolation level.
|
void |
setType(java.lang.String type) |
void |
setUseFirebirdAutocommit(boolean useFirebirdAutocommit)
Set whether to use Firebird autocommit (experimental).
|
void |
setUserName(java.lang.String userName) |
void |
setUseStandardUdf(boolean useStandardUdf) |
void |
setUseStreamBlobs(boolean useStreamBlobs) |
void |
setWireCompression(boolean wireCompression)
Sets if the connection should try to enable wire compression.
|
void |
setWireCrypt(java.lang.String wireCrypt)
Sets the wire encryption level.
|
public FBManagedConnectionFactory()
public FBManagedConnectionFactory(GDSType gdsType)
gdsType - The GDS implementation to usepublic FBManagedConnectionFactory(GDSType gdsType, FBConnectionProperties connectionProperties)
public FbDatabaseFactory getDatabaseFactory()
public GDSType getGDSType()
@Deprecated public int getBlobBufferLength()
getBlobBufferSize()@Deprecated public void setBlobBufferLength(int value)
setBlobBufferSize(int)@Deprecated public java.lang.Integer getTransactionIsolation()
getDefaultTransactionIsolation()@Deprecated public void setTransactionIsolation(java.lang.Integer value)
setDefaultTransactionIsolation(int)@Deprecated public java.lang.String getTransactionIsolationName()
getDefaultIsolation()@Deprecated public void setTransactionIsolationName(java.lang.String name)
setDefaultIsolation(String)@Deprecated public java.lang.String getLocalEncoding()
getCharSet() instead.@Deprecated public void setLocalEncoding(java.lang.String localEncoding)
setCharSet(String) instead.public int getBlobBufferSize()
getBlobBufferSize in interface FirebirdConnectionPropertiespublic int getBuffersNumber()
getBuffersNumber in interface FirebirdConnectionPropertiespublic java.lang.String getCharSet()
getCharSet in interface FirebirdConnectionPropertiesFirebirdConnectionProperties.setCharSet(String)public java.lang.String getDatabase()
getDatabase in interface FirebirdConnectionPropertiespublic DatabaseParameterBuffer getDatabaseParameterBuffer() throws java.sql.SQLException
FirebirdConnectionPropertiesgetDatabaseParameterBuffer in interface FirebirdConnectionPropertiesDatabaseParameterBuffer.java.sql.SQLException - if database parameter buffer cannot be created.public java.lang.String getDefaultIsolation()
FirebirdConnectionPropertiesFirebirdConnectionProperties.getDefaultTransactionIsolation(), however
it takes a string as parameter instead of a numeric constant.getDefaultIsolation in interface FirebirdConnectionPropertiesFirebirdConnectionProperties.setDefaultIsolation(String)public int getDefaultTransactionIsolation()
FirebirdConnectionPropertiesgetDefaultTransactionIsolation in interface FirebirdConnectionPropertiespublic java.lang.String getEncoding()
getEncoding in interface FirebirdConnectionPropertiesFirebirdConnectionProperties.setEncoding(String)public java.lang.String getNonStandardProperty(java.lang.String key)
FirebirdConnectionPropertiesgetNonStandardProperty in interface FirebirdConnectionPropertieskey - name of the property to get.public java.lang.String getPassword()
getPassword in interface FirebirdConnectionPropertiespublic java.lang.String getRoleName()
getRoleName in interface FirebirdConnectionPropertiespublic int getSocketBufferSize()
getSocketBufferSize in interface FirebirdConnectionPropertiespublic java.lang.String getSqlDialect()
getSqlDialect in interface FirebirdConnectionPropertiespublic java.lang.String getTpbMapping()
FirebirdConnectionPropertiesgetTpbMapping in interface FirebirdConnectionPropertiesFirebirdConnectionProperties.setTpbMapping(String)public TransactionParameterBuffer getTransactionParameters(int isolation)
FirebirdConnectionPropertiesgetTransactionParameters in interface FirebirdConnectionPropertiesisolation - transaction isolation level for which TPB should be returned.TransactionParameterBuffer.public java.lang.String getType()
getType in interface FirebirdConnectionPropertiespublic java.lang.String getUserName()
getUserName in interface FirebirdConnectionPropertiespublic boolean isTimestampUsesLocalTimezone()
isTimestampUsesLocalTimezone in interface FirebirdConnectionPropertiestrue if the Jaybird 1.0 handling of the calendar
in corresponding setters. This is also compatible with MySQL
calendar treatment.public boolean isUseStandardUdf()
isUseStandardUdf in interface FirebirdConnectionPropertiestrue if driver should assume that standard UDF are
installed.public boolean isUseStreamBlobs()
isUseStreamBlobs in interface FirebirdConnectionPropertiestrue if stream blobs should be created, otherwise
false.public void setBlobBufferSize(int bufferSize)
setBlobBufferSize in interface FirebirdConnectionPropertiesbufferSize - size of the BLOB buffer in bytes.public void setBuffersNumber(int buffersNumber)
setBuffersNumber in interface FirebirdConnectionPropertiesbuffersNumber - number of cache buffers that should be allocated for this
connection, should be specified for ClassicServer instances,
SuperServer has a server-wide configuration parameter.public void setCharSet(java.lang.String charSet)
setCharSet in interface FirebirdConnectionPropertiescharSet - Character set for the connection. Similar to
encoding property, but accepts Java names
instead of Firebird ones.public void setDatabase(java.lang.String database)
setDatabase in interface FirebirdConnectionPropertiesdatabase - path to the database including the server name and the
port, if needed.public void setDefaultIsolation(java.lang.String isolation)
FirebirdConnectionPropertiesFirebirdConnectionProperties.setDefaultTransactionIsolation(int),
however it takes a string as parameter instead of a numeric constant.
Following strings are allowed:
"TRANSACTION_READ_COMMITTED" for a READ COMMITTED
isolation level.
"TRANSACTION_REPEATABLE_READ" for a REPEATABLE READ
isolation level.
"TRANSACTION_SERIALIZABLE" for a SERIALIZABLE
isolation level.
setDefaultIsolation in interface FirebirdConnectionPropertiesisolation - string constant representing a default isolation level.public void setDefaultTransactionIsolation(int defaultIsolationLevel)
FirebirdConnectionPropertiessetDefaultTransactionIsolation in interface FirebirdConnectionPropertiesdefaultIsolationLevel - default transaction isolation level.public void setEncoding(java.lang.String encoding)
setEncoding in interface FirebirdConnectionPropertiesencoding - Character encoding for the connection. See Firebird
documentation for more information.public void setNonStandardProperty(java.lang.String key,
java.lang.String value)
FirebirdConnectionPropertiessetNonStandardProperty in interface FirebirdConnectionPropertieskey - name of the property to set.value - value of the property.public void setNonStandardProperty(java.lang.String propertyMapping)
FirebirdConnectionPropertiessetNonStandardProperty in interface FirebirdConnectionPropertiespropertyMapping - parameter value in the ?propertyName[=propertyValue]? form,
this allows setting non-standard parameters using
configuration files.public void setPassword(java.lang.String password)
setPassword in interface FirebirdConnectionPropertiespassword - password corresponding to the specified user name.public void setRoleName(java.lang.String roleName)
setRoleName in interface FirebirdConnectionPropertiesroleName - SQL role to use.public void setSocketBufferSize(int socketBufferSize)
setSocketBufferSize in interface FirebirdConnectionPropertiessocketBufferSize - socket buffer size in bytes.public void setSqlDialect(java.lang.String sqlDialect)
setSqlDialect in interface FirebirdConnectionPropertiessqlDialect - SQL dialect of the client.public void setTimestampUsesLocalTimezone(boolean timestampUsesLocalTimezone)
setTimestampUsesLocalTimezone in interface FirebirdConnectionPropertiestimestampUsesLocalTimezone - true if the Jaybird 1.0 handling of the
calendar in corresponding setters. This is also compatible
with MySQL calendar treatment.public void setTpbMapping(java.lang.String tpbMapping)
FirebirdConnectionProperties"res:" should be used to specify resource
in the classpath.
For the compatibility reasons, if no protocol is specified, classpath is
used by default.
Properties file contains a mapping between the transaction isolation
level (name of the constant in the Connection interface
and a comma-separated list of TPB parameters.setTpbMapping in interface FirebirdConnectionPropertiestpbMapping - path to the properties file.public void setTransactionParameters(int isolation,
TransactionParameterBuffer tpb)
FirebirdConnectionPropertiessetTransactionParameters in interface FirebirdConnectionPropertiesisolation - transaction isolation level.tpb - instance of TransactionParameterBuffer containing
transaction parameters.public void setType(java.lang.String type)
setType in interface FirebirdConnectionPropertiestype - type of the connection, for example, "PURE_JAVA", "LOCAL",
"EMBEDDED", depends on the GDS implementations installed in the system.public void setUserName(java.lang.String userName)
setUserName in interface FirebirdConnectionPropertiesuserName - name of the user that will be used when connecting to the database.public void setUseStandardUdf(boolean useStandardUdf)
setUseStandardUdf in interface FirebirdConnectionPropertiesuseStandardUdf - true if driver should assume that standard UDF
are installed.public void setUseStreamBlobs(boolean useStreamBlobs)
setUseStreamBlobs in interface FirebirdConnectionPropertiesuseStreamBlobs - true if stream blobs should be created,
otherwise false.public boolean isDefaultResultSetHoldable()
FirebirdConnectionPropertiesisDefaultResultSetHoldable in interface FirebirdConnectionPropertiestrue when ResultSets are holdable by default, false not holdable.public void setDefaultResultSetHoldable(boolean isHoldable)
FirebirdConnectionPropertiessetDefaultResultSetHoldable in interface FirebirdConnectionPropertiesisHoldable - true when ResultSets are holdable by default, false not holdable.public void setDefaultConnectionManager(javax.resource.spi.ConnectionManager defaultCm)
public int getSoTimeout()
FirebirdConnectionPropertiesgetSoTimeout in interface FirebirdConnectionPropertiespublic void setSoTimeout(int soTimeout)
FirebirdConnectionPropertiessetSoTimeout in interface FirebirdConnectionPropertiessoTimeout - Timeout in milliseconds (0 is 'infinite')public int getConnectTimeout()
FirebirdConnectionPropertiesgetConnectTimeout in interface FirebirdConnectionPropertiespublic void setConnectTimeout(int connectTimeout)
FirebirdConnectionPropertiessetConnectTimeout in interface FirebirdConnectionPropertiesconnectTimeout - Connect timeout in seconds (0 is 'infinite', or better: OS specific timeout)public boolean isUseFirebirdAutocommit()
FirebirdConnectionPropertiesisUseFirebirdAutocommit in interface FirebirdConnectionPropertiestrue use Firebird autocommitpublic void setUseFirebirdAutocommit(boolean useFirebirdAutocommit)
FirebirdConnectionPropertiessetUseFirebirdAutocommit in interface FirebirdConnectionPropertiesuseFirebirdAutocommit - true Use Firebird autocommitpublic java.lang.String getWireCrypt()
FirebirdConnectionPropertiesgetWireCrypt in interface FirebirdConnectionPropertiesnull implies DEFAULT)public void setWireCrypt(java.lang.String wireCrypt)
FirebirdConnectionProperties
Values are defined by WireCrypt, values are handled case insensitive.
Invalid values are accepted, but will cause an error when a connection is established.
setWireCrypt in interface FirebirdConnectionPropertieswireCrypt - Wire encryption levelpublic java.lang.String getDbCryptConfig()
FirebirdConnectionPropertiesgetDbCryptConfig in interface FirebirdConnectionPropertiespublic void setDbCryptConfig(java.lang.String dbCryptConfig)
FirebirdConnectionPropertiessetDbCryptConfig in interface FirebirdConnectionPropertiesdbCryptConfig - Database encryption plugin configuration, meaning plugin specificpublic java.lang.String getAuthPlugins()
FirebirdConnectionPropertiesgetAuthPlugins in interface FirebirdConnectionPropertiesnull for driver defaultpublic void setAuthPlugins(java.lang.String authPlugins)
FirebirdConnectionPropertiesInvalid names are skipped during authentication.
setAuthPlugins in interface FirebirdConnectionPropertiesauthPlugins - comma-separated list of authentication plugins, or null for driver defaultpublic java.lang.String getGeneratedKeysEnabled()
FirebirdConnectionPropertiesgeneratedKeysEnabled configuration.getGeneratedKeysEnabled in interface FirebirdConnectionPropertiesgeneratedKeysEnabled, or null for driver defaultpublic void setGeneratedKeysEnabled(java.lang.String generatedKeysEnabled)
FirebirdConnectionPropertiesgeneratedKeysEnabled configuration.setGeneratedKeysEnabled in interface FirebirdConnectionPropertiesgeneratedKeysEnabled - Generated keys support configuration: default (or null/empty), disabled, ignored,
or a list of statement types to enable (possible values: insert, update, delete,
update_or_insert, merge)public java.lang.String getDataTypeBind()
FirebirdConnectionPropertiesdataTypeBind configuration.getDataTypeBind in interface FirebirdConnectionPropertiesdataTypeBind, or null for driver defaultpublic void setDataTypeBind(java.lang.String dataTypeBind)
FirebirdConnectionPropertiesdataTypeBind configuration.
If the value is explicitly set to a non-null value and the connected server is Firebird 4 or higher, this will
configure the data type binding with the specified values using isc_dpb_set_bind, which is equivalent to
executing SET BIND statements with the values.
See also Firebird documentation for SET BIND.
setDataTypeBind in interface FirebirdConnectionPropertiesdataTypeBind - Firebird 4+ data type bind configuration, a semicolon-separated list of <from-type> TO <to-type>public java.lang.String getSessionTimeZone()
FirebirdConnectionPropertiessessionTimeZone.getSessionTimeZone in interface FirebirdConnectionPropertiessessionTimeZone, or null for driver default (JVM default time zone)public void setSessionTimeZone(java.lang.String sessionTimeZone)
FirebirdConnectionPropertiessessionTimeZone.setSessionTimeZone in interface FirebirdConnectionPropertiessessionTimeZone - Firebird 4+ session time zone name (we strongly suggest to use Java compatible names only),
use "server" to use server default time zone (note: conversion will use JVM default time zone)public boolean isIgnoreProcedureType()
FirebirdConnectionPropertiesignoreProcedureType.isIgnoreProcedureType in interface FirebirdConnectionPropertiesignoreProcedureTypepublic void setIgnoreProcedureType(boolean ignoreProcedureType)
FirebirdConnectionPropertiesignoreProcedureType.
When set to true, the CallableStatement implementation in Jaybird will ignore metadata
information about the stored procedure type and default to using EXECUTE PROCEDURE, unless the type is
explicitly set using FirebirdCallableStatement.setSelectableProcedure(boolean). This can be useful in
situations where a stored procedure is selectable, but tooling or code expects an executable stored procedure.
setIgnoreProcedureType in interface FirebirdConnectionPropertiesignoreProcedureType - true Ignore procedure typepublic boolean isWireCompression()
FirebirdConnectionPropertiesWire compression requires Firebird 3 or higher, and the server must have the zlib library. If compression cannot be negotiated, the connection will be made without wire compression.
This property will be ignored for native connections. For native connections, the configuration in
firebird.conf read by the client library will be used.
isWireCompression in interface FirebirdConnectionPropertiestrue wire compression enabledpublic void setWireCompression(boolean wireCompression)
FirebirdConnectionPropertiessetWireCompression in interface FirebirdConnectionPropertieswireCompression - true enable wire compression, false disable wire compression (the default)FirebirdConnectionProperties.isWireCompression()public int hashCode()
hashCode in interface javax.resource.spi.ManagedConnectionFactoryhashCode in class java.lang.Objectpublic boolean equals(java.lang.Object other)
equals in interface javax.resource.spi.ManagedConnectionFactoryequals in class java.lang.Objectpublic FBConnectionRequestInfo getDefaultConnectionRequestInfo() throws javax.resource.ResourceException
javax.resource.ResourceExceptionpublic FBTpb getDefaultTpb() throws javax.resource.ResourceException
javax.resource.ResourceExceptionpublic FBTpb getTpb(int defaultTransactionIsolation) throws FBResourceException
FBResourceExceptionpublic java.lang.Object createConnectionFactory(javax.resource.spi.ConnectionManager cxManager)
throws javax.resource.ResourceException
createConnectionFactory method creates a DataSource
using the supplied ConnectionManager.createConnectionFactory in interface javax.resource.spi.ManagedConnectionFactorycxManager - a ConnectionManager valuejava.lang.Object valuejavax.resource.ResourceException - if an error occurspublic java.lang.Object createConnectionFactory()
throws javax.resource.ResourceException
createConnectionFactory method creates a DataSource
with a default stand alone ConnectionManager. Ours can implement pooling.createConnectionFactory in interface javax.resource.spi.ManagedConnectionFactoryjavax.sql.DataSource based around this
connection factoryjavax.resource.ResourceException - if an error occurspublic javax.resource.spi.ManagedConnection createManagedConnection(javax.security.auth.Subject subject,
javax.resource.spi.ConnectionRequestInfo cri)
throws javax.resource.ResourceException
createManagedConnection in interface javax.resource.spi.ManagedConnectionFactorysubject - Caller's security informationcri - Additional resource adapter specific connection request
informationjavax.resource.ResourceException - generic exceptionjavax.resource.spi.SecurityException - security related errorjavax.resource.spi.ResourceAllocationException - failed to allocate system resources for connection requestjavax.resource.spi.ResourceAdapterInternalException - resource adapter related error conditionjavax.resource.spi.EISSystemException - internal error condition in EIS instancepublic javax.resource.spi.ManagedConnection matchManagedConnections(java.util.Set connectionSet,
javax.security.auth.Subject subject,
javax.resource.spi.ConnectionRequestInfo cxRequestInfo)
throws javax.resource.ResourceException
Subject) and information provided through
ConnectionRequestInfo and additional Resource Adapter
specific criteria to do matching. Note that criteria used for matching is
specific to a resource adapter and is not prescribed by the
Connector specification.
This method returns a ManagedConnection instance that is
the best match for handling the connection allocation request.
matchManagedConnections in interface javax.resource.spi.ManagedConnectionFactoryconnectionSet - candidate connection setsubject - caller's security informationcxRequestInfo - additional resource adapter specific connection request
informationjavax.resource.ResourceException - -
generic exceptionjavax.resource.spi.SecurityException - -
security related errorjavax.resource.spi.ResourceAdapterInternalException - -
resource adapter related error conditionjavax.resource.NotSupportedException - -
if operation is not supportedpublic void setLogWriter(java.io.PrintWriter out)
throws javax.resource.ResourceException
ManagedConnectionFactory
instance. The log writer is a character output stream to which all
logging and tracing messages for this
ManagedConnectionFactory instance will be printed.
ApplicationServer manages the association of output stream with the
ManagedConnectionFactory. When a
ManagedConnectionFactory object is created the log writer
is initially null, in other words, logging is disabled.
Once a log writer is associated with a
ManagedConnectionFactory, logging and tracing for
ManagedConnectionFactory instance is enabled.
The ManagedConnection instances created by
ManagedConnectionFactory "inherits" the log writer, which
can be overridden by ApplicationServer using
ManagedConnection.setLogWriter(java.io.PrintWriter)to set
ManagedConnection specific logging and tracing.
setLogWriter in interface javax.resource.spi.ManagedConnectionFactoryout - an out stream for error logging and tracingjavax.resource.ResourceException - generic exceptionjavax.resource.spi.ResourceAdapterInternalException - resource adapter related error conditionpublic java.io.PrintWriter getLogWriter()
ManagedConnectionFactory
instance. The log writer is a character output stream to which all
logging and tracing messages for this
ManagedConnectionFactory instance will be printed.
ApplicationServer manages the association of output stream with the
ManagedConnectionFactory. When a
ManagedConnectionFactory object is created the log writer
is initially null, in other words, logging is disabled.getLogWriter in interface javax.resource.spi.ManagedConnectionFactoryjavax.resource.ResourceException - generic exceptionpublic FBManagedConnectionFactory canonicalize()
canonicalize method is used in FBDriver to reuse
previous fbmcf instances if they have been create. It should really be
package access levelFBManagedConnectionFactory valuepublic void forget(FBManagedConnection mc, javax.transaction.xa.Xid xid) throws GDSException
GDSExceptionpublic void recover(FBManagedConnection mc, javax.transaction.xa.Xid xid) throws GDSException
GDSExceptionpublic final FBConnectionProperties getCacheKey()
Copyright © 2001-2023 Jaybird (Firebird JDBC/JCA) team. All rights reserved.