Actor 生命周期
一个 Actor 可以创建或生成任意数量的子 Actor,而子 Actor 又可以生成自己的子 Actor,从而形成一个 Actor 层次。「ActorSystem」承载层次结构,并且在层次结构的顶部只能有一个根 Actor。一个子 Actor 的生命周期是与其父 Actor 联系在一起的,一个子 Actor 可以在任何时候停止自己或被停止,但永远不能比父 Actor 活得更久。
根 Actor,也称为守护者 Actor,与ActorSystem
一起创建。发送到 Actor 系统的消息被定向到根 Actor。根 Actor 是由用于创建ActorSystem
的行为定义的,在下面的示例中名为HelloWorldMain.main
:
final ActorSystem<HelloWorldMain.Start> system =
ActorSystem.create(HelloWorldMain.main, "hello");
system.tell(new HelloWorldMain.Start("World"));
system.tell(new HelloWorldMain.Start("Akka"));
子 Actor 是由「」的“繁殖”产生的。在下面的示例中,当根 Actor 启动时,它生成一个由行为HelloWorld.greeter
描述的子 Actor。此外,当根 Actor 收到Start
消息时,它将创建由行为HelloWorldBot.bot
定义的子 Actor:
要在生成 Actor 时指定调度器,请使用「DispatcherSelector」。如果未指定,则 Actor 将使用默认调度器,有关详细信息,请参阅「」。
public static final Behavior<Start> main =
Behaviors.setup(
context -> {
final String dispatcherPath = "akka.actor.default-blocking-io-dispatcher";
Props props = DispatcherSelector.fromConfig(dispatcherPath);
final ActorRef<HelloWorld.Greet> greeter =
context.spawn(HelloWorld.greeter, "greeter", props);
return Behaviors.receiveMessage(
message -> {
context.spawn(HelloWorldBot.bot(0, 3), message.name);
greeter.tell(new HelloWorld.Greet(message.name, replyTo));
return Behaviors.same();
});
});
守护者 Actor 应该负责初始化任务并创建应用程序的初始 Actor,但有时你可能希望从守护者 Actor 的外部生成新的 Actor。例如,每个 HTTP 请求创建一个 Actor。
这并不难你在行为中的实现,但是由于这是一个常见的模式,因此有一个预定义的消息协议和行为的实现。它可以用作的守护者 Actor,可能与Behaviors.setup
结合使用以启动一些初始任务或 Actor。然后,可以通过调用SpawnProtocol.Spawn
从外部启动子 Actor,生成到系统的 Actor 引用。使用ask
时,这类似于ActorSystem.actorOf
如何在非类型化 Actor 中使用,不同之处在于ActorRef
的CompletionStage
返回。
守护者行为可定义为:
而ActorSystem
可以用这种main
行为来创建,并生成其他 Actor:
import akka.actor.typed.ActorRef;
import akka.actor.typed.ActorSystem;
import akka.actor.typed.Props;
import akka.actor.typed.javadsl.AskPattern;
import akka.util.Timeout;
final ActorSystem<SpawnProtocol> system = ActorSystem.create(HelloWorldMain.main, "hello");
final Duration timeout = Duration.ofSeconds(3);
CompletionStage<ActorRef<HelloWorld.Greet>> greeter =
AskPattern.ask(
system,
replyTo ->
new SpawnProtocol.Spawn<>(HelloWorld.greeter, "greeter", Props.empty(), replyTo),
timeout,
system.scheduler());
Behaviors.receive(
(context, message) -> {
return Behaviors.stopped();
});
CompletionStage<ActorRef<HelloWorld.Greeted>> greetedReplyTo =
AskPattern.ask(
system,
replyTo -> new SpawnProtocol.Spawn<>(greetedBehavior, "", Props.empty(), replyTo),
timeout,
system.scheduler());
greeter.whenComplete(
(greeterRef, exc) -> {
if (exc == null) {
greetedReplyTo.whenComplete(
(greetedReplyToRef, exc2) -> {
if (exc2 == null) {
greeterRef.tell(new HelloWorld.Greet("Akka", greetedReplyToRef));
}
});
});
Actor 可以通过返回Behaviors.stopped
作为下一个行为来停止自己。
通过使用父 Actor 的ActorContext
的stop
方法,在子 Actor 完成当前消息的处理后,可以强制停止子 Actor。只有子 Actor 才能这样被阻止。
子 Actor 将作为父级关闭过程的一部分被停止。
停止 Actor 产生的PostStop
信号可用于清除资源。请注意,可以选择将处理此类PostStop
信号的行为定义为Behaviors.stopped
的参数。如果 Actor 在突然停止时能优雅地停止自己,则需要不同的操作。
英文原文链接:Actor lifecycle.