weblogic.management.configuration
Interface JDBCTxDataSourceMBean

All Superinterfaces:

ConfigurationMBean, DeploymentMBean

public interface JDBCTxDataSourceMBean
extends DeploymentMBean

This MBean defines a transaction-enabled JDBC DataSource.

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."

Access limited to the following security roles:

Deployer

getJNDIName

String getJNDIName()

Deprecated. 

The JNDI path to where this JDBC 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:

JDBCTxDataSourceMBean.getJNDIName()

getJNDINameSeparator

String getJNDINameSeparator()

Deprecated. 

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

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

JDBCTxDataSourceMBean.getPoolName(), JDBCConnectionPoolMBean

getEnableTwoPhaseCommit

boolean getEnableTwoPhaseCommit()

Deprecated. 

Specifies whether the JDBC resource will emulate participation in a global transaction. This option is only applicable when the associated connection pool uses a non-XA JDBC driver and when global transactions are honored in the Data Source.

When enabled, the JDBC resource will always return true during the XA prepare phase of the transaction. Use this option if the JDBC connection is the only participant in the transaction or if there is no XA compliant JDBC driver available. With more than one resource participating in a transaction where one of them (the JDBC driver) is emulating an XA resource, you may see heuristic failures.

Returns:

The enableTwoPhaseCommit value

See Also:

JDBCTxDataSourceMBean.setEnableTwoPhaseCommit(boolean enable)

setEnableTwoPhaseCommit

void setEnableTwoPhaseCommit(boolean enable)
                             throws InvalidAttributeValueException

Deprecated. 

Sets the value of the EnableTwoPhaseCommit attribute.

Parameters:

enable - The new enableTwoPhaseCommit value

Throws:

InvalidAttributeValueException

See Also:

JDBCTxDataSourceMBean.getEnableTwoPhaseCommit()

Default Value:

false

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 will ignore this setting and 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:

JDBCTxDataSourceMBean.isRowPrefetchEnabled()

Default Value:

false

setRowPrefetchSize

void setRowPrefetchSize(int prefetch)

Deprecated. 

Sets the value of the RowPrefetchSize attribute.

Parameters:

prefetch - The new rowPrefetchSize value

See Also:

JDBCTxDataSourceMBean.getRowPrefetchSize()

Default Value:

48

Maximum Value:

65536

Minimum Value:

2

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

setStreamChunkSize

void setStreamChunkSize(int chunk_size)

Deprecated. 

Sets the value of the StreamChunkSize attribute.

Parameters:

chunk_size - The new streamChunkSize value

See Also:

JDBCTxDataSourceMBean.getStreamChunkSize()

Default Value:

256

Maximum Value:

65536

Minimum Value:

1

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 StreamChunkSize sized chunks from the WebLogic Server to the client as needed.

Returns:

The streamChunkSize value