weblogic.management.configuration
Interface JDBCDataSourceFactoryMBean

All Superinterfaces:

ConfigurationMBean

public interface JDBCDataSourceFactoryMBean
extends ConfigurationMBean

This MBean represents the object used to create data sources that applications use to access application-scoped JDBC connection pools.

Deprecation of MBeanHome and Type-Safe Interfaces

This is a type-safe interface for a WebLogic Server MBean, which you can import into your client classes and access through weblogic.management.MBeanHome. As of 9.0, the MBeanHome interface and all type-safe interfaces for WebLogic Server MBeans are deprecated. Instead, client classes that interact with WebLogic Server MBeans should use standard JMX design patterns in which clients use the javax.management.MBeanServerConnection interface to discover MBeans, attributes, and attribute types at runtime.

Since:

7.0.0.0

Access limited to the following security roles:

Deployer

setUserName

void setUserName(String s)

Deprecated. 

Sets the value of the UserName attribute.

Parameters:

s - The new userName value

See Also:

JDBCDataSourceFactoryMBean.getUserName()

getUserName

String getUserName()

Deprecated. 

The database account user name used in physical database connections. This may be overridden by user-name in the descriptor.

Returns:

The userName value

setPassword

void setPassword(String s)

Deprecated. 

Sets the value of the Password attribute.

Parameters:

s - The new password value

See Also:

JDBCDataSourceFactoryMBean.getPassword()

getPassword

String getPassword()

Deprecated. 

The database user password. If the user password is specified in the descriptor, the descriptor value overrides this value.

As of 8.1 sp4, when you get the value of this attribute, WebLogic Server does the following:

1. Retrieves the value of the PasswordEncrypted attribute.
2. Decrypts the value and returns the unencrypted password as a String.

When you set the value of this attribute, WebLogic Server does the following:

1. Encrypts the value.
2. Sets the value of the PasswordEncrypted attribute to the encrypted value.

Using this attribute (Password) is a potential security risk because the String object (which contains the unencrypted password) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.

Instead of using this attribute, use PasswordEncrypted().

Returns:

The password value

See Also:

JDBCDataSourceFactoryMBean.getPasswordEncrypted();

getPasswordEncrypted

byte[] getPasswordEncrypted()

Deprecated. 

The encrypted database user password. If the user password is specified in the descriptor, the descriptor value overrides this value.

To set this attribute, use weblogic.management.EncryptionHelper.encrypt() to encrypt the value. Then set this attribute to the output of the encrypt() method.

To compare a password that a user enters with the encrypted value of this attribute, go to the same WebLogic Server instance that you used to set and encrypt this attribute and use weblogic.management.EncryptionHelper.encrypt() to encrypt the user-supplied password. Then compare the encrypted values.

Returns:

The password value as an encrypted byte array.

setPasswordEncrypted

void setPasswordEncrypted(byte[] bytes)

Deprecated. 

Encrypts the user password and sets the value of the PasswordEncrypted attribute.

Parameters:

bytes - The new password value, as a byte array

See Also:

JDBCDataSourceFactoryMBean.getPasswordEncrypted()

setURL

void setURL(String s)

Deprecated. 

Sets the value of the URL attribute.

Parameters:

s - The new uRL value

See Also:

JDBCDataSourceFactoryMBean.getURL()

getURL

String getURL()

Deprecated. 

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

This may be overridden by url in the descriptor.

Returns:

The uRL value

setDriverClassName

void setDriverClassName(String s)

Deprecated. 

Sets the value of the DriverClassName attribute.

Parameters:

s - The new driverClassName value

See Also:

JDBCDataSourceFactoryMBean.getDriverClassName()

getDriverClassName

String getDriverClassName()

Deprecated. 

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

This may be overridden by driver-name in the descriptor.

Returns:

The driverClassName value

getProperties

Map getProperties()

Deprecated. 

The list of properties passed to the JDBC driver that are used to create physical database connections. For example: server=dbserver1.

Returns:

The properties value

setProperties

void setProperties(Map m)

Deprecated. 

Sets the value of the Properties attribute.

Parameters:

m - The new properties value

See Also:

JDBCDataSourceFactoryMBean.getProperties()

setFactoryName

void setFactoryName(String s)

Deprecated. 

Sets the value of the FactoryName attribute.

Parameters:

s - The new factoryName value

See Also:

JDBCDataSourceFactoryMBean.getFactoryName()

getFactoryName

String getFactoryName()

Deprecated. 

The name used in deployment descriptor files to reference this JDBC data source factory.

This is referenced from the connection-factory element in weblogic-application.xml.

Returns:

The factoryName value