org.logicalcobwebs.proxool
Interface ConnectionInfoIF

All Superinterfaces:
java.lang.Comparable
All Known Subinterfaces:
ProxyConnectionIF
All Known Implementing Classes:
ProxyConnection

public interface ConnectionInfoIF
extends java.lang.Comparable

Provides information about an individual connection. You can get a collection of these from ProxoolFacade. You get back information about all the connections in a particular pool.

 String alias = "myPool";
 Iterator i = ProxoolFacade.getConnectionInfos(alias).iterator();
 while (i.hasNext()) {
  ConnectionInfoIF c = (ConnectionInfoIF)i.next();
   ...
 }
 

Version:
$Revision: 1.12 $, $Date: 2005/10/07 08:18:23 $
Author:
billhorsman, $Author: billhorsman $ (current maintainer)

Field Summary
static int MARK_FOR_EXPIRY
          The next time this connection is made available we should expire it.
static int MARK_FOR_USE
          Default - treat as normal
static int STATUS_ACTIVE
          The connection is in use
static int STATUS_AVAILABLE
          The connection is available for use
static int STATUS_NULL
          This is the start and end state of every connection
static int STATUS_OFFLINE
          The connection is in use by the house keeping thread
 
Method Summary
 long getAge()
          The age in millseconds since this connection was built
 java.util.Date getBirthDate()
          Like getBirthTime() but in Date format
 long getBirthTime()
          The time that this connection was created.
 java.lang.String getDelegateHashcode()
          The hashcode (in hex) of the delegate connection object.
 java.lang.String getDelegateUrl()
          The URL that this connection is using (the definition might have changed since this connection was built).
 long getId()
          A unique ID for this connection
 int getMark()
          Sometimes we want do something to a connection but can't because it is still active and we don't want to disrupt its use.
 java.lang.String getProxyHashcode()
          The hashcode (in hex) of the ProxyConnection object.
 java.lang.String getRequester()
          The name of the thread that asked for this connection.
 java.lang.String[] getSqlCalls()
          A log of the last SQL used on this connection.
 int getStatus()
          The status of the connection.
 long getTimeLastStartActive()
          When this connection was last given out.
 long getTimeLastStopActive()
          When this connection was last given back (or zero if it is still active).
 
Methods inherited from interface java.lang.Comparable
compareTo
 

Field Detail

MARK_FOR_USE

static final int MARK_FOR_USE
Default - treat as normal

See Also:
getMark(), Constant Field Values

MARK_FOR_EXPIRY

static final int MARK_FOR_EXPIRY
The next time this connection is made available we should expire it.

See Also:
getMark(), Constant Field Values

STATUS_NULL

static final int STATUS_NULL
This is the start and end state of every connection

See Also:
getStatus(), Constant Field Values

STATUS_AVAILABLE

static final int STATUS_AVAILABLE
The connection is available for use

See Also:
getStatus(), Constant Field Values

STATUS_ACTIVE

static final int STATUS_ACTIVE
The connection is in use

See Also:
getStatus(), Constant Field Values

STATUS_OFFLINE

static final int STATUS_OFFLINE
The connection is in use by the house keeping thread

See Also:
getStatus(), Constant Field Values
Method Detail

getBirthTime

long getBirthTime()
The time that this connection was created. The number of milliseconds since midnight, January 1, 1970 UTC.


getBirthDate

java.util.Date getBirthDate()
Like getBirthTime() but in Date format

Returns:
birthDate

getAge

long getAge()
The age in millseconds since this connection was built


getId

long getId()
A unique ID for this connection


getMark

int getMark()
Sometimes we want do something to a connection but can't because it is still active and we don't want to disrupt its use. So we mark it instead and when it stops being active we can perform the necessary operation. The only thing we do at the moment is expire the connection (if it is too old for instance). And this will happen if the housekeeper decides it should but the connection is still active.


getStatus

int getStatus()
The status of the connection. Can be either: null, available, active or offline.


getTimeLastStartActive

long getTimeLastStartActive()
When this connection was last given out. The number of milliseconds since midnight, January 1, 1970 UTC.


getTimeLastStopActive

long getTimeLastStopActive()
When this connection was last given back (or zero if it is still active). The number of milliseconds since midnight, January 1, 1970 UTC.


getRequester

java.lang.String getRequester()
The name of the thread that asked for this connection.


getProxyHashcode

java.lang.String getProxyHashcode()
The hashcode (in hex) of the ProxyConnection object. This uniquely identifies this proxy connection.

Returns:
proxyHashcode

getDelegateHashcode

java.lang.String getDelegateHashcode()
The hashcode (in hex) of the delegate connection object. This uniquely identifies the underlying connection.

Returns:
delegateHashcode

getDelegateUrl

java.lang.String getDelegateUrl()
The URL that this connection is using (the definition might have changed since this connection was built).

Returns:
delegateUrl

getSqlCalls

java.lang.String[] getSqlCalls()
A log of the last SQL used on this connection. Only populated if ConnectionPoolDefinitionIF.isTrace() is enabled.

Returns:
the most recent SQL to be used