org.tranql.connector.jdbc
Class JDBCDriverMCF

java.lang.Object
  org.tranql.connector.jdbc.JDBCDriverMCF

All Implemented Interfaces:

Serializable, javax.resource.spi.ManagedConnectionFactory, AutocommitSpecCompliant, UserPasswordManagedConnectionFactory

public class JDBCDriverMCF
extends Object
implements UserPasswordManagedConnectionFactory, AutocommitSpecCompliant

Implementation of a ManagedConnectionFactory that connects to a JDBC database using a generic JDBC Driver.

Version:

$Revision: 800 $ $Date: 2010-11-02 21:14:25 +0100 (Tue, 02 Nov 2010) $

See Also:

Serialized Form

Constructor Summary

JDBCDriverMCF()

Method Summary

Object	createConnectionFactory()
Object	createConnectionFactory(javax.resource.spi.ConnectionManager connectionManager)
javax.resource.spi.ManagedConnection	createManagedConnection(Subject subject, javax.resource.spi.ConnectionRequestInfo connectionRequestInfo)
boolean	equals(Object obj) Equality is define in terms of the url property.
String	getConnectionURL() Return the JDBC connection URL
String	getDriver() Return the name of the Driver class
String	getExceptionSorterClass() Return the name of the ExceptionSorter implementation used to classify Exceptions raised by the Driver.
PrintWriter	getLogWriter()
String	getPassword() Return the password credential used to establish the connection.
protected Connection	getPhysicalConnection(Subject subject, CredentialExtractor credentialExtractor)
String	getUserName() Return the user name used to establish the connection.
int	hashCode()
Boolean	isCommitBeforeAutocommit() Return whether the Driver requires a commit before enabling auto-commit.
javax.resource.spi.ManagedConnection	matchManagedConnections(Set set, Subject subject, javax.resource.spi.ConnectionRequestInfo connectionRequestInfo)
void	setCommitBeforeAutocommit(Boolean commitBeforeAutocommit) Set whether the Driver requires a commit before enabling auto-commit.
void	setConnectionURL(String url) Set the JDBC connection URL.
void	setDriver(String driver) Set the name of the Driver class
void	setExceptionSorterClass(String className) Set the name of the ExceptionSorter implementation so use.
void	setLogWriter(PrintWriter log)
void	setPassword(String password) Set the user password credential establish the connection.
void	setUserName(String user) Set the user name used establish the connection.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

JDBCDriverMCF

public JDBCDriverMCF()

Method Detail

createConnectionFactory

public Object createConnectionFactory()
                               throws javax.resource.ResourceException

Specified by:

createConnectionFactory in interface javax.resource.spi.ManagedConnectionFactory

Throws:

javax.resource.ResourceException

createConnectionFactory

public Object createConnectionFactory(javax.resource.spi.ConnectionManager connectionManager)
                               throws javax.resource.ResourceException

Specified by:

createConnectionFactory in interface javax.resource.spi.ManagedConnectionFactory

Throws:

javax.resource.ResourceException

createManagedConnection

public javax.resource.spi.ManagedConnection createManagedConnection(Subject subject,
                                                                    javax.resource.spi.ConnectionRequestInfo connectionRequestInfo)
                                                             throws javax.resource.ResourceException

Specified by:

createManagedConnection in interface javax.resource.spi.ManagedConnectionFactory

Throws:

javax.resource.ResourceException

getPhysicalConnection

protected Connection getPhysicalConnection(Subject subject,
                                           CredentialExtractor credentialExtractor)
                                    throws javax.resource.ResourceException

Throws:

javax.resource.ResourceException

matchManagedConnections

public javax.resource.spi.ManagedConnection matchManagedConnections(Set set,
                                                                    Subject subject,
                                                                    javax.resource.spi.ConnectionRequestInfo connectionRequestInfo)
                                                             throws javax.resource.ResourceException

Specified by:

matchManagedConnections in interface javax.resource.spi.ManagedConnectionFactory

Throws:

javax.resource.ResourceException

getLogWriter

public PrintWriter getLogWriter()

Specified by:

getLogWriter in interface javax.resource.spi.ManagedConnectionFactory

setLogWriter

public void setLogWriter(PrintWriter log)

Specified by:

setLogWriter in interface javax.resource.spi.ManagedConnectionFactory

getDriver

public String getDriver()

Return the name of the Driver class

Returns:

the name of the Driver class

setDriver

public void setDriver(String driver)
               throws javax.resource.spi.InvalidPropertyException

Set the name of the Driver class

Parameters:

driver - the name of the Driver class

Throws:

javax.resource.spi.InvalidPropertyException - if the class name is null or empty

getConnectionURL

public String getConnectionURL()

Return the JDBC connection URL

Returns:

the JDBC connection URL

setConnectionURL

public void setConnectionURL(String url)
                      throws javax.resource.spi.InvalidPropertyException

Set the JDBC connection URL. This URL is passed directly to the Driver and should contain any properties required to configure the connection.

Parameters:

url - the JDBC connection URL

Throws:

javax.resource.spi.InvalidPropertyException - if url missing

getUserName

public String getUserName()

Return the user name used to establish the connection.

Specified by:

getUserName in interface UserPasswordManagedConnectionFactory

Returns:

the user name used to establish the connection

setUserName

public void setUserName(String user)

Set the user name used establish the connection. This value is used if no connection information is supplied by the application when attempting to create a connection.

Parameters:

user - the user name used to establish the connection; may be null

getPassword

public String getPassword()

Return the password credential used to establish the connection.

Specified by:

getPassword in interface UserPasswordManagedConnectionFactory

Returns:

the password credential used to establish the connection

setPassword

public void setPassword(String password)

Set the user password credential establish the connection. This value is used if no connection information is supplied by the application when attempting to create a connection.

Parameters:

password - the password credential used to establish the connection; may be null

isCommitBeforeAutocommit

public Boolean isCommitBeforeAutocommit()

Return whether the Driver requires a commit before enabling auto-commit.

Specified by:

isCommitBeforeAutocommit in interface AutocommitSpecCompliant

Returns:

TRUE if the Driver requires a commit before enabling auto-commit.

setCommitBeforeAutocommit

public void setCommitBeforeAutocommit(Boolean commitBeforeAutocommit)

Set whether the Driver requires a commit before enabling auto-commit. Although the JDBC specification requires any pending work to be committed when auto-commit is enabled, not all drivers respect this. Setting this property to true will cause the connector to explicitly commit the transaction before re-enabling auto-commit; for compliant drivers this may result in two commits.

Parameters:

commitBeforeAutocommit - set TRUE if a commit should be performed before enabling auto-commit

getExceptionSorterClass

public String getExceptionSorterClass()

Return the name of the ExceptionSorter implementation used to classify Exceptions raised by the Driver.

Returns:

the class name of the ExceptionSorter being used

setExceptionSorterClass

public void setExceptionSorterClass(String className)
                             throws javax.resource.spi.InvalidPropertyException

Set the name of the ExceptionSorter implementation so use.

Parameters:

className - the class name of an ExceptionSorter to use

Throws:

javax.resource.spi.InvalidPropertyException - if the class name is null or empty

equals

public boolean equals(Object obj)

Equality is define in terms of the url property.

Specified by:

equals in interface javax.resource.spi.ManagedConnectionFactory

Overrides:

equals in class Object

hashCode

public int hashCode()

Specified by:

hashCode in interface javax.resource.spi.ManagedConnectionFactory

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object