WebLogic Server 6.1 API Reference

weblogic.management.configuration
Interface JDBCMultiPoolMBean

public interface JDBCMultiPoolMBean

extends DeploymentMBean

Relevant only in single-server configurations, JDBC Multipools provide backup pools and load balancing to enhance database connectivity. A MultiPool is a "pool of pools" that allows a configurable algorithm for choosing among its list of pools, the pool that will be selected to provide the connection. MultiPools do not apply to multiple-server configurations.

Author:

Copyright © 2001 BEA Systems, Inc. All Rights Reserved.

Fields inherited from class weblogic.management.configuration.DeploymentMBean

DEFAULT_ORDER, MAX_ORDER, MIN_ORDER

Method Summary

java.lang.String	getACLName() returns the ACL list for this meta pool
java.lang.String	getAlgorithmType() Returns algorithm type for this Multipool.
JDBCConnectionPoolMBean[]	getPoolList() retrieves the list of connection pools in the meta pool
void	setACLName(java.lang.String newACLName) sets the ACL list for this meta pool
void	setAlgorithmType(java.lang.String algorithm) Sets algorithm type for this Multipool.
void	setPoolList(JDBCConnectionPoolMBean[] thePoolList) defines the connection pools in the meta pool

Methods inherited from interface weblogic.management.configuration.DeploymentMBean

addTarget, getDeploymentOrder, getTargets, removeTarget, setDeploymentOrder, setTargets

Methods inherited from interface weblogic.management.configuration.ConfigurationMBean

getNotes, 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, preDeregister, preRegister

Methods inherited from interface javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

Method Detail

getACLName

public java.lang.String getACLName()

returns the ACL list for this meta pool

setACLName

public void setACLName(java.lang.String newACLName)
                throws javax.management.InvalidAttributeValueException

sets the ACL list for this meta pool

getPoolList

public JDBCConnectionPoolMBean[] getPoolList()

retrieves the list of connection pools in the meta pool

setPoolList

public void setPoolList(JDBCConnectionPoolMBean[] thePoolList)
                 throws javax.management.InvalidAttributeValueException

defines the connection pools in the meta pool

setAlgorithmType

public void setAlgorithmType(java.lang.String algorithm)

Sets algorithm type for this Multipool.

If attribute set to "High availability", the connection pools are set up as an ordered list used in order. That is, every time the Multipool is asked for a connection, it tries to get a connection from the first pool in its list. If unable to get a valid connection, it tries the next pool in its list. 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 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.

If attribute set to "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.

Default value for this attribute is "High availability".

Legal Values: weblogic.management.configuration.JDBCLegalHelper.ALGORITHM_HIGH_AVAILABILITY,weblogic.management.configuration.JDBCLegalHelper.ALGORITHM_LOAD_BALANCING

getAlgorithmType

public java.lang.String getAlgorithmType()

Returns algorithm type for this Multipool.

If attribute set to "High availability", the connection pools are set up as an ordered list used in order. That is, every time the Multipool is asked for a connection, it tries to get a connection from the first pool in its list. If unable to get a valid connection, it tries the next pool in its list. 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 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.

If attribute set to "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.

Default value for this attribute is "High availability".

Default Value: weblogic.management.configuration.JDBCLegalHelper.ALGORITHM_HIGH_AVAILABILITY