borland Packages  Class Hierarchy  javax.sql Package 

JdbcConnectionFactory component

java.lang.Object
   +----com.borland.javax.sql.DataSourceProperties
           +----com.borland.javax.sql.JdbcConnectionFactory

About the JdbcConnectionFactory component

Constructors  Properties  Methods  

Implements Designable, Serializable, Referenceable

Note: This is a feature of JBuilder Professional and Enterprise.

JdbcConnectionFactory can be used by a connection pooling implementation to provide connections to any data source which can be accessed by a JDBC driver. JdbcConnectionFactory also knows how to provide an XA connection to a JDataStore. Once this class is specified as the factory implementation for a connection pool, it is usually the pool that interacts with JdbcConnectionFactory. In other words, you usually do not call its methods directly.

See "Pooling JDBC connections" in the Database Application Developer's Guide for more information.


JdbcConnectionFactory constructors

JdbcConnectionFactory properties

*Read-only properties **Write-only properties

Properties implemented in this class

Properties implemented in com.borland.javax.sql.DataSourceProperties

Properties implemented in java.lang.Object

JdbcConnectionFactory methods

Methods implemented in this class

Methods implemented in com.borland.javax.sql.DataSourceProperties

Methods implemented in java.lang.Object


JdbcConnectionFactory constructors

JdbcConnectionFactory()

  public JdbcConnectionFactory()

JdbcConnectionFactory properties

maxConStatements

 public final int getMaxConStatements()
 public final void setMaxConStatements(int max)
This property controls how many "pooled" statements can be open at one time by a Connection created by this factory. If the number of "used" plus "pooled" statements exceeds maxConStatements, pooled statements will be closed when the Connection attempts to move a used statement to the statement pool.

pooledConnection

 public final PooledConnection getPooledConnection()
A pooled connection to the JDBC data source specified by the driver and url properties. These properties can point to any JDBC data source.

reference

 public javax.naming.Reference getReference()
This property is needed to persist the JdbcConnectionFactory in some JNDI implementations. You usually do not need to use this property.

XAConnection

 public XAConnection getXAConnection()
A pooled connection for use in a distributed transaction. This must be a connection to a JDataStore via the JDataStore JDBC driver, therefore to use this method, the driver and url properties must point to a JDataStore. XAConnection is only useful when used in conjunction with a distributed transaction manager, such as the one provided by the Inprise Application Server.

JdbcConnectionFactory methods

getPooledConnection(java.lang.String, java.lang.String)

  public final synchronized PooledConnection getPooledConnection(String user, String password)
Returns a PooledConnection to the JDBC data source specified by the driver and url properties.

getXAConnection(java.lang.String, java.lang.String)

  public XAConnection getXAConnection(String user, String password)
Returns a XAConnection to the JDataStore specified in the url property via the JDataStore JDBC driver (which must be specified in the driver property). XAConnections are only useful in conjunction with a distributed transaction manager, such as the one provided by the Inprise Application Server.