Oracle Fusion Middleware
Oracle WebLogic Server MBean Javadoc
11g Release 1 (10.3.6)

Part Number E13945-06

weblogic.management.configuration
Interface JDBCTxDataSourceMBean

All Superinterfaces:
ConfigurationMBean, DeploymentMBean

Deprecated. 9.0.0.0 Replaced by JDBCSystemResourceMBean

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

Field Summary
 
Fields inherited from interface weblogic.management.configuration.DeploymentMBean
DEFAULT_ORDER, MAX_ORDER, MIN_ORDER
 
Fields inherited from interface weblogic.management.configuration.ConfigurationMBean
DEFAULT_EMPTY_BYTE_ARRAY
 
Method Summary
 boolean getEnableTwoPhaseCommit()
          Deprecated. Specifies whether the JDBC resource will emulate participation in a global transaction.
 String getJNDIName()
          Deprecated. The JNDI path to where this JDBC Data Source is bound.
 String getJNDINameSeparator()
          Deprecated. The JNDI Seperator is used to seperate JNDIName list for this TxDataSource.
 String getPoolName()
          Deprecated. The PoolName attribute applies to legacy data source configurations only.
 int getRowPrefetchSize()
          Deprecated. Specifies the number of result set rows to prefetch for a client.
 int getStreamChunkSize()
          Deprecated. Specifies the data chunk size for steaming data types.
 boolean isRowPrefetchEnabled()
          Deprecated. Specifies whether multiple rows should be "prefetched" (that is, sent from the server to the client) in one server access.
 void setEnableTwoPhaseCommit(boolean enable)
          Deprecated. Sets the value of the EnableTwoPhaseCommit attribute.
 void setJNDIName(String name)
          Deprecated. Sets the value of the JNDIName attribute.
 void setJNDINameSeparator(String name)
          Deprecated. Sets the Separator used for list of different JNDINames for this TxDataSource.
 void setPoolName(String pool)
          Deprecated. Sets the value of the PoolName attribute.
 void setRowPrefetchEnabled(boolean enable)
          Deprecated. Sets the value of the RowPrefetchEnabled attribute.
 void setRowPrefetchSize(int prefetch)
          Deprecated. Sets the value of the RowPrefetchSize attribute.
 void setStreamChunkSize(int chunk_size)
          Deprecated. Sets the value of the StreamChunkSize attribute.
 
Methods inherited from interface weblogic.management.configuration.DeploymentMBean
addTarget, getDeploymentOrder, getTargets, removeTarget, setDeploymentOrder, setTargets
 
Methods inherited from interface weblogic.management.configuration.ConfigurationMBean
freezeCurrentValue, getName, getNotes, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet
 

Method Detail

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

Copyright 1996, 2011, 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 MBean Javadoc
11g Release 1 (10.3.6)

Part Number E13945-06