weblogic.management.configuration
Interface JDBCDataSourceMBean

All Superinterfaces:

ConfigurationMBean, DeploymentMBean, DescriptorBean, DynamicMBean, MBeanRegistration, NotificationBroadcaster, SettableBean, WebLogicMBean

public interface JDBCDataSourceMBean
extends DeploymentMBean

This MBean defines a non-transactional JDBC data source.

Access limited to the following security roles:

Deployer

getJNDIName

String getJNDIName()

Deprecated. 

The JNDI path to where this Data Source is bound.

Applications that look up the JNDI path will get a javax.sql.DataSource instance that corresponds to this Data Source. Note that the old style usage of DriverManager.getConnection() or Driver.connect() has been deprecated in favor of looking up a Data Source to obtain a connection.

Returns:

The jNDIName value

setJNDIName

void setJNDIName(String name)
                 throws InvalidAttributeValueException

Deprecated. 

Sets the value of the JNDIName attribute.

Parameters:

name - The new jNDIName value

Throws:

InvalidAttributeValueException

See Also:

JDBCDataSourceMBean.getJNDIName()

getJNDINameSeparator

String getJNDINameSeparator()

Deprecated. 

The JNDI Seperator is used to seperate JNDIName list for this DataSource.

Applications that look up the JNDI path will get a javax.sql.DataSource instance that corresponds to this DataSource.

Returns:

The jNDINameSeparator value

setJNDINameSeparator

void setJNDINameSeparator(String name)
                          throws InvalidAttributeValueException

Deprecated. 

Sets the Separator used for list of different JNDINames for this DataSource. Applications that look up the JNDI path will get a javax.sql.DataSource instance that corresponds to this DataSource.

Parameters:

name - The new jNDINameSeparator value

Throws:

InvalidAttributeValueException

This method can NOT set a null value.

This method can NOT set a value of zero length.

Default Value:

JDBCLegalHelper.JNDI_NAME_SEPARATOR

getPoolName

String getPoolName()

Deprecated. 

The PoolName attribute applies to legacy data source configurations only. Do not set a PoolName for a WebLogic Server 9.0 or later JDBC data source.

For JDBC data source configurations before WebLogic Server 9.0, the PoolName is the name of the JDBC connection pool that is associated with this data source. Calls from applications to getConnection() on this Data Source return a connection from the associated connection pool.

Returns:

The poolName value

setPoolName

void setPoolName(String pool)
                 throws InvalidAttributeValueException

Deprecated. 

Sets the value of the PoolName attribute.

Parameters:

pool - The new poolName value

Throws:

InvalidAttributeValueException

See Also:

JDBCDataSourceMBean.getPoolName()

isRowPrefetchEnabled

boolean isRowPrefetchEnabled()

Deprecated. 

Specifies whether multiple rows should be "prefetched" (that is, sent from the server to the client) in one server access.

When an external client accesses a database using JDBC through WebLogic Server, row prefetching improves performance by fetching multiple rows from the server to the client in one server access. WebLogic Server ignores this setting and does not use row prefetching when the client and WebLogic Server are in the same JVM.

Returns:

The rowPrefetchEnabled value

Default Value:

false

setRowPrefetchEnabled

void setRowPrefetchEnabled(boolean enable)

Deprecated. 

Sets the value of the RowPrefetchEnabled attribute.

Parameters:

enable - The new rowPrefetchEnabled value

See Also:

JDBCDataSourceMBean.isRowPrefetchEnabled()

Default Value:

false

getRowPrefetchSize

int getRowPrefetchSize()

Deprecated. 

Specifies the number of result set rows to prefetch for a client.

The optimal value depends on the particulars of the query. In general, increasing this number will increase performance, until a particular value is reached. At that point further increases do not result in any significant performance increase. Very rarely will increased performance result from exceeding 100 rows. The default value should be reasonable for most situations.

Returns:

The rowPrefetchSize value

Default Value:

48

Maximum Value:

65536

Minimum Value:

2

setRowPrefetchSize

void setRowPrefetchSize(int prefetch)

Deprecated. 

Sets the value of the RowPrefetchSize attribute.

Parameters:

prefetch - The new rowPrefetchSize value

See Also:

JDBCDataSourceMBean.getRowPrefetchSize()

getStreamChunkSize

int getStreamChunkSize()

Deprecated. 

Specifies the data chunk size for steaming data types.

Streaming data types (for example resulting from a call to getBinaryStream()) will be pulled in sized chunks from WebLogic Server to the client as needed.

Returns:

The streamChunkSize value

Default Value:

256

Maximum Value:

65536

Minimum Value:

1

setStreamChunkSize

void setStreamChunkSize(int chunk_size)

Deprecated. 

Sets the value of the StreamChunkSize attribute.

Parameters:

chunk_size - The new streamChunkSize value

See Also:

JDBCDataSourceMBean.getStreamChunkSize()

isWaitForConnectionEnabled

boolean isWaitForConnectionEnabled()

Deprecated. 

Specifies whether the system waits for a connection to become available if a request is made when all connections in the connection pool are in use. Oracle recommends that you do not use this feature in a production environment.

A WebLogic Server server thread is occupied while waiting for a free connection, which can result in a decrease in system throughput. Therefore, the recommended way to handle the situation is to increase the number of connections in the connection pool.

Returns:

The waitForConnectionEnabled value

Default Value:

false

setWaitForConnectionEnabled

void setWaitForConnectionEnabled(boolean enable)

Deprecated. 

Sets the value of the WaitForConnectionEnabled attribute.

Parameters:

enable - The new waitForConnectionEnabled value

See Also:

JDBCDataSourceMBean.isWaitForConnectionEnabled()

Default Value:

false

getConnectionWaitPeriod

int getConnectionWaitPeriod()

Deprecated. 

The number of seconds that the system will wait for a free connection to become available if a request is received when there are no free connections in the connection pool. (Requires that you enable the system to wait for connections.)

A WebLogic Server server thread is occupied while waiting for a free connection, which can result in a decrease in system throughput. Therefore, the recommended way to handle the situation is to increase the number of connections in the connection pool.

Returns:

The connectionWaitPeriod value

See Also:

JDBCDataSourceMBean.isWaitForConnectionEnabled()

Default Value:

1

Maximum Value:

60

Minimum Value:

1

setConnectionWaitPeriod

void setConnectionWaitPeriod(int waitseconds)

Deprecated. 

Sets the value of the ConnectionWaitPeriod attribute.

Parameters:

waitseconds - The new connectionWaitPeriod value

See Also:

JDBCDataSourceMBean.getConnectionWaitPeriod()