Module org.eclipse.jetty.client
Package org.eclipse.jetty.client

Class AbstractConnectionPool

  • All Implemented Interfaces:
    java.io.Closeable, java.lang.AutoCloseable, ConnectionPool, org.eclipse.jetty.util.component.Container, org.eclipse.jetty.util.component.Destroyable, org.eclipse.jetty.util.component.Dumpable, org.eclipse.jetty.util.component.Dumpable.DumpableContainer, org.eclipse.jetty.util.component.LifeCycle, org.eclipse.jetty.util.thread.Sweeper.Sweepable
    Direct Known Subclasses:
    DuplexConnectionPool, MultiplexConnectionPool
    @ManagedObject
public abstract class AbstractConnectionPool
extends org.eclipse.jetty.util.component.ContainerLifeCycle
implements ConnectionPool, org.eclipse.jetty.util.component.Dumpable, org.eclipse.jetty.util.thread.Sweeper.Sweepable

    • Nested Class Summary

      • Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

        org.eclipse.jetty.util.component.AbstractLifeCycle.AbstractLifeCycleListener, org.eclipse.jetty.util.component.AbstractLifeCycle.StopException

      • Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

        org.eclipse.jetty.util.component.Container.InheritedListener, org.eclipse.jetty.util.component.Container.Listener

      • Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Dumpable

        org.eclipse.jetty.util.component.Dumpable.DumpableContainer

      • Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

        org.eclipse.jetty.util.component.LifeCycle.Listener

    • Field Summary

      • Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

        FAILED, STARTED, STARTING, STOPPED, STOPPING

      • Fields inherited from interface org.eclipse.jetty.util.component.Dumpable

        KEY

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean accept​(Connection connection)
      Accepts the given connection to be managed by this ConnectionPool.
      Connection acquire​(boolean create)
      Returns an idle connection, if available; if an idle connection is not available, and the given create parameter is true or isMaximizeConnections() is true, then schedules the opening of a new connection, if possible within the configuration of this connection pool (for example, if it does not exceed the max connection count); otherwise returns null.
      protected void acquired​(Connection connection)  
      protected Connection activate()  
      void close()  
      protected boolean deactivate​(Connection connection)  
      protected void doStop()  
      void dump​(java.lang.Appendable out, java.lang.String indent)  
      int getActiveConnectionCount()  
      int getConnectionCount()  
      int getIdleConnectionCount()  
      int getMaxConnectionCount()  
      protected int getMaxMultiplex()  
      protected int getMaxUsageCount()  
      int getPendingConnectionCount()  
      protected boolean idle​(Connection connection, boolean close)  
      boolean isActive​(Connection connection)  
      boolean isClosed()  
      boolean isEmpty()  
      boolean isMaximizeConnections()  
      protected void onCreated​(Connection connection)  
      java.util.concurrent.CompletableFuture<java.lang.Void> preCreateConnections​(int connectionCount)
      Optionally pre-create up to connectionCount connections so they are immediately ready for use.
      protected void proceed()  
      boolean release​(Connection connection)
      Returns the given connection, previously obtained via ConnectionPool.acquire(boolean), back to this ConnectionPool.
      protected void released​(Connection connection)  
      boolean remove​(Connection connection)
      Removes the given connection from this ConnectionPool.
      protected boolean remove​(Connection connection, boolean force)  
      protected void removed​(Connection connection)  
      void setMaximizeConnections​(boolean maximizeConnections)
      Sets whether the number of connections should be maximized.
      protected void setMaxMultiplex​(int maxMultiplex)  
      protected void setMaxUsageCount​(int maxUsageCount)  
      boolean sweep()  
      java.lang.String toString()  
      protected void tryCreate​(int maxPending)
      Schedules the opening of a new connection.

      • Methods inherited from class org.eclipse.jetty.util.component.ContainerLifeCycle

        addBean, addBean, addEventListener, addManaged, contains, destroy, doStart, dump, dump, dumpObjects, dumpStdErr, getBean, getBeans, getBeans, getContainedBeans, getContainedBeans, isAuto, isManaged, isUnmanaged, manage, removeBean, removeBeans, removeEventListener, setBeans, start, stop, unmanage, updateBean, updateBean, updateBeans

      • Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

        getEventListeners, getState, getState, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, setEventListeners, start, stop

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

      • Methods inherited from interface org.eclipse.jetty.util.component.Container

        getCachedBeans, getEventListeners

      • Methods inherited from interface org.eclipse.jetty.util.component.Dumpable

        dump, dumpSelf

      • Methods inherited from interface org.eclipse.jetty.util.component.Dumpable.DumpableContainer

        isDumpable

    • Constructor Detail

      • AbstractConnectionPool

        protected AbstractConnectionPool​(HttpDestination destination,
                                 int maxConnections,
                                 boolean cache,
                                 org.eclipse.jetty.util.Callback requester)

      • AbstractConnectionPool

        protected AbstractConnectionPool​(HttpDestination destination,
                                 org.eclipse.jetty.util.Pool<Connection> pool,
                                 org.eclipse.jetty.util.Callback requester)

    • Method Detail

      • doStop

        protected void doStop()
               throws java.lang.Exception
        Overrides:
        doStop in class org.eclipse.jetty.util.component.ContainerLifeCycle
        Throws:
        java.lang.Exception

      • preCreateConnections

        public java.util.concurrent.CompletableFuture<java.lang.Void> preCreateConnections​(int connectionCount)
        Description copied from interface: ConnectionPool
        Optionally pre-create up to connectionCount connections so they are immediately ready for use.
        Specified by:
        preCreateConnections in interface ConnectionPool
        Parameters:
        connectionCount - the number of connections to pre-start.

      • getMaxMultiplex

        protected int getMaxMultiplex()

      • setMaxMultiplex

        protected void setMaxMultiplex​(int maxMultiplex)

      • getMaxUsageCount

        protected int getMaxUsageCount()

      • setMaxUsageCount

        protected void setMaxUsageCount​(int maxUsageCount)

      • getActiveConnectionCount

        @ManagedAttribute(value="The number of active connections",
                  readonly=true)
