Class BroadcastPool
- java.lang.Object
-
- org.apache.pekko.routing.BroadcastPool
-
- All Implemented Interfaces:
java.io.Serializable
,Pool
,PoolOverrideUnsetConfig<BroadcastPool>
,RouterConfig
,scala.Equals
,scala.Product
public final class BroadcastPool extends java.lang.Object implements Pool, PoolOverrideUnsetConfig<BroadcastPool>, scala.Product, java.io.Serializable
A router pool that broadcasts a message to all its routees.The configuration parameter trumps the constructor arguments. This means that if you provide
nrOfInstances
during instantiation they will be ignored if the router is defined in the configuration file for the actor being used.Supervision Setup
Any routees that are created by a router will be created as the router's children. The router is therefore also the children's supervisor.
The supervision strategy of the router actor can be configured with
withSupervisorStrategy(org.apache.pekko.actor.SupervisorStrategy)
. If no strategy is provided, routers default to a strategy of “always escalate”. This means that errors are passed up to the router's supervisor for handling.The router's supervisor will treat the error as an error with the router itself. Therefore a directive to stop or restart will cause the router itself to stop or restart. The router, in turn, will cause its children to stop and restart.
param: nrOfInstances initial number of routees in the pool
param: resizer optional resizer that dynamically adjust the pool size
param: supervisorStrategy strategy for supervising the routees, see 'Supervision Setup'
param: routerDispatcher dispatcher to use for the router head actor, which handles supervision, death watch and router management messages
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description BroadcastPool(int nr)
Java APIBroadcastPool(int nrOfInstances, scala.Option<Resizer> resizer, SupervisorStrategy supervisorStrategy, java.lang.String routerDispatcher, boolean usePoolDispatcher)
BroadcastPool(com.typesafe.config.Config config)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static scala.Option<Resizer>
$lessinit$greater$default$2()
static SupervisorStrategy
$lessinit$greater$default$3()
static java.lang.String
$lessinit$greater$default$4()
static boolean
$lessinit$greater$default$5()
static BroadcastPool
apply(int nrOfInstances, scala.Option<Resizer> resizer, SupervisorStrategy supervisorStrategy, java.lang.String routerDispatcher, boolean usePoolDispatcher)
static scala.Option<Resizer>
apply$default$2()
static SupervisorStrategy
apply$default$3()
static java.lang.String
apply$default$4()
static boolean
apply$default$5()
boolean
canEqual(java.lang.Object x$1)
BroadcastPool
copy(int nrOfInstances, scala.Option<Resizer> resizer, SupervisorStrategy supervisorStrategy, java.lang.String routerDispatcher, boolean usePoolDispatcher)
int
copy$default$1()
scala.Option<Resizer>
copy$default$2()
SupervisorStrategy
copy$default$3()
java.lang.String
copy$default$4()
boolean
copy$default$5()
Router
createRouter(ActorSystem system)
Create the actual router, responsible for routing messages to routees.boolean
equals(java.lang.Object x$1)
int
hashCode()
int
nrOfInstances()
int
nrOfInstances(ActorSystem sys)
Initial number of routee instancesint
productArity()
java.lang.Object
productElement(int x$1)
java.lang.String
productElementName(int x$1)
scala.collection.Iterator<java.lang.Object>
productIterator()
java.lang.String
productPrefix()
scala.Option<Resizer>
resizer()
Pool with dynamically resizable number of routees return thepekko.routing.Resizer
to use.java.lang.String
routerDispatcher()
Dispatcher ID to use for running the “head” actor, which handles supervision, death watch and router management messagesSupervisorStrategy
supervisorStrategy()
SupervisorStrategy for the head actor, i.e.java.lang.String
toString()
static scala.Option<scala.Tuple5<java.lang.Object,scala.Option<Resizer>,SupervisorStrategy,java.lang.String,java.lang.Object>>
unapply(BroadcastPool x$0)
boolean
usePoolDispatcher()
Use a dedicated dispatcher for the routees of the pool.BroadcastPool
withDispatcher(java.lang.String dispatcherId)
Setting the dispatcher to be used for the router head actor, which handles supervision, death watch and router management messages.RouterConfig
withFallback(RouterConfig other)
Uses the resizer and/or the supervisor strategy of the given RouterConfig if this RouterConfig doesn't have one, i.e.BroadcastPool
withResizer(Resizer resizer)
Setting the resizer to be used.BroadcastPool
withSupervisorStrategy(SupervisorStrategy strategy)
Setting the supervisor strategy to be used for the “head” Router actor.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.apache.pekko.routing.Pool
createRouterActor, enrichWithPoolDispatcher, newRoutee, props, stopRouterWhenAllRouteesRemoved
-
Methods inherited from interface org.apache.pekko.routing.PoolOverrideUnsetConfig
overrideUnsetConfig
-
Methods inherited from interface org.apache.pekko.routing.RouterConfig
isManagementMessage, routingLogicController, verifyConfig
-
-
-
-
Constructor Detail
-
BroadcastPool
public BroadcastPool(int nrOfInstances, scala.Option<Resizer> resizer, SupervisorStrategy supervisorStrategy, java.lang.String routerDispatcher, boolean usePoolDispatcher)
-
BroadcastPool
public BroadcastPool(com.typesafe.config.Config config)
-
BroadcastPool
public BroadcastPool(int nr)
Java API- Parameters:
nr
- initial number of routees in the pool
-
-
Method Detail
-
$lessinit$greater$default$2
public static scala.Option<Resizer> $lessinit$greater$default$2()
-
$lessinit$greater$default$3
public static SupervisorStrategy $lessinit$greater$default$3()
-
$lessinit$greater$default$4
public static java.lang.String $lessinit$greater$default$4()
-
$lessinit$greater$default$5
public static boolean $lessinit$greater$default$5()
-
apply
public static BroadcastPool apply(int nrOfInstances, scala.Option<Resizer> resizer, SupervisorStrategy supervisorStrategy, java.lang.String routerDispatcher, boolean usePoolDispatcher)
-
apply$default$2
public static scala.Option<Resizer> apply$default$2()
-
apply$default$3
public static SupervisorStrategy apply$default$3()
-
apply$default$4
public static java.lang.String apply$default$4()
-
apply$default$5
public static boolean apply$default$5()
-
unapply
public static scala.Option<scala.Tuple5<java.lang.Object,scala.Option<Resizer>,SupervisorStrategy,java.lang.String,java.lang.Object>> unapply(BroadcastPool x$0)
-
nrOfInstances
public int nrOfInstances()
-
resizer
public scala.Option<Resizer> resizer()
Description copied from interface:Pool
Pool with dynamically resizable number of routees return thepekko.routing.Resizer
to use. The resizer is invoked once when the router is created, before any messages can be sent to it. Resize is also triggered when messages are sent to the routees, and the resizer is invoked asynchronously, i.e. not necessarily before the message has been sent.
-
supervisorStrategy
public SupervisorStrategy supervisorStrategy()
Description copied from interface:Pool
SupervisorStrategy for the head actor, i.e. for supervising the routees of the pool.- Specified by:
supervisorStrategy
in interfacePool
-
routerDispatcher
public java.lang.String routerDispatcher()
Description copied from interface:RouterConfig
Dispatcher ID to use for running the “head” actor, which handles supervision, death watch and router management messages- Specified by:
routerDispatcher
in interfaceRouterConfig
-
usePoolDispatcher
public boolean usePoolDispatcher()
Description copied from interface:Pool
Use a dedicated dispatcher for the routees of the pool. The dispatcher is defined in 'pool-dispatcher' configuration property in the deployment section of the router.- Specified by:
usePoolDispatcher
in interfacePool
-
createRouter
public Router createRouter(ActorSystem system)
Description copied from interface:RouterConfig
Create the actual router, responsible for routing messages to routees.- Specified by:
createRouter
in interfaceRouterConfig
- Parameters:
system
- the ActorSystem this router belongs to
-
nrOfInstances
public int nrOfInstances(ActorSystem sys)
Description copied from interface:Pool
Initial number of routee instances- Specified by:
nrOfInstances
in interfacePool
-
withSupervisorStrategy
public BroadcastPool withSupervisorStrategy(SupervisorStrategy strategy)
Setting the supervisor strategy to be used for the “head” Router actor.- Specified by:
withSupervisorStrategy
in interfacePoolOverrideUnsetConfig<BroadcastPool>
-
withResizer
public BroadcastPool withResizer(Resizer resizer)
Setting the resizer to be used.- Specified by:
withResizer
in interfacePoolOverrideUnsetConfig<BroadcastPool>
-
withDispatcher
public BroadcastPool withDispatcher(java.lang.String dispatcherId)
Setting the dispatcher to be used for the router head actor, which handles supervision, death watch and router management messages.
-
withFallback
public RouterConfig withFallback(RouterConfig other)
Uses the resizer and/or the supervisor strategy of the given RouterConfig if this RouterConfig doesn't have one, i.e. the resizer defined in code is used if resizer was not defined in config.- Specified by:
withFallback
in interfaceRouterConfig
-
copy
public BroadcastPool copy(int nrOfInstances, scala.Option<Resizer> resizer, SupervisorStrategy supervisorStrategy, java.lang.String routerDispatcher, boolean usePoolDispatcher)
-
copy$default$1
public int copy$default$1()
-
copy$default$2
public scala.Option<Resizer> copy$default$2()
-
copy$default$3
public SupervisorStrategy copy$default$3()
-
copy$default$4
public java.lang.String copy$default$4()
-
copy$default$5
public boolean copy$default$5()
-
productPrefix
public java.lang.String productPrefix()
- Specified by:
productPrefix
in interfacescala.Product
-
productArity
public int productArity()
- Specified by:
productArity
in interfacescala.Product
-
productElement
public java.lang.Object productElement(int x$1)
- Specified by:
productElement
in interfacescala.Product
-
productIterator
public scala.collection.Iterator<java.lang.Object> productIterator()
- Specified by:
productIterator
in interfacescala.Product
-
canEqual
public boolean canEqual(java.lang.Object x$1)
- Specified by:
canEqual
in interfacescala.Equals
-
productElementName
public java.lang.String productElementName(int x$1)
- Specified by:
productElementName
in interfacescala.Product
-
hashCode
public int hashCode()
- Overrides:
hashCode
in classjava.lang.Object
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
equals
public boolean equals(java.lang.Object x$1)
- Specified by:
equals
in interfacescala.Equals
- Overrides:
equals
in classjava.lang.Object
-
-