Skip navigation.

Administration Console Online Help

PreviousNextvertical dots separating previous/next from contents/index/pdfContents

JDBC Data Source Factory: Configuration

Configuration Options     Related Tasks     Related Topics

A JDBC data source factory is an instance of a JDBC data source resource bound to the WebLogic Server JNDI tree as a resource factory.

Use this page to configure a JDBC data source factory.

An application-scoped JDBC connection pool relies on a JDBC data source factory to provide default connection pool values. You must create a data source factory before you deploy an enterprise application that includes an application-scoped connection pool. The weblogic-application.xml supplemental deployment descriptor for the application must reference the data source factory by the factory name that you specify in the Administration Console.

Properties that you specify for a data source factory are used as default values for application-scoped connection pools that reference the factory. You can override the default values in the weblogic-application.xml supplemental deployment descriptor.

Configuration Options

Name Description
Name

The name of this JDBC data source factory.

MBean Attribute:
JDBCDataSourceFactoryMBean.Name

Changes take effect after you redeploy the module or restart the server.

User Name

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

MBean Attribute:
JDBCDataSourceFactoryMBean.UserName

Changes take effect after you redeploy the module or restart the server.

Password

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().

MBean Attribute:
JDBCDataSourceFactoryMBean.Password

Changes take effect after you redeploy the module or restart the server.

URL

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.

MBean Attribute:
JDBCDataSourceFactoryMBean.URL

Changes take effect after you redeploy the module or restart the server.

Driver Class Name

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.

MBean Attribute:
JDBCDataSourceFactoryMBean.DriverClassName

Changes take effect after you redeploy the module or restart the server.

Factory Name

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.

MBean Attribute:
JDBCDataSourceFactoryMBean.FactoryName

Changes take effect after you redeploy the module or restart the server.

Properties

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

MBean Attribute:
JDBCDataSourceFactoryMBean.Properties

Changes take effect after you redeploy the module or restart the server.

Related Tasks

Related Topics

 

Skip navigation bar   Back to Top