SettableBeanpublic interface JDBCDataSourceParamsBean extends SettableBean
Configuration parameters for the basic usage of a data source are specified using a data source parameters bean.
| Modifier and Type | Method | Description |
|---|---|---|
void |
addJNDIName(java.lang.String jndiName) |
Used to specify additional JNDI names for the Data Source.
|
java.lang.String |
getAlgorithmType() |
The algorithm
determines the connection request processing for the multi data
source.
|
java.lang.String |
getConnectionPoolFailoverCallbackHandler() |
The name of the application class to handle the callback sent
when a multi data source is ready to failover or fail back
connection requests to another data source within the multi data
source.
|
java.lang.String |
getDataSourceList() |
The list of data sources to which the multi data source will
route connection requests.
|
java.lang.String |
getGlobalTransactionsProtocol() |
Determines the transaction protocol (global transaction
processing behavior) for the data source.
|
java.lang.String[] |
getJNDINames() |
The JNDI path for this Data Source.
|
java.lang.String |
getProxySwitchingCallback() |
The name of the switching callback class for a Proxy data source.
|
java.lang.String |
getProxySwitchingProperties() |
Specifies the switching properties passed to the
switching callback method for a Proxy data source.
|
int |
getRowPrefetchSize() |
Deprecated.
12.2.1.0.0
|
java.lang.String |
getScope() |
Specifies the scoping of the data source.
|
int |
getStreamChunkSize() |
Deprecated.
12.2.1.0.0
|
boolean |
isFailoverRequestIfBusy() |
For multi data sources with the
failover algorithm,
enables the multi data source to failover connection requests to
the next data source if all connections in the current data source
are in use. |
boolean |
isKeepConnAfterGlobalTx() |
Enables WebLogic Server to keep the physical
database connection associated with the logical connection
when committing a global transaction instead releasing it
and getting another physical connection when needed.
|
boolean |
isKeepConnAfterLocalTx() |
Deprecated.
10.3.4.0
|
boolean |
isRowPrefetch() |
Deprecated.
12.2.1.0.0
|
void |
removeJNDIName(java.lang.String jndiName) |
|
void |
setAlgorithmType(java.lang.String algorithmType) |
|
void |
setConnectionPoolFailoverCallbackHandler(java.lang.String connectionPoolFailoverCallbackHandler) |
|
void |
setDataSourceList(java.lang.String dataSourceList) |
|
void |
setFailoverRequestIfBusy(boolean failoverRequestIfBusy) |
|
void |
setGlobalTransactionsProtocol(java.lang.String globalTransactionsProtocol) |
|
void |
setJNDINames(java.lang.String[] jndiNames) |
|
void |
setKeepConnAfterGlobalTx(boolean keepConnAfterGlobalTx) |
|
void |
setKeepConnAfterLocalTx(boolean keepConnAfterLocalTx) |
Deprecated.
10.3.4.0
|
void |
setProxySwitchingCallback(java.lang.String proxySwitchingCallback) |
|
void |
setProxySwitchingProperties(java.lang.String proxySwitchingProperties) |
|
void |
setRowPrefetch(boolean rowPrefetch) |
Deprecated.
12.2.1.0.0
|
void |
setRowPrefetchSize(int rowPrefetchSize) |
Deprecated.
12.2.1.0.0
|
void |
setScope(java.lang.String scope) |
|
void |
setStreamChunkSize(int streamChunkSize) |
Deprecated.
12.2.1.0.0
|
java.lang.String[] getJNDINames()
The JNDI path for this Data Source. By default, the JNDI name is the name of the data source.
Applications that look up the JNDI path get a
javax.sql.DataSource instance that corresponds to this
data source.
void setJNDINames(java.lang.String[] jndiNames)
void addJNDIName(java.lang.String jndiName)
Used to specify additional JNDI names for the Data Source. WebLogic Server internally defaults the JNDI name to the name of the data source bean.
jndiName - void removeJNDIName(java.lang.String jndiName)
jndiName - java.lang.String getScope()
Specifies the scoping of the data source.
You can specify one of the following scopes:
Specifies that the data source is bound in the cluster-wide JNDI tree with the JNDIName specified so that the data source is available for use to any JDBC client across the cluster.
This is the default setting.
Specifies that the data source is bound in the application's local namespace with the JNDIName specified so that the data source is available for use only by JDBC clients within the application. This can only be used for packaged datasources and is ignored for JDBC System resources.
void setScope(java.lang.String scope)
@Deprecated boolean isRowPrefetch()
Enables multiple rows to be "prefetched" (that is, sent from the server to the client) in one server access.
This parameter applies only to the deprecated JDBC over RMI.
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.
@Deprecated void setRowPrefetch(boolean rowPrefetch)
@Deprecated int getRowPrefetchSize()
If row prefetching is enabled, specifies the number of result set rows to prefetch for a client.
This parameter applies only to the deprecated JDBC over RMI.
The optimal prefetch size 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.
@Deprecated void setRowPrefetchSize(int rowPrefetchSize)
@Deprecated int getStreamChunkSize()
Specifies the data chunk size for steaming data types.
This parameter applies only to the deprecated JDBC over RMI.
Streaming data types (for example resulting from a call to
getBinaryStream()) are sent in sized chunks from
WebLogic Server to the client as needed.
@Deprecated void setStreamChunkSize(int streamChunkSize)
java.lang.String getAlgorithmType()
The algorithm determines the connection request processing for the multi data source.
You can specify one of the following algorithm types:
Connection requests are sent to the first data source in the list; if the request fails, the request is sent to the next data source in the list, and so forth. The process is repeated until a valid connection is obtained, or until the end of the list is reached, in which case an exception is thrown.
The multi data source distributes connection requests evenly to its member data sources. With this algorithm, the multi data source also provides failover processing. That is, if a request fails, the multi data source sends the request to the next data source in the list until a valid connection is obtained, or until the end of the list is reached, in which case an exception is thrown.
void setAlgorithmType(java.lang.String algorithmType)
java.lang.String getDataSourceList()
The list of data sources to which the multi data source will route connection requests. The order of data sources in the list determines the failover order.
void setDataSourceList(java.lang.String dataSourceList)
java.lang.String getConnectionPoolFailoverCallbackHandler()
The name of the application class to handle the callback sent when a multi data source is ready to failover or fail back connection requests to another data source within the multi data source.
The name must be the absolute name of an application class that
implements the
weblogic.jdbc.extensions.ConnectionPoolFailoverCallback
interface.
ConnectionPoolFailoverCallbackvoid setConnectionPoolFailoverCallbackHandler(java.lang.String connectionPoolFailoverCallbackHandler)
boolean isFailoverRequestIfBusy()
For multi data sources with the failover algorithm,
enables the multi data source to failover connection requests to
the next data source if all connections in the current data source
are in use.
void setFailoverRequestIfBusy(boolean failoverRequestIfBusy)
java.lang.String getGlobalTransactionsProtocol()
Determines the transaction protocol (global transaction processing behavior) for the data source. Options include:
TwoPhaseCommit - Standard XA transaction processing. Requires an XA driver.
LoggingLastResource - A performance enhancement for one non-XA resource.
EmulateTwoPhaseCommit - Enables one non-XA resource to participate in a global transaction, but has some risk to data.
OnePhaseCommit - One-phase XA transaction processing using a non-XA driver. This is the default setting.
None - Support for local transactions only.
void setGlobalTransactionsProtocol(java.lang.String globalTransactionsProtocol)
@Deprecated boolean isKeepConnAfterLocalTx()
Enables WebLogic Server to keep the physical database connection associated with the logical connection when committing a local transaction instead releasing it and getting another physical connection when needed.
Setting this option to true may require additional connections to be configured on the database.
Use this setting to work around specific problems with JDBC XA drivers.
@Deprecated void setKeepConnAfterLocalTx(boolean keepConnAfterLocalTx)
boolean isKeepConnAfterGlobalTx()
Enables WebLogic Server to keep the physical database connection associated with the logical connection when committing a global transaction instead releasing it and getting another physical connection when needed.
Setting this option to true may require additional connections to be configured on the database.
Use this setting to work around specific problems with JDBC XA drivers.
void setKeepConnAfterGlobalTx(boolean keepConnAfterGlobalTx)
java.lang.String getProxySwitchingCallback()
The name of the switching callback class for a Proxy data source.
This class implements the
weblogic.jdbc.extensions.DataSourceSwitchingCallback
interface.
weblogic.jdbc.extensions.DataSourceSwitchingCallbackvoid setProxySwitchingCallback(java.lang.String proxySwitchingCallback)
java.lang.String getProxySwitchingProperties()
weblogic.jdbc.extensions.DataSourceSwitchingCallbackvoid setProxySwitchingProperties(java.lang.String proxySwitchingProperties)