org.postgresql.quickautobalance

Class Cluster

java.lang.Object

org.postgresql.quickautobalance.Cluster

public class Cluster
extends Object

A Cluster, which cached the information of the dataNodes in this cluster.

Constructor Summary

Constructors

Constructor and Description
Cluster(String urlIdentifier, Properties properties)

Method Summary

Modifier and Type	Method and Description
int	checkClusterState() Check each data nodes' validity of cluster, use cached properties to tryConnect to each data nodes, if cached properties is invalid, remove cached properties, if state change to valid from invalid, quick load balancing start, if state change to invalid from valid, clear cached connections of this node.
List<Integer>	checkConnectionsValidity() Check cached connections validity, and remove invalid connections.
boolean	checkDnState(HostSpec hostSpec) Check dn state by cached properties, and remove invalid properties.
int	closeConnections() Close connections from abandonedConnectionList.
int	decrementCachedCreatingConnectionSize(HostSpec hostSpec) CacheCreatingConnectionNum - 1;
boolean	equals(Object o)
int	getCachedConnectionSize() Get cached connection size.
ConnectionInfo	getConnectionInfo(PgConnection connection) Get connection info of the connection if exists.
int	getMinReservedConPerCluster() Get minReservedConPerCluster.
int	getMinReservedConPerDatanode() Get minReservedConPerDatanode.
int	hashCode()
int	incrementCachedCreatingConnectionSize(HostSpec hostSpec) CachedCreatingConnection + 1
boolean	isEnableMinReservedConPerCluster() Get enableMinReservedConPerCluster.
boolean	isEnableMinReservedConPerDatanode() Get enableMInReservedConPerDatanode.
static int	parseMinReservedConPerCluster(Properties properties) Parse minReservedConPerCluster, value range: [0, 100].
static int	parseMinReservedConPerDatanode(Properties properties) Parse minReservedConPerDatanode, value range: [0, 100].
void	setConnection(PgConnection pgConnection, Properties properties) Add a new connection.
void	setConnectionState(PgConnection pgConnection, StatementCancelState state) set connection state of cached connections if it exists.
void	setProperties(Properties properties) Set new properties if the user doesn't exist in cachedPropertiesList, or update properties if exists.
List<HostSpec>	sortDnsByLeastConn(List<HostSpec> hostSpecs) Sort hostSpec list in ascending order by amount of connections.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Cluster

public Cluster(String urlIdentifier,
               Properties properties)
        throws PSQLException

Throws:

PSQLException

Method Detail

setConnectionState

public void setConnectionState(PgConnection pgConnection,
                               StatementCancelState state)

set connection state of cached connections if it exists.

Parameters:

pgConnection - pgConnection

state - new state

setConnection

public void setConnection(PgConnection pgConnection,
                          Properties properties)
                   throws PSQLException

Add a new connection.

Parameters:

pgConnection - pgConnection

properties - properties

Throws:

PSQLException

setProperties

public void setProperties(Properties properties)

Set new properties if the user doesn't exist in cachedPropertiesList, or update properties if exists.

Parameters:

properties - properties

decrementCachedCreatingConnectionSize

public int decrementCachedCreatingConnectionSize(HostSpec hostSpec)

CacheCreatingConnectionNum - 1;

Parameters:

hostSpec - hostSpec

Returns:

cachedCreatingConnectionNum

parseMinReservedConPerCluster

public static int parseMinReservedConPerCluster(Properties properties)
                                         throws PSQLException

Parse minReservedConPerCluster, value range: [0, 100]. return -1 if minReservedConPerCluster isn't configured.

Parameters:

properties - properties

Returns:

minReservedConPerCluster

Throws:

PSQLException - minReservedConPerCluster parse failed

parseMinReservedConPerDatanode

public static int parseMinReservedConPerDatanode(Properties properties)
                                          throws PSQLException

Parse minReservedConPerDatanode, value range: [0, 100]. return -1 if minReservedConPerDatanode isn't configured.

Parameters:

properties - properties

Returns:

minReservedConPerDatanode

Throws:

PSQLException - minReservedConPerDatanode parse failed

getConnectionInfo

public ConnectionInfo getConnectionInfo(PgConnection connection)

Get connection info of the connection if exists.

Parameters:

connection - connection

Returns:

connection info

sortDnsByLeastConn

public List<HostSpec> sortDnsByLeastConn(List<HostSpec> hostSpecs)

Sort hostSpec list in ascending order by amount of connections. Put the hostSpec to the tail, if dataNodeState = false.

Parameters:

hostSpecs - host specs

Returns:

hostSpec list

checkClusterState

public int checkClusterState()

Check each data nodes' validity of cluster, use cached properties to tryConnect to each data nodes, if cached properties is invalid, remove cached properties, if state change to valid from invalid, quick load balancing start, if state change to invalid from valid, clear cached connections of this node.

Returns:

the number of invalid data nodes

checkDnState

public boolean checkDnState(HostSpec hostSpec)

Check dn state by cached properties, and remove invalid properties.

Parameters:

hostSpec - hostSpec

Returns:

state of the date node

checkConnectionsValidity

public List<Integer> checkConnectionsValidity()

Check cached connections validity, and remove invalid connections.

Returns:

the amount of removed connections of each dn.

incrementCachedCreatingConnectionSize

public int incrementCachedCreatingConnectionSize(HostSpec hostSpec)

CachedCreatingConnection + 1

Parameters:

hostSpec - hostSpec

Returns:

cachedCreatingConnection

getMinReservedConPerCluster

public int getMinReservedConPerCluster()

Get minReservedConPerCluster.

Returns:

minReservedConPerCluster

isEnableMinReservedConPerCluster

public boolean isEnableMinReservedConPerCluster()

Get enableMinReservedConPerCluster.

Returns:

enableMinReservedConPerCluster

getMinReservedConPerDatanode

public int getMinReservedConPerDatanode()

Get minReservedConPerDatanode.

Returns:

minReservedConPerDatanode

isEnableMinReservedConPerDatanode

public boolean isEnableMinReservedConPerDatanode()

Get enableMInReservedConPerDatanode.

Returns:

enableMInReservedConPerDatanode

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

closeConnections

public int closeConnections()

Close connections from abandonedConnectionList. Jdbc will continue to pop connections from abandonedConnectionList and determine whether each connection can be closed. If it does, the connection will be close. If it does not, the connection won't be put back into abandonedConnectionList. The number of connections closed at each cluster for each scheduled task at most: 20% * totalAbandonedConnectionSize.

Returns:

the number of connections which are closed

getCachedConnectionSize

public int getCachedConnectionSize()

Get cached connection size.

Returns:

cachedConnectionSize