org.postgresql.xa

Class PGXADataSource

java.lang.Object

org.postgresql.ds.common.BaseDataSource

org.postgresql.xa.PGXADataSource

All Implemented Interfaces:

Referenceable, CommonDataSource, XADataSource

public class PGXADataSource
extends BaseDataSource
implements XADataSource, Referenceable

XA-enabled DataSource implementation.

Author:

Heikki Linnakangas (heikki.linnakangas@iki.fi)

Constructor Summary

Constructors

Constructor and Description
PGXADataSource()

Method Summary

Methods

Modifier and Type	Method and Description
protected Reference	createReference() Generates a reference using the appropriate object factory.
String	getDescription() Gets a description of this DataSource-ish thing.
Logger	getParentLogger() Return the parent Logger of all the Loggers used by this data source.
XAConnection	getXAConnection() Gets a connection to the PostgreSQL database.
XAConnection	getXAConnection(String user, String password) Gets a XA-enabled connection to the PostgreSQL database.

Methods inherited from class org.postgresql.ds.common.BaseDataSource

getAllowEncodingChanges, getApplicationName, getAssumeMinServerVersion, getBinaryTransfer, getBinaryTransferDisable, getBinaryTransferEnable, getCharset, getCompatible, getConnection, getConnection, getConnectTimeout, getCurrentSchema, getDatabaseName, getDefaultRowFetchSize, getDisableColumnSanitiser, getGssLib, getHostRecheckSeconds, getJaasApplicationName, getKerberosServerName, getLoadBalanceHosts, getLoginTimeout, getLoglevel, getLogLevel, getLogUnclosedConnections, getLogWriter, getPassword, getPortNumber, getPreparedStatementCacheQueries, getPreparedStatementCacheSizeMiB, getPrepareThreshold, getProperty, getProperty, getProtocolVersion, getReadOnly, getReceiveBufferSize, getReference, getSendBufferSize, getServerName, getSocketTimeout, getSsl, getSslCert, getSslfactory, getSslFactoryArg, getSslHostnameVerifier, getSslKey, getSslMode, getSslPassword, getSslPasswordCallback, getSslRootCert, getSspiServiceClass, getStringType, getTargetServerType, getTcpKeepAlive, getUnknownLength, getUrl, getUser, getUseSpNego, initializeFrom, isColumnSanitiserDisabled, readBaseObject, setAllowEncodingChanges, setApplicationName, setAssumeMinServerVersion, setBinaryTransfer, setBinaryTransferDisable, setBinaryTransferEnable, setCharset, setCompatible, setConnectTimeout, setCurrentSchema, setDatabaseName, setDefaultRowFetchSize, setDisableColumnSanitiser, setFromReference, setGssLib, setHostRecheckSeconds, setJaasApplicationName, setKerberosServerName, setLoadBalanceHosts, setLoginTimeout, setLoglevel, setLogLevel, setLogUnclosedConnections, setLogWriter, setPassword, setPortNumber, setPreparedStatementCacheQueries, setPreparedStatementCacheSizeMiB, setPrepareThreshold, setProperty, setProperty, setProtocolVersion, setReadOnly, setReceiveBufferSize, setSendBufferSize, setServerName, setSocketTimeout, setSsl, setSslCert, setSslfactory, setSslFactoryArg, setSslHostnameVerifier, setSslKey, setSslMode, setSslPassword, setSslPasswordCallback, setSslRootCert, setSspiServiceClass, setStringType, setTargetServerType, setTcpKeepAlive, setUnknownLength, setUrl, setUser, setUseSpNego, writeBaseObject

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.sql.CommonDataSource

getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter

Methods inherited from interface javax.naming.Referenceable

getReference

Constructor Detail

PGXADataSource

public PGXADataSource()

Method Detail

getXAConnection

public XAConnection getXAConnection()
                             throws SQLException

Gets a connection to the PostgreSQL database. The database is identified by the DataSource properties serverName, databaseName, and portNumber. The user to connect as is identified by the DataSource properties user and password.

Specified by:

getXAConnection in interface XADataSource

Returns:

A valid database connection.

Throws:

SQLException - Occurs when the database connection cannot be established.

getXAConnection

public XAConnection getXAConnection(String user,
                           String password)
                             throws SQLException

Gets a XA-enabled connection to the PostgreSQL database. The database is identified by the DataSource properties serverName, databaseName, and portNumber. The user to connect as is identified by the arguments user and password, which override the DataSource properties by the same name.

Specified by:

getXAConnection in interface XADataSource

Parameters:

user - the database user on whose behalf the connection is being made

password - the user's password

Returns:

A valid database connection.

Throws:

SQLException - Occurs when the database connection cannot be established.

getDescription

public String getDescription()

Description copied from class: BaseDataSource

Gets a description of this DataSource-ish thing. Must be customized by subclasses.

Specified by:

getDescription in class BaseDataSource

Returns:

description of this DataSource-ish thing

createReference

protected Reference createReference()

Generates a reference using the appropriate object factory.

Overrides:

createReference in class BaseDataSource

Returns:

reference using the appropriate object factory

getParentLogger

public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Description copied from interface: javax.sql.CommonDataSource

Return the parent Logger of all the Loggers used by this data source. This should be the Logger farthest from the root Logger that is still an ancestor of all of the Loggers used by this data source. Configuring this Logger will affect all of the log messages generated by the data source. In the worst case, this may be the root Logger.

Specified by:

getParentLogger in interface CommonDataSource

Returns:

the parent Logger for this data source

Throws:

SQLFeatureNotSupportedException - if the data source does not use java.util.logging.