|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.ibm.mq.MQSimpleConnectionManager
An MQSimpleConnectionManager provides basic connection pooling function. You can use an MQSimpleConnectionManager either as the default connection manager, or as a parameter to an MQQueueManager constructor. When an MQQueueManager is constructed, the most recently used connection in the pool is used. Connections are destroyed by a separate thread when they are unused for a specified period, when there are more than a specified number of unused connections in the pool, or when the maximum number of connections has been reached and room must be made for new connections. You can specify the timeout period, the maximum number of managed connections, and the maximum number of unused connections.
Field Summary | |
static int |
MODE_ACTIVE
The pool is always active. |
static int |
MODE_AUTO
An MQSimpleConnectionManager is active if it is the default connection manager and there is at least one connection in the pool. |
static int |
MODE_INACTIVE
The pool is always inactive. |
Constructor Summary | |
MQSimpleConnectionManager()
Constructs an MQSimpleConnectionManager. |
Method Summary | |
java.lang.Object |
allocateConnection(com.ibm.mq.MQManagedConnectionFactory mcf,
javax.resource.spi.ConnectionRequestInfo cxRequestInfo)
Makes a connection to a queue manager, either by reusing an existing connection or by creating a new one. |
java.lang.Object |
createConnection(com.ibm.mq.MQManagedConnectionFactory mcf,
javax.resource.spi.ConnectionRequestInfo cxRequestInfo)
Makes a connection to a queue manager. |
int |
getActive()
Gets the active mode of the pool. |
int |
getHighThreshold()
Deprecated. use getMaxUnusedConnections() instead. |
int |
getMaxConnections()
Gets the maximum number of connections. |
int |
getMaxUnusedConnections()
Gets the maximum number of unused connections in the pool. |
long |
getTimeout()
Gets the timeout value. |
java.lang.Object |
recycleConnection(com.ibm.mq.MQManagedConnectionFactory mcf,
javax.resource.spi.ConnectionRequestInfo cxRequestInfo)
Finds an existing connection to a queue manager. |
void |
setActive(int mode)
Sets the active mode of the pool. |
void |
setHighThreshold(int limit)
Deprecated. use setMaxUnusedConnections() instead. |
void |
setMaxConnections(int newLimit)
Sets the maximum number of connections. |
void |
setMaxUnusedConnections(int limit)
Sets the maximum number of unused connections in the pool. |
void |
setTimeout(long timeout)
Sets the timeout value. |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final int MODE_AUTO
This is the default mode.
public static final int MODE_ACTIVE
MQQueueManager.disconnect()
, the underlying connection
is pooled and can be reused the next time an MQQueueManager object is constructed.
Connections are destroyed by a separate thread if they have been unused for longer then the
timeout period or if the size of the pool exceeds the value set by setMaxUnusedConnections()
.
public static final int MODE_INACTIVE
MQQueueManager.disconnect()
is called.
Constructor Detail |
public MQSimpleConnectionManager()
Method Detail |
public java.lang.Object allocateConnection(com.ibm.mq.MQManagedConnectionFactory mcf, javax.resource.spi.ConnectionRequestInfo cxRequestInfo) throws javax.resource.ResourceException
Normal applications should not call this method.
allocateConnection
in interface com.ibm.mq.MQConnectionManager
mcf
- the connection factory.cxRequestInfo
- represents information specific to the resource adapter for
handling the connection request.
javax.resource.ResourceException
- if the call fails.public java.lang.Object recycleConnection(com.ibm.mq.MQManagedConnectionFactory mcf, javax.resource.spi.ConnectionRequestInfo cxRequestInfo)
Normal applications should not call this method.
mcf
- the connection factory.cxRequestInfo
- represents information specific to the resource adapter for
handling the connection request.
public java.lang.Object createConnection(com.ibm.mq.MQManagedConnectionFactory mcf, javax.resource.spi.ConnectionRequestInfo cxRequestInfo) throws javax.resource.ResourceException
Normal applications should not call this method.
mcf
- the connection factory.cxRequestInfo
- represents information specific to the resource adapter for
handling the connection request.
javax.resource.ResourceException
- if the call fails.public void setActive(int mode)
mode
- one of:
public int getActive()
public void setTimeout(long timeout)
timeout
- the time out value in milliseconds.
Connections which
have been unused for this length of time are destroyed.public long getTimeout()
public void setMaxUnusedConnections(int limit)
limit
- recently used connections are destroyed if the size of the pool exceeds this
value.public void setHighThreshold(int limit)
setMaxUnusedConnections()
instead.
limit
- public int getMaxUnusedConnections()
public int getHighThreshold()
getMaxUnusedConnections()
instead.
public void setMaxConnections(int newLimit) throws java.lang.IllegalArgumentException
newLimit
- the new maximum number of connections.
java.lang.IllegalArgumentException
public int getMaxConnections()
|
(c) Copyright IBM Corp. 2005. All Rights Reserved. | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |