Class PoolMasterActor

java.lang.Object
org.apache.pekko.http.impl.engine.client.PoolMasterActor
All Implemented Interfaces:
org.apache.pekko.actor.Actor, org.apache.pekko.actor.ActorLogging

public final class PoolMasterActor extends Object implements org.apache.pekko.actor.Actor, org.apache.pekko.actor.ActorLogging
INTERNAL API

Manages access to a host connection pool or rather: a sequence of pool incarnations.

A host connection pool for a given HostConnectionPoolSetup is a running stream, whose outside interface is provided by its PoolInterface actor. The actor accepts PoolInterface.PoolRequest messages and completes their responsePromise whenever the respective response has been received (or an error occurred).

The PoolMasterActor provides a layer of indirection between a PoolId, which represents a pool, and the PoolInterface instances which are created on-demand and stopped after an idle-timeout.

Several PoolId objects may be mapped to the same pool if they have the same HostConnectionPoolSetup and are marked as being shared. This is the case for example for gateways obtained through HttpExt.cachedHostConnectionPool. Some other gateways are not shared, such as those obtained through HttpExt.newHostConnectionPool, and will have their dedicated restartable pool.

  • Constructor Details

    • PoolMasterActor

      public PoolMasterActor()
  • Method Details

    • props

      public static org.apache.pekko.actor.Props props()
    • context

      public org.apache.pekko.actor.ActorContext context()
      Specified by:
      context in interface org.apache.pekko.actor.Actor
    • self

      public final org.apache.pekko.actor.ActorRef self()
      Specified by:
      self in interface org.apache.pekko.actor.Actor
    • receive

      public scala.PartialFunction<Object,scala.runtime.BoxedUnit> receive()
      Specified by:
      receive in interface org.apache.pekko.actor.Actor