public int getActiveConnectionCount()

      • getIdleConnectionCount

        @ManagedAttribute(value="The number of idle connections",
                  readonly=true)
public int getIdleConnectionCount()

      • getMaxConnectionCount

        @ManagedAttribute(value="The max number of connections",
                  readonly=true)
public int getMaxConnectionCount()

      • getConnectionCount

        @ManagedAttribute(value="The number of connections",
                  readonly=true)
public int getConnectionCount()

      • getPendingConnectionCount

        @ManagedAttribute(value="The number of pending connections",
                  readonly=true)
public int getPendingConnectionCount()

      • isEmpty

        public boolean isEmpty()
        Specified by:
        isEmpty in interface ConnectionPool
        Returns:
        whether this ConnectionPool has no open connections

      • isClosed

        @ManagedAttribute("Whether this pool is closed")
public boolean isClosed()
        Specified by:
        isClosed in interface ConnectionPool
        Returns:
        whether this ConnectionPool has been closed
        See Also:
        ConnectionPool.close()

      • isMaximizeConnections

        @ManagedAttribute("Whether the pool tries to maximize the number of connections used")
public boolean isMaximizeConnections()

      • setMaximizeConnections

        public void setMaximizeConnections​(boolean maximizeConnections)

        Sets whether the number of connections should be maximized.

        Parameters:
        maximizeConnections - whether the number of connections should be maximized

      • acquire

        public Connection acquire​(boolean create)

        Returns an idle connection, if available; if an idle connection is not available, and the given create parameter is true or isMaximizeConnections() is true, then schedules the opening of a new connection, if possible within the configuration of this connection pool (for example, if it does not exceed the max connection count); otherwise returns null.

        Specified by:
        acquire in interface ConnectionPool
        Parameters:
        create - whether to schedule the opening of a connection if no idle connections are available
        Returns:
        an idle connection or null if no idle connections are available
        See Also:
        tryCreate(int)

      • tryCreate

        protected void tryCreate​(int maxPending)

        Schedules the opening of a new connection.

        Whether a new connection is scheduled for opening is determined by the maxPending parameter: if maxPending is greater than the current number of connections scheduled for opening, then this method returns without scheduling the opening of a new connection; if maxPending is negative, a new connection is always scheduled for opening.

        Parameters:
        maxPending - the max desired number of connections scheduled for opening, or a negative number to always trigger the opening of a new connection

      • accept

        public boolean accept​(Connection connection)
        Description copied from interface: ConnectionPool

        Accepts the given connection to be managed by this ConnectionPool.

        Specified by:
        accept in interface ConnectionPool
        Parameters:
        connection - the connection to accept
        Returns:
        whether the connection has been accepted

      • proceed

        protected void proceed()

      • isActive

        public boolean isActive​(Connection connection)
        Specified by:
        isActive in interface ConnectionPool
        Parameters:
        connection - the connection to test
        Returns:
        whether the given connection is currently in use

      • release

        public boolean release​(Connection connection)
        Description copied from interface: ConnectionPool

        Returns the given connection, previously obtained via ConnectionPool.acquire(boolean), back to this ConnectionPool.

        Specified by:
        release in interface ConnectionPool
        Parameters:
        connection - the connection to release
        Returns:
        true if the connection has been released, false if the connection should be closed

      • deactivate

        protected boolean deactivate​(Connection connection)

      • remove

        public boolean remove​(Connection connection)
        Description copied from interface: ConnectionPool

        Removes the given connection from this ConnectionPool.

        Specified by:
        remove in interface ConnectionPool
        Parameters:
        connection - the connection to remove
        Returns:
        true if the connection was removed from this ConnectionPool

      • remove

        protected boolean remove​(Connection connection,
                         boolean force)

      • onCreated

        protected void onCreated​(Connection connection)

      • idle

        protected boolean idle​(Connection connection,
                       boolean close)

      • acquired

        protected void acquired​(Connection connection)

      • released

        protected void released​(Connection connection)

      • removed

        protected void removed​(Connection connection)

      • close

        public void close()
        Specified by:
        close in interface java.lang.AutoCloseable
        Specified by:
        close in interface java.io.Closeable
        Specified by:
        close in interface ConnectionPool

      • dump

        public void dump​(java.lang.Appendable out,
                 java.lang.String indent)
          throws java.io.IOException
        Specified by:
        dump in interface org.eclipse.jetty.util.component.Dumpable
        Overrides:
        dump in class org.eclipse.jetty.util.component.ContainerLifeCycle
        Throws:
        java.io.IOException

      • sweep

        public boolean sweep()
        Specified by:
        sweep in interface org.eclipse.jetty.util.thread.Sweeper.Sweepable

      • toString

        public java.lang.String toString()
        Overrides:
        toString in class org.eclipse.jetty.util.component.AbstractLifeCycle