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

      Fields 
      Modifier and Type Field Description
      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

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      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
    • 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.
      • 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