Oracle Fusion Middleware
Oracle WebLogic Server 10.3.1 MBean API Reference
11g Release 1 (10.3.1)

Part Number E13945-02

weblogic.management.configuration
Interface JDBCDataSourceFactoryMBean

All Superinterfaces:
ConfigurationMBean

Deprecated. 9.0.0.0 Replaced by configuration.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.

Since:
7.0.0.0
Access limited to the following security roles:
Deployer

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
 

Method Detail

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

Documentation is available at
http://download.oracle.com/docs/cd/E12839_01/web.1111/wls.htm
Copyright 1996, 2009, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Oracle WebLogic Server 10.3.1 MBean API Reference
11g Release 1 (10.3.1)

Part Number E13945-02