weblogic.management.configuration
Interface JDBCMultiPoolMBean

All Superinterfaces:

ConfigurationMBean, DeploymentMBean

public interface JDBCMultiPoolMBean
extends DeploymentMBean

This MBean represents a JDBC Multipool, which is a pool of JDBC connection pools.

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

getACLName

String getACLName()

Deprecated. 

The access control list (ACL) used to control access to this MultiPool.

Returns:

The aCLName value

setACLName

void setACLName(String newACLName)
                throws InvalidAttributeValueException

Deprecated. 

Sets the value of the ACLName attribute.

Parameters:

newACLName - The new aCLName value

Throws:

InvalidAttributeValueException

See Also:

JDBCMultiPoolMBean.getACLName()

getPoolList

JDBCConnectionPoolMBean[] getPoolList()

Deprecated. 

The list of connection pools in the MultiPool.

Returns:

The poolList value

setPoolList

void setPoolList(JDBCConnectionPoolMBean[] thePoolList)
                 throws InvalidAttributeValueException

Deprecated. 

Sets the value of the PoolList attribute.

Parameters:

thePoolList - The new poolList value

Throws:

InvalidAttributeValueException

See Also:

JDBCMultiPoolMBean.getPoolList()

setAlgorithmType

void setAlgorithmType(String algorithm)

Deprecated. 

Sets the value of the AlgorithmType attribute.

Parameters:

algorithm - The new algorithmType value

See Also:

JDBCMultiPoolMBean.getAlgorithmType()

Valid Values:

JDBCLegalHelper.ALGORITHM_HIGH_AVAILABILITY, JDBCLegalHelper.ALGORITHM_LOAD_BALANCING, JDBCLegalHelper.ALGORITHM_FAILOVER

getAlgorithmType

String getAlgorithmType()

Deprecated. 

The algorithm type for this Multipool.

Multipools support the following algorithm types:

• High availability

  Connection requests are sent to the first connection pool in the list; if the request fails, the request is sent to the next connection pool 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 will be thrown.

  Note that unless FailoverRequestIfBusy="true", the Multipool will only move to the next pool in the list when there is a real problem with the pool, for example the database is down or the pool disabled. For the cases where all connections are busy, the Multipool behaves as a single pool and an exception is thrown.

• Load balancing

  The Multipool will distribute the connection requests evenly to its member pools. This algorithm also performs the same failover behavior as the high availability algorithm.

Returns:

The algorithmType value

See Also:

JDBCMultiPoolMBean.getFailoverRequestIfBusy()

Default Value:

JDBCLegalHelper.ALGORITHM_HIGH_AVAILABILITY

getConnectionPoolFailoverCallbackHandler

String getConnectionPoolFailoverCallbackHandler()

Deprecated. 

Returns the current value of connectionPoolFailoverCallbackHandler

See Also:

weblogic.jdbc.extensions.ConnectionPoolFailoverCallback

Default Value:

null

setConnectionPoolFailoverCallbackHandler

void setConnectionPoolFailoverCallbackHandler(String className)

Deprecated. 

Used to set the absolute name of the application class that implements the interface weblogic.jdbc.extensions.ConnectionPoolFailoverCallback.

See Also:

weblogic.jdbc.extensions.ConnectionPoolFailoverCallback

setFailoverRequestIfBusy

void setFailoverRequestIfBusy(boolean newVal)

Deprecated. 

Sets the failoverRequestIfBusy value.

Parameters:

newVal - The new attribute value

See Also:

JDBCMultiPoolMBean.getFailoverRequestIfBusy()

Changes take effect after you redeploy the module or restart the server.

getFailoverRequestIfBusy

boolean getFailoverRequestIfBusy()

Deprecated. 

If enabled, application requests for connections will be routed to alternate pools if current pool is busy. This is only relevant when running with the HIGH_ALGORITHM algorithm. Default implies feature is disabled.

Default Value:

false

setHealthCheckFrequencySeconds

void setHealthCheckFrequencySeconds(int newVal)

Deprecated. 

The frequency at which the MultiPool checks the health of connection pools that were previously found to be dead and were consequently disabled. The maximum value that can be passed to the method is MAXINT while the minimum value is 0. Note that setting the value to zero disables the attribute.

Parameters:

newVal - The new attribute value

Changes take effect after you redeploy the module or restart the server.

getHealthCheckFrequencySeconds

int getHealthCheckFrequencySeconds()

Deprecated. 

Returns the current value of healthCheckFrequencySeconds

Default Value:

300