Type-Safe Access to BEA WebLogic Server 9.0 MBeans (Deprecated)

(Methods marked with @since 9.0.0.0 are not available through the deprecated MBeanHome interface.)

weblogic.management.configuration
Interface JDBCDataSourceFactoryMBean

All Superinterfaces:

ConfigurationMBean, weblogic.descriptor.DescriptorBean, DynamicMBean, MBeanRegistration, NotificationBroadcaster, weblogic.descriptor.SettableBean, weblogic.management.WebLogicMBean

Deprecated. 9.0.0.0 Replaced by AppDeploymentMBean

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. For more information, see "Developing Manageable Applications with JMX" on http://www.oracle.com/technology/documentation/index.html.

Since:

7.0.0.0

Copyright © 2005 BEA Systems, Inc. All Rights Reserved.

Field Summary

Fields inherited from interface weblogic.management.configuration.ConfigurationMBean

DEFAULT_EMPTY_BYTE_ARRAY

Method Summary

String	getDriverClassName() Deprecated. The full package name of JDBC driver class used to create the physical database connections in the connection pool.
String	getFactoryName() Deprecated. The name used in deployment descriptor files to reference this JDBC data source factory.
String	getPassword() Deprecated. The database user password.
byte[]	getPasswordEncrypted() Deprecated. The encrypted database user password.
Map	getProperties() Deprecated. The list of properties passed to the JDBC driver that are used to create physical database connections.
String	getURL() Deprecated. The URL of the database to connect to.
String	getUserName() Deprecated. The database account user name used in physical database connections.
void	setDriverClassName(String s) Deprecated. Sets the value of the DriverClassName attribute.
void	setFactoryName(String s) Deprecated. Sets the value of the FactoryName attribute.
void	setPassword(String s) Deprecated. Sets the value of the Password attribute.
void	setPasswordEncrypted(byte[] bytes) Deprecated. Encrypts the user password and sets the value of the PasswordEncrypted attribute.
void	setProperties(Map m) Deprecated. Sets the value of the Properties attribute.
void	setURL(String s) Deprecated. Sets the value of the URL attribute.
void	setUserName(String s) Deprecated. Sets the value of the UserName attribute.

Methods inherited from interface weblogic.management.configuration.ConfigurationMBean

freezeCurrentValue, getName, getNotes, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet

Methods inherited from interface weblogic.management.WebLogicMBean

getMBeanInfo, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setParent

Methods inherited from interface javax.management.DynamicMBean

getAttribute, getAttributes, invoke, setAttribute, setAttributes

Methods inherited from interface javax.management.MBeanRegistration

postDeregister, postRegister, preDeregister, preRegister

Methods inherited from interface javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

Methods inherited from interface weblogic.descriptor.DescriptorBean

addBeanUpdateListener, addPropertyChangeListener, createChildCopy, createChildCopyIncludingObsolete, getDescriptor, getParentBean, isEditable, removeBeanUpdateListener, removePropertyChangeListener

Method Detail

getDriverClassName

public 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

getFactoryName

public 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

getPassword

public 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. 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:

getPasswordEncrypted()

getPasswordEncrypted

public 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, pass an unencrypted string to the MBean server's setAttribute method. WebLogic Server encrypts the value and sets the attribute to the encrypted value.

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.

See Also:

weblogic.management.EncryptionHelper

getProperties

public 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

A dynamic MBean attribute.

false

getURL

public 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

getUserName

public 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

setDriverClassName

public void setDriverClassName(String s)

Deprecated.

Sets the value of the DriverClassName attribute.

Parameters:

s - The new driverClassName value

See Also:

getDriverClassName()

A dynamic MBean attribute.

false

setFactoryName

public void setFactoryName(String s)

Deprecated.

Sets the value of the FactoryName attribute.

Parameters:

s - The new factoryName value

See Also:

getFactoryName()

A dynamic MBean attribute.

false

setPassword

public void setPassword(String s)

Deprecated.

Sets the value of the Password attribute.

Parameters:

s - The new password value

See Also:

getPassword()

setPasswordEncrypted

public 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:

getPasswordEncrypted()

A dynamic MBean attribute.

false

setProperties

public void setProperties(Map m)

Deprecated.

Sets the value of the Properties attribute.

Parameters:

m - The new properties value

See Also:

getProperties()

A dynamic MBean attribute.

false

setURL

public void setURL(String s)

Deprecated.

Sets the value of the URL attribute.

Parameters:

s - The new uRL value

See Also:

getURL()

A dynamic MBean attribute.

false

setUserName

public void setUserName(String s)

Deprecated.

Sets the value of the UserName attribute.

Parameters:

s - The new userName value

See Also:

getUserName()

A dynamic MBean attribute.

false