weblogic.j2ee.descriptor.wl

Interface JDBCDriverParamsBean

All Superinterfaces:

SettableBean

public interface JDBCDriverParamsBean
extends SettableBean

Contains the driver parameters of a data source.

Configuration parameters for the JDBC Driver used by a data source are specified using a driver parameters bean.

Method Summary

Modifier and Type	Method and Description
String	getDriverName() The full package name of JDBC driver class used to create the physical database connections in the connection pool in the data source.
String	getPassword() The password attribute passed to the JDBC driver when creating physical database connections.
byte[]	getPasswordEncrypted() The encrypted database password as set with setPassword(), setPasswordEncrypted(byte[] bytes), or as a key=value pair in the list of JDBC driver properties.
JDBCPropertiesBean	getProperties() The list of properties passed to the JDBC driver when creating physical database connections.
String	getUrl() The URL of the database to connect to.
boolean	isUsePasswordIndirection() Specifies whether the database credentials are to be obtained from the credential mapper using the "user" property as the key.
boolean	isUseXaDataSourceInterface() Specifies that WebLogic Server should use the XA interface of the JDBC driver.
void	setDriverName(String driverName)
void	setPassword(String password)
void	setPasswordEncrypted(byte[] passwordEncrypted)
void	setUrl(String url)
void	setUsePasswordIndirection(boolean usePasswordIndirection)
void	setUseXaDataSourceInterface(boolean useXaDataSourceInterface)

Method Detail

getUrl

String getUrl()

The URL of the database to connect to. The format of the URL varies by JDBC driver.

The URL is passed to the JDBC driver to create the physical database connections.

setUrl

void setUrl(String url)

getDriverName

String getDriverName()

The full package name of JDBC driver class used to create the physical database connections in the connection pool in the data source.

For example: oracle.jdbc.OracleDriver

The driver must be the name of a class that implements the java.sql.Driver interface. Check the driver documentation to find the full pathname.

Note that the driver class must be in the classpath of any server to which the data source is deployed.

setDriverName

void setDriverName(String driverName)

getProperties

JDBCPropertiesBean getProperties()

The list of properties passed to the JDBC driver when creating physical database connections.

To enable driver-level features, add the driver property and its value to the Properties list. WebLogic Server sets driver-level properties in the Properties list on the driver's ConnectionPoolDataSource object.

Note: For Security reasons, when WebLogic Server is running in Production mode, you cannot specify database passwords in this properties list. Data source deployment will fail if a password is specified in the properties list. To override this security check, use the command line argument weblogic.management.allowClearTextPasswords when starting the server.

getPasswordEncrypted

byte[] getPasswordEncrypted()

The encrypted database password as set with setPassword(), setPasswordEncrypted(byte[] bytes), or as a key=value pair in the list of JDBC driver properties.

Returns:

The password value as an encrypted byte array

setPasswordEncrypted

void setPasswordEncrypted(byte[] passwordEncrypted)

isUseXaDataSourceInterface

boolean isUseXaDataSourceInterface()

Specifies that WebLogic Server should use the XA interface of the JDBC driver.

If the JDBC driver class used to create database connections implements both XA and non-XA versions of a JDBC driver, you can set this attribute to indicate that WebLogic Server should treat the JDBC driver as an XA driver or as a non-XA driver.

setUseXaDataSourceInterface

void setUseXaDataSourceInterface(boolean useXaDataSourceInterface)

getPassword

String getPassword()

The password attribute passed to the JDBC driver when creating physical database connections.

The value is stored in an encrypted form in the descriptor file and when displayed in an administration console.

Returns:

The clear text value of the password if it can be determined

setPassword

void setPassword(String password)

isUsePasswordIndirection

boolean isUsePasswordIndirection()

Specifies whether the database credentials are to be obtained from the credential mapper using the "user" property as the key. When true, the credentials are obtained from the credential mapper. When false, the database user name and password are obtained from the "user" property and Password element, respectively.

See Also:

JDBCDriverParamsBean.getPassword()

setUsePasswordIndirection

void setUsePasswordIndirection(boolean usePasswordIndirection)