|
BEA Systems, Inc. | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This MBean defines a transaction-enabled JDBC DataSource.
Field Summary | |
static long |
CACHING_STUB_SVUID
|
Fields inherited from class weblogic.management.configuration.DeploymentMBean |
CACHING_STUB_SVUID,
DEFAULT_ORDER,
MAX_ORDER,
MIN_ORDER |
Fields inherited from class weblogic.management.configuration.ConfigurationMBean |
CACHING_STUB_SVUID,
DEFAULT_EMPTY_BYTE_ARRAY |
Method Summary | |
boolean |
getEnableTwoPhaseCommit()
When set to true, this attribute allows non-XA JDBC drivers to emulate participation in distributed transactions using JTA. |
java.lang.String |
getJNDIName()
The JNDI path to where this TxDataSource is bound. |
java.lang.String |
getJNDINameSeparator()
The JNDI Seperator is used to seperate JNDIName list for this TxDataSource. |
java.lang.String |
getPoolName()
The name of the JDBC connection pool that is associated with this TxDataSource. |
int |
getRowPrefetchSize()
Gets the rowPrefetchSize attribute of the JDBCTxDataSourceMBean object |
int |
getStreamChunkSize()
Gets the streamChunkSize attribute of the JDBCTxDataSourceMBean object |
boolean |
isRowPrefetchEnabled()
Controls row prefetching between a client and WebLogic Server for each ResultSet. |
void |
setEnableTwoPhaseCommit(boolean enable)
When set to true, this attribute allows non-XA JDBC drivers to emulate distributed transactions using JTA. |
void |
setJNDIName(java.lang.String name)
Sets the JNDI path to where this TxDataSource is bound. |
void |
setJNDINameSeparator(java.lang.String name)
Sets the Separator used for list of different JNDINames for this TxDataSource. |
void |
setPoolName(java.lang.String pool)
Sets the name of the JDBC connection pool that is associated with this TxDataSource. |
void |
setRowPrefetchEnabled(boolean enable)
Set to true to enable row prefetching between client and WebLogic Server for each ResultSet. |
void |
setRowPrefetchSize(int prefetch)
The number of result set rows to prefetch for a client. |
void |
setStreamChunkSize(int chunk_size)
Data chunk size for steaming datatypes. |
Methods inherited from interface weblogic.management.configuration.DeploymentMBean |
addTarget,
getDeploymentOrder,
getTargets,
removeTarget,
setDeploymentOrder,
setTargets |
Methods inherited from interface weblogic.management.configuration.ConfigurationMBean |
freezeCurrentValue,
getNotes,
restoreDefaultValue,
setComments,
setDefaultedMBean,
setNotes,
setPersistenceEnabled |
Methods inherited from interface weblogic.management.WebLogicMBean |
getMBeanInfo,
getName,
getObjectName,
getParent,
getType,
isCachingDisabled,
isRegistered,
setName,
setParent |
Methods inherited from interface javax.management.DynamicMBean |
getAttribute,
getAttributes,
invoke,
setAttribute,
setAttributes |
Methods inherited from interface javax.management.MBeanRegistration |
postDeregister,
postRegister,
preRegister |
Methods inherited from interface javax.management.NotificationBroadcaster |
addNotificationListener,
getNotificationInfo,
removeNotificationListener |
Field Detail |
public static final long CACHING_STUB_SVUID
Method Detail |
public java.lang.String getJNDIName()
Applications that look up the JNDI path will get a
javax.sql.DataSource
instance that corresponds to
this DataSource.
public void setJNDIName(java.lang.String name) throws javax.management.InvalidAttributeValueException
javax.sql.DataSource
instance that corresponds to
this TxDataSource. Note that the old style usage of
DriverManager.getConnection() or Driver.connect() has been
deprecated in favor of looking up a datasource to obtain a
connection.
name
- The new jNDIName valuepublic java.lang.String getJNDINameSeparator()
Applications that look up the JNDI path will get a
javax.sql.DataSource
instance that corresponds to
this DataSource.
public void setJNDINameSeparator(java.lang.String name) throws javax.management.InvalidAttributeValueException
javax.sql.DataSource
instance that corresponds to
this DataSource.
name
- The new jNDINameSeparator valuepublic java.lang.String getPoolName()
Calls from applications to
getConnection()
on this TxDataSource will return
a connection from the associated connection pool.
public void setPoolName(java.lang.String pool) throws javax.management.InvalidAttributeValueException
getConnection()
on this
TxDataSource will return a connection from the associated
connection pool.
pool
- The new poolName valueJDBCConnectionPoolMBean
public boolean getEnableTwoPhaseCommit()
Use this option if the JDBC connection is the only participant in the transaction and 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.
If this TxDataSource is associated with an XA connection pool, or if there is only one resource participating in the distributed transaction, then this setting is ignored.
setEnableTwoPhaseCommit(boolean enable)
public void setEnableTwoPhaseCommit(boolean enable) throws javax.management.InvalidAttributeValueException
The drivers are wrapped with a pseudo XAResource, which returns true during prepare(). This is fine if the JDBC connection is the only participant in the transaction, but it is asking for trouble to have more than one resource participating in a transaction where one of them (the JDBC driver) is pretending to be an XA resource. There is a possibility of heuristic failures in such a situation. setEnableTwoPhaseCommit(true) should be used only if you have no option (no decent XA driver available for a particular database, for example).
If this TxDataSource is associated with an XA connection pool, or if there is only one resource participating in the distributed transaction, then this setting is ignored.
enable
- The new enableTwoPhaseCommit valuepublic boolean isRowPrefetchEnabled()
public void setRowPrefetchEnabled(boolean enable)
enable
- The new rowPrefetchEnabled valuepublic void setRowPrefetchSize(int prefetch)
prefetch
- The new rowPrefetchSize valuepublic int getRowPrefetchSize()
public void setStreamChunkSize(int chunk_size)
getBinaryStream()
)
will be pulled in StreamChunkSize sized chunks from the WebLogic
Server to the client as needed.
chunk_size
- The new streamChunkSize valuepublic int getStreamChunkSize()
|
Documentation is available at http://download.oracle.com/docs/cd/E13222_01/wls/docs81 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |