com.sap.mdm.net
Class ConnectionPoolFactory

java.lang.Object
  com.sap.mdm.net.ConnectionPoolFactory

public class ConnectionPoolFactory

extends java.lang.Object

This class manages the creation and the access to all connection pools. Each connection pool is tied to a particular MDM server and is identified by a connection tag which encodes its host name and port number.

The factory's static properties are used to set defaults for the connection pools. These defaults may be overridden by modifying each connection pool instance's settings.

The factory maintains a list of connection pool instances. A call to getInstance for the same connection tag will return a previous instance.

Examples of connection tags:
localhost
The MDM server is on the local machine and the default port number of 20005.

MyMachine;40000
The MDM server is on the "MyMachine" and the port number is 40000.

See Also:

SimpleConnectionFactory

Field Summary

static int	DEFAULT_MAX_CONNECTIONS The default maximum number of connections for the connection pool.
static int	DEFAULT_MIN_CONNECTIONS The default minimum number of connections for the connection pool.
static int	NO_TIMEOUT A constant for specifying no timeout.

Method Summary

static ConnectionPool	getInstance(java.lang.String connectionTag) Returns a connection pool instance associated with the MDM server specified by the connection tag.
static ConnectionPool	getInstance(java.lang.String connectionTag, java.lang.String connectionSource) Returns a connection pool instance associated with the MDM server specified by the connection tag.
static int	getMaxConnections() Returns the default value for the maximum number of connections that connection pools may open.
static int	getMinConnections() Returns the default value for the minimum number of connections that connection pools will open upon initialization.
static int	getTimeout() Returns the SO_TIMEOUT
static void	setMaxConnections(int maxConnections) Sets the default value for the maximum number of connections that connection pools may open.
static void	setMinConnections(int minConnections) Sets the default value for the minimum number of connections that connection pools will open upon initialization.
static void	setTimeout(int timeout) Sets the SO_TIMEOUT.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NO_TIMEOUT

public static final int NO_TIMEOUT

A constant for specifying no timeout.

See Also:

Constant Field Values

DEFAULT_MIN_CONNECTIONS

public static final int DEFAULT_MIN_CONNECTIONS

The default minimum number of connections for the connection pool.

See Also:

Constant Field Values

DEFAULT_MAX_CONNECTIONS

public static final int DEFAULT_MAX_CONNECTIONS

The default maximum number of connections for the connection pool.

See Also:

Constant Field Values

Method Detail

getInstance

public static ConnectionPool getInstance(java.lang.String connectionTag)
                                  throws ConnectionException

Returns a connection pool instance associated with the MDM server specified by the connection tag.

Parameters:

connectionTag - the connection tag encoding the host name and the port number

Returns:

the connection pool

Throws:

ConnectionException - if not able to create a connection to the MDM server

getInstance

public static ConnectionPool getInstance(java.lang.String connectionTag,
                                         java.lang.String connectionSource)
                                  throws ConnectionException

Returns a connection pool instance associated with the MDM server specified by the connection tag. A set of connections can be logically grouped by giving it the same connect source identifier.

Parameters:

connectionTag - the connection tag encoding the host name and the port number

connectionSource - the connection source identifier

Returns:

the connection pool

Throws:

ConnectionException - if not able to create a connection to the MDM server

getMinConnections

public static int getMinConnections()

Returns the default value for the minimum number of connections that connection pools will open upon initialization.

Returns:

the minimum number of connections

setMinConnections

public static void setMinConnections(int minConnections)

Sets the default value for the minimum number of connections that connection pools will open upon initialization. This setting may be overridden on the connection pool itself.

Parameters:

minConnections - the minimum number of connections

getMaxConnections

public static int getMaxConnections()

Returns the default value for the maximum number of connections that connection pools may open.

Returns:

the maximum number of connections

setMaxConnections

public static void setMaxConnections(int maxConnections)

Sets the default value for the maximum number of connections that connection pools may open.

Parameters:

maxConnections - the maximum number of connections

setTimeout

public static void setTimeout(int timeout)

Sets the SO_TIMEOUT.

Parameters:

timeout - the timeout in milliseconds

See Also:

java.net.Socket

getTimeout

public static int getTimeout()

Returns the SO_TIMEOUT

Returns:

the timeout