java actor akka_AKKA文档(java版)—角色

本文详细介绍了Akka Actor系统中角色的生命周期,包括预启动(preStart)、重启(postRestart)和终止(postStop)钩子。强调了角色间的监控,如通过getContext().watch()方法实现对其他角色的终止监听。此外,还讨论了消息发送的异步性,如使用tell和ask方法,以及如何优雅地终止和升级角色。文章还提到了Actor的初始化模式,如构造函数初始化、preStart初始化和通过消息传递初始化,并提醒了在初始化过程中需要注意的问题。
摘要由CSDN通过智能技术生成

生命周期监控又名临终看护

当另一个角色终止时,为了通知被通知(即永久性地停止,而不是暂时的失败和重新启动),一个角色可以自己注册为接收在终止上层的其他角色发送的终止消息,其他演员出动(请参阅停止演员)。这项服务是由角色系统的临终看护组件提供。

注册一个监视器是很容易的(见第四行,剩下的就是用于展示整个功能):

import akka.actor.Terminated;

public class WatchActor extends UntypedActor {

final ActorRef child = this.getContext().actorOf(Props.empty(), "child");

{

this.getContext().watch(child); //

}

ActorRef lastSender = getContext().system().deadLetters();

@Override

public void onReceive(Object message) {

if (message.equals("kill")) {

getContext().stop(child);

lastSender = getSender();

} else if (message instanceof Terminated) {

final Terminated t = (Terminated) message;

if (t.getActor() == child) {

lastSender.tell("finished", getSelf());

}

} else {

unhandled(message);

}

}

}

但是应当注意的是,产生的终止消息独立于注册和终止发生的顺序。特别是,监控角色将接收一个终止信息即使被监控角色已经被终止在注册时候。

注册多次并不必然导致对多个消息被产生,但不保证只有一个对应这样的消息被接收:如果被监控角色终止已经发生和发送的消息排队等候着,在另一个注册完成之前,该消息已经处理完,然后第二消息将会排队,是因为已经结束角色的监控的注册导致终止信息立刻产生。

使用getContext().unwatch(target)方法从监控另一个角色生命活力撤销下来也是有可能的。这个工作即使已终止消息已经排队于邮箱中,在调用unwatch方法后对于那个角色将没有终止消息被处理。

启动钩子

在正确启动角色之后,preStart方法被调用。

@Override

public void preStart() {

child = getContext().actorOf(Props.empty());

}

第一次创建角色时,该方法被调用。在重新启动期间,它被postRestart的默认实现调用,这意味着通过重写该方法,你可以选择此方法中初始化代码是否被调用,对这个角色或每次重启仅只调用一次。在一个角色类的实例创建时,角色的构造函数的一部分的初始化代码将每次都被调用,这发生在每次重启时。

重启钩子

所有角色被监督着,即用故障处理策略链接到另一个角色。当处理一个消息是,抛出一个异常的情况下,演员可能重新启动(见监管与监控)抛出一个异常。这重启涉及上述提到钩子:

1. 旧角色是通过调用preRestart方法进行通知的,这伴随着造成重启的异常与绑定该异常的消息;处理一个消息没有造成这个重启发生,则后者可能也没有发生,例如,当一个监管者不捕获该异常,则由其监管者重启又或者如果由于一个同类的失败,一个角色将被重新启动。如果消息是可用的,那么该消息的发件人也可以通过正常方式访问的(即通过调用getSender())。

这个方法用在这些地方时最好的,例如:清除,准备交到新的角色实例等等。默认它停止所有子实例和调用postStop方法。

2. 来自actorOf方法调用的初始化工厂用来产生新的实例。

3. 新角色的postRestart方法被调用时这引起了重启异常。默认情况下,preStart是被调用,就如同在正常启动的情况下。

一个角色重启仅替换实际角色的对象;邮箱中的内容是不受重启影响,所以消息的处理将在postRestart钩子返回后恢复。引发异常的消息将不会再接收。当重启时候,发送到角色的任何消息将像平常一样排队到它的邮箱。

注意:要知道,相关用户失败消息的顺序是不确定的。特别是,一个父类可能会重新启动其子类之前它已经处理了在失败之前子类发送故障的的最后消息。见讨论:消息顺序的详细信息。

终止钩子

终止一个角色之后,其postStop钩子被调用时,其可能用于例如从其他服务注销这个角色。在这个角色的消息队列已禁用之后,这个钩子仍保证运行,即送到已终止角色的信息将被重定向到ActorSystem的deadLetters。

识别角色通过角色选择集

作为角色的引用,路径和地址描述,每个角色都有一个唯一的逻辑路径,这是由以下的子类到父类直到达到角色系统的根的角色的链得到的,它有一个物理路径,如果监管链包括任何远程监管者,这可能会有所不同。这些路径是由系统使用来查找角色,如当接收到一个远程的消息和收件人进行搜索,但他们也有更直接用法:角色可以查找其他角色通过指定绝对或相对路径,逻辑或物理,并接收返回的结果的ActorSelection:

// will look up this absolute path

getContext().actorSelection("/user/serviceA/actor");

// will look up sibling beneath same supervisor

getContext().actorSelection("../joe");

其中指定的路径被解释为一个java.net.URI, 它以 / 分隔成路径段. 如果路径以 /开始, 表示一个绝对路径,从根监管者 ( “/user”的父亲)开始查找; 否则是从当前角色开始。如果某一个路径段为 .., 会找到当前所遍历到的角色的上一级, 否则则会向下一级寻找具有该名字的子角色。 必须注意的是角色路径中的.. 总是表示逻辑结构,也就是其监管者。

一个角色选择集的路径元素可以包含通配符,允许消息额广播到该选择集:

// will look all children to serviceB with names starting with worker

getContext().actorSelection("/user/serviceB/worker*");

// will look up all siblings beneath same supervisor

getContext().actorSelection("../*");

信息可以通过ActorSelection发送和当传送的每个消息时,查找ActorSelection的路径。如果选择集不匹配任何角色的消息将被丢弃。

为了获得一个ActorSelection的ActorRef,你需要发送一个消息到选择集和使用来自橘色的回复的getSender引用。有一个内置的识别信息,即所有角色都理解并自动回复一个包含ActorRef的ActorIdentity消息。此消息由该角色特殊处理,在这个意义上说是穿越的,如果一个具体的名称查找失败(即非通配符路径元素不符合一个存在的角色)然后产生一个消极结果。请注意,这并不意味着传递的答复是有保障的,但它仍然是一个正常的消息。

import akka.actor.ActorIdentity;

import akka.actor.ActorSelection;

import akka.actor.Identify;

public class Follower extends UntypedActor {

final String identifyId = "1";

{

ActorSelection selection =

getContext().actorSelection("/user/another");

selection.tell(new Identify(identifyId), getSelf());

}

ActorRef another;

final ActorRef probe;

public Follower(ActorRef probe) {

this.probe = probe;

}

@Override

public void onReceive(Object message) {

if (message instanceof ActorIdentity) {

ActorIdentity identity = (ActorIdentity) message;

if (identity.correlationId().equals(identifyId)) {

ActorRef ref = identity.getRef();

if (ref == null)

getContext().stop(getSelf());

else {

another = ref;

getContext().watch(another);

probe.tell(ref, getSelf());

}

}

} else if (message instanceof Terminated) {

final Terminated t = (Terminated) message;

if (t.getActor().equals(another)) {

getContext().stop(getSelf());

}

} else {

unhandled(message);

}

}

}

您也可以取得一个ActorSelection的ActorRef通过ActorSelection的resolveOne方法。它返回匹配ActorRef的Future,如果这样一个角色存在。如果没有这样的角色存在或鉴定所提供的超时时间内没有完成,它将已失败告终akka.actor.ActorNotFound。

远程角色地址也可以查找,如果远程被启用:

getContext().actorSelection("akka.tcp://app@otherhost:1234/user/serviceB");

一个关于actor查找的示例见 远程查找.

注意:在支持actorSelection,actorFor是被废弃,因为用actorFor获得的角色引用对本地与远程角色表现不同。在一个本地角色引用的情况下,查找之前命名的演员需要存在,否则所获取的引用将是一个EmptyLocalActorRef。即使在获取角色引用之后,一个真实路径的角色才被创建,这时也是可以获取的。对于远程角色引用通过actorFor来获取的行为不同的,发送信息到该引用上将在覆盖下通过在远程系统给每一个消息发送的路径查找角色。

信息和不变性

重要信息:消息可以是任何类型的对象,但必须是不可变的。阿Aka不能强制不变性,所以这必须按照约定。 这里是一个不变的消息的示例:

public class ImmutableMessage {

private final int sequenceNumber;

private final List values;

public ImmutableMessage(int sequenceNumber, List values) {

this.sequenceNumber = sequenceNumber;

this.values = Collections.unmodifiableList(new ArrayList(values));

}

public int getSequenceNumber() {

return sequenceNumber;

}

public List getValues() {

return values;

}

}

发送信息

向actor发送消息是使用下列方法之一。

意思是“fire-and-forget”, e.g. 异步发送一个消息并立即返回。也称为 tell.

异步发送一条消息并返回一个 Future代表一个可能的回应。也称为 ask.

每一个消息发送者分别保证自己的消息的次序.

注意:使用ask会造成性能影响,因为当超时是,一些事情需要保持追踪。这需要一些东西来将一个Promise连接进入ActorRef,并且需要通过远程连接可到达的。所以总是使用tell更偏向性能,除非必须才用ask.

在所有这些方法你可以传递自己的ActorRef。让它这样做,因为这将允许接收的角色才能够回复您的邮件,因为发件人引用随该信息一起发送的。

Tell: Fire-forget

这是发送消息的推荐方式。 不会阻塞地等待消息。它拥有最好的并发性和可扩展性。

// don’t forget to think about who is the sender (2nd argument)

target.tell(message, getSelf());

发送者引用是伴随着消息传递的,在接收角色可用范围内,当处理该消息时,通过getSender方法。在一个角色内部通常是getSelf,这应该为发送者,但也可能是这种情况,回复被路由到一些其他角色即该父类的第二个参数tell将是不同的一个。在角色外部,如果没有回复,第二个参数可以为null;如果在角色外部需要一个回复,你可以使用问答模式描,下面描述..

Ask: Send-And-Receive-Future

ask 模式既包含actor也包含future, 所以它是作为一种使用模式,而不是ActorRef的方法:

import static akka.pattern.Patterns.ask;

import static akka.pattern.Patterns.pipe;

import scala.concurrent.Future;

import scala.concurrent.duration.Duration;

import akka.dispatch.Futures;

import akka.dispatch.Mapper;

import akka.util.Timeout;

final Timeout t = new Timeout(Duration.create(5, TimeUnit.SECONDS));

final ArrayList> futures = new ArrayList>();

futures.add(ask(actorA, "request", 1000)); // using 1000ms timeout

futures.add(ask(actorB, "another request", t)); // using timeout from

// above

final Future> aggregate = Futures.sequence(futures,

system.dispatcher());

final Future transformed = aggregate.map(

new Mapper, Result>() {

public Result apply(Iterable coll) {

final Iterator it = coll.iterator();

final String x = (String) it.next();

final String s = (String) it.next();

return new Result(x, s);

}

}, system.dispatcher());

pipe(transformed, system.dispatcher()).to(actorC);

上面的例子展示了将 ask与 future上的 pipe 模式一起使用,因为这是一种非常常用的组合。 请注意上面所有的调用都是完全非阻塞和异步的: ask 产生 Future, 两个通过Futures.sequence和map方法组合成一个新的Future,然后用 pipe在future上安装一个 onComplete-处理器来完成将收集到的 Result发送到其它actor的动作。

使用 ask将会像tell 一样发送消息给接收方, 接收方必须通过getSender().tell(reply, getSelf())发送回应来为返回的 Future 填充数据。ask 操作包括创建一个内部actor来处理回应,必须为这个内部actor指定一个超时期限,过了超时期限内部actor将被销毁以防止内存泄露。详见下面:

注意:如果要以异常来填充future你需要发送一个 Failure 消息给发送方。这个操作不会在actor处理消息发生异常时自动完成。

try {

String result = operation();

getSender().tell(result, getSelf());

} catch (Exception e) {

getSender().tell(new akka.actor.Status.Failure(e), getSelf());

throw e;

}

如果一个actor没有完成future, 它会在超时时限到来时过期, 明确作为一个参数传给ask方法,以 AskTimeoutException来完成Future。

关于如何等待或查询一个future,更多信息请见Futures 。

Future的onComplete, onResult, 或 onTimeout方法可以用来注册一个回调,以便在Future完成时得到通知。从而提供一种避免阻塞的方法。

在使用future回调时,在角色内部你要小心避免关闭该角色的引用, 即不要在回调中调用该角色的方法或访问其可变状态。这会破坏角色的封装,会引用同步bugbug和race condition, 因为回调会与此角色一同被并发调度。 不幸的是目前还没有一种编译时的方法能够探测到这种非法访问。 参阅: 角色与共享可变状态

转发消息

你可以将消息从一个角色转发给另一个。虽然经过了一个‘中转’,但最初的发送者地址/引用将保持不变。当实现功能类似路由器、负载均衡器、备份等的角色时会很有用。同时你需要传递你的上下文变量。

target.forward(result, getContext());

接收信息

当一个角色收到被传递到onReceive方法的消息,这是在需要被定义的UntypedActor基类的抽象方法。

下面是个例子:

import akka.actor.UntypedActor;

import akka.event.Logging;

import akka.event.LoggingAdapter;

public class MyUntypedActor extends UntypedActor {

LoggingAdapter log = Logging.getLogger(getContext().system(), this);

public void onReceive(Object message) throws Exception {

if (message instanceof String) {

log.info("Received String message: {}", message);

getSender().tell(message, getSelf());

} else

unhandled(message);

}

}

除了使用IF-instanceof检查,还有一种方法是使用Apache Commons MethodUtils调用指定的参数类型相匹配的消息类型方法。

回复信息

如果你需要一个用来发送回应消息的目标,可以使用 getSender, 它是一个角色引用。 你可以用 getSender().tell(replyMsg, getSelf())向这个引用发送回应消息。 你也可以将这个ActorRef保存起来将来再作回应。如果没有sender(不是从actor发送的消息或者没有future上下文) 那么 sender缺省为 ‘死信’ 角色的引用。

@Override

public void onReceive(Object msg) {

Object result =

// calculate result ...

// do not forget the second argument!

getSender().tell(result, getSelf());

}

接收超时

在一个ReceiveTimeout消息发送触发之后,该UntypedActorContext setReceiveTimeout定义不活动超时时间。当指定时,接收功能应该能够处理一个akka.actor.ReceiveTimeout消息。 1毫秒为最小支持超时。

请注意,接受超时可能会触发和在另一条消息是入队后,该ReceiveTimeout消息将重排队;因此,它不能保证在接收到接收超时的一定有预先通过该方法所配置的空闲时段。

一旦设置,接收超时保持有效(即持续重复触发超过不活动时间后)。传递Duration.Undefined关掉此功能。

import akka.actor.ActorRef;

import akka.actor.ReceiveTimeout;

import akka.actor.UntypedActor;

import scala.concurrent.duration.Duration;

public class MyReceiveTimeoutUntypedActor extends UntypedActor {

public MyReceiveTimeoutUntypedActor() {

// To set an initial delay

getContext().setReceiveTimeout(Duration.create("30 seconds"));

}

public void onReceive(Object message) {

if (message.equals("Hello")) {

// To set in a response to a message

getContext().setReceiveTimeout(Duration.create("1 second"));

} else if (message instanceof ReceiveTimeout) {

// To turn it off

getContext().setReceiveTimeout(Duration.Undefined());

} else {

unhandled(message);

}

}

}

终止角色

通过调用ActorRefFactory即 ActorContext或 ActorSystem的 stop 方法来终止一个角色, 通常 context 用来终止子角色,而 system用来终止顶级角色. 实际的终止操作是异步执行的, 即stop可能在角色被终止之前返回。

如果当前有正在处理的消息,对该消息的处理将在actor被终止之前完成,但是邮箱中的后续消息将不会被处理。缺省情况下这些消息会被送到 ActorSystem的 死信, 但是这取决于邮箱的实现。

角色的终止分两步: 第一步角色将停止对邮箱的处理,向所有子角色发送终止命令,然后处理来自子角色的终止消息直到所有的子角色都完成终止, 最后终止自己 (调用 postStop, 销毁邮箱, 向 DeathWatch发布 Terminated , 通知其监管者). 这个过程保证角色系统中的子树以一种有序的方式终止, 将终止命令传播到叶子结点并收集它们回送的确认消息给被终止的监管者。如果其中某个角色没有响应 (即由于处理消息用了太长时间以至于没有收到终止命令), 整个过程将会被阻塞。

在 ActorSystem.shutdown被调用时, 系统根监管角色会被终止,以上的过程将保证整个系统的正确终止。

postStop hook 是在角色被完全终止以后调用的。这是为了清理资源:

@Override

public void postStop() {

// clean up resources here ...

}

注意:由于角色的终止是异步的, 你不能马上使用你刚刚终止的子角色的名字;这会导致 InvalidActorNameException. 你应该 watch 正在终止的 介绍而在最终到达的 Terminated消息的处理中创建它的替代者。

PoisonPill

你也可以向角色发送 akka.actor.PoisonPill 消息, 这个消息处理完成后角色会被终止。 PoisonPill与普通消息一样被放进队列,因此会在已经入队列的其它消息之后被执行。

像下面使用:

myActor.tell(akka.actor.PoisonPill.getInstance(), sender);

优雅地终止

如果你想等待终止过程的结束,或者组合若干actor的终止次序,可以使用gracefulStop:

import static akka.pattern.Patterns.gracefulStop;

import scala.concurrent.Await;

import scala.concurrent.Future;

import scala.concurrent.duration.Duration;

import akka.pattern.AskTimeoutException;

try {

Future stopped =

gracefulStop(actorRef, Duration.create(5, TimeUnit.SECONDS), Manager.SHUTDOWN);

Await.result(stopped, Duration.create(6, TimeUnit.SECONDS));

// the actor has been stopped

} catch (AskTimeoutException e) {

// the actor wasn't stopped within 5 seconds

}

public class Manager extends UntypedActor {

public static final String SHUTDOWN = "shutdown";

ActorRef worker = getContext().watch(getContext().actorOf(

Props.create(Cruncher.class), "worker"));

public void onReceive(Object message) {

if (message.equals("job")) {

worker.tell("crunch", getSelf());

} else if (message.equals(SHUTDOWN)) {

worker.tell(PoisonPill.getInstance(), getSelf());

getContext().become(shuttingDown);

}

}

Procedure shuttingDown = new Procedure() {

@Override

public void apply(Object message) {

if (message.equals("job")) {

getSender().tell("service unavailable, shutting down", getSelf());

} else if (message instanceof Terminated) {

getContext().stop(getSelf());

}

}

};

}

当gracefulStop()成功返回时,角色的postStop()钩子将被执行:存在一个情况,happens-before 边缘在postStop()结尾和gracefulStop()返回之间。

在上面的例子中一个自定义的Manager.SHUTDOWN消息被发送到目标角色为了初始化正在终止角色的处理。您可以使用PoisonPill为这一点,但在阻止目标的角色之前,你拥有很少机会与其他角色进行交互。简单的清除任务可以在postStop中处理。

注意:请记住,一个角色终止和它的名字被注销是互相异步发生的独立事件。因此,在gracefulStop()后返回,它可能是你会发现名称仍然在使用。为了保证正确的注销,只能重复使用来自你控制监管者内与一个终止的消息的回应的名称,即不属于顶级的角色。

热插拔

升级

Akka支持在运行时对角色消息循环 (例如它的的实现)进行实时替换: 在角色中调用getContext.become 方法。 热替换的代码被存在一个栈中,可以被pushed(replacing 或 adding 在顶部)和popped。

注意:请注意角色被其监管者重启后将恢复其最初的行为。

热替换角色使用getContext().become:

import akka.japi.Procedure;

public class HotSwapActor extends UntypedActor {

Procedure angry = new Procedure() {

@Override

public void apply(Object message) {

if (message.equals("bar")) {

getSender().tell("I am already angry?", getSelf());

} else if (message.equals("foo")) {

getContext().become(happy);

}

}

};

Procedure happy = new Procedure() {

@Override

public void apply(Object message) {

if (message.equals("bar")) {

getSender().tell("I am already happy :-)", getSelf());

} else if (message.equals("foo")) {

getContext().become(angry);

}

}

};

public void onReceive(Object message) {

if (message.equals("bar")) {

getContext().become(angry);

} else if (message.equals("foo")) {

getContext().become(happy);

} else {

unhandled(message);

}

}

}

become方法还有很多其它的用处,一个特别好的例子是用它来实现一个有限状态机(FSM)。这将代替当前行为(即行为栈顶部),这意味着你不用使用unbecome,而是下一个行为将明确被安装。

使用become另一个方式:不代替而是添加到行为栈顶部。这种情况是必须要保证在长期运行中“pop”操作(即unbecome)数目匹配“push”数目,否则这个数目将导致内存泄露(这就是该行为不是默认原因)。

public class UntypedActorSwapper {

public static class Swap {

public static Swap SWAP = new Swap();

private Swap() {

}

}

public static class Swapper extends UntypedActor {

LoggingAdapter log = Logging.getLogger(getContext().system(), this);

public void onReceive(Object message) {

if (message == SWAP) {

log.info("Hi");

getContext().become(new Procedure() {

@Override

public void apply(Object message) {

log.info("Ho");

getContext().unbecome(); // resets the latest 'become'

}

}, false); // this signals stacking of the new behavior

} else {

unhandled(message);

}

}

}

public static void main(String... args) {

ActorSystem system = ActorSystem.create("MySystem");

ActorRef swap = system.actorOf(Props.create(Swapper.class));

swap.tell(SWAP, ActorRef.noSender()); // logs Hi

swap.tell(SWAP, ActorRef.noSender()); // logs Ho

swap.tell(SWAP, ActorRef.noSender()); // logs Hi

swap.tell(SWAP, ActorRef.noSender()); // logs Ho

swap.tell(SWAP, ActorRef.noSender()); // logs Hi

swap.tell(SWAP, ActorRef.noSender()); // logs Ho

}

}

贮藏

该UntypedActorWithStash类使一个角色临时藏匿不能或不应该使用角色的当前行为处理的消息。在改变角色的消息处理函数,即调用getContext().become()或getContext().unbecome(),所有藏匿的消息可以“unstashed”,因此前面加上他们角色的邮箱。这样一来,藏消息可以在他们已经收到原先相同的顺序进行处理。扩展UntypedActorWithStash角色将自动获得一个双端队列为基础的邮箱。

注意:抽象类UntypedActorWithStash实现标记接口RequiresMessageQueue这要求系统能够为该角色自动选择基于双端队列的邮箱实现。如果你想更多的控制权邮箱,请见邮箱文档:邮箱

这里是UntypedActorWithStash类中操作的示例:

import akka.actor.UntypedActorWithStash;

public class ActorWithProtocol extends UntypedActorWithStash {

public void onReceive(Object msg) {

if (msg.equals("open")) {

unstashAll();

getContext().become(new Procedure() {

public void apply(Object msg) throws Exception {

if (msg.equals("write")) {

// do writing...

} else if (msg.equals("close")) {

unstashAll();

getContext().unbecome();

} else {

stash();

}

}

}, false); // add behavior on top instead of replacing

} else {

stash();

}

}

}

调用stash()将当前的消息(即角色最后收到的消息)到角色的藏匿处。当在处理默认情况下在角色的消息处理函数来隐藏那些没有被其他案件处理的情况时,这是典型调用。同一消息的两次是非法藏匿;这样做会导致一个IllegalStateException被抛出。藏匿也可以此情况下,调用stath()能会导致容量违规,这导致StashOverflowException。藏匿的容量可以使用邮箱的配置的藏匿容量设置(一个Int类型)进行配置。

调用unstashAll()从藏匿到角色的邮箱进入队列消息,直到信箱(如果有的话)已经达到的能力(请注意,从藏匿处的消息前加上邮箱)。如果一个有界的邮箱溢出,一个MessageQueueAppendFailedException被抛出。在调用unstashAll()后,藏匿保证为空。

藏匿由scala.collection.immutable.Vector支持。这样一来,即使是非常大量的消息在不会对性能产生重大影响下被藏匿。

注意,藏匿是短暂的角色状态的一部分,该邮箱不像。因此,应该像具有相同属性的角色状态的其他部分进行管理。该preRestart的UntypedActorWithStash的实现将调用unstashAll(),它通常是所期望的行为。

注意:如果要强制执行,你的角色只能用一个无上限stash进行工作,那么你应该使用UntypedActorWithUnboundedStash类代替。

杀死一个角色

您可以通过发送一个

kill消息杀一个角色。这将导致角色抛出一个

ActorKilledException,引发故障。角色将暂停运作,其监管这将被要求如何处理失败,这可能意味着恢复的角色,重新启动,或完全终止它。请见 监管手段以获取更多信息。

使用Kill像下面:

victim.tell(akka.actor.Kill.getInstance(), ActorRef.noSender());

角色与异常

在消息被actor处理的过程中可能会抛出异常,例如数据库异常。

消息会怎样

如果消息处理过程中(即从邮箱中取出并交给receive后)发生了异常,这个消息将被丢失。必须明白它不会被放回到邮箱中。所以如果你希望重试对消息的处理,你需要自己抓住异常然后在异常处理流程中重试. 请确保你限制重试的次数,因为你不会希望系统产生活锁 (从而消耗大量CPU而于事无补)。另一种可能性请查看PeekMailbox pattern

邮箱会怎样

如果消息处理过程中发生异常,邮箱没有任何变化。如果actor被重启,邮箱会被保留。邮箱中的所有消息不会丢失。

角色会怎样

如果角色内代码抛出了异常,那么角色将被暂停,接着监管者处理开始(见监管与监控)。依赖监管者决策角色将被恢复(就像什么事情没发生),重启(擦除内部状态重新开始)或终止。

初始化模式

角色钩子的丰富的生命周期提供了实现各种初始化模式的有用工具。在一个ActorRef的生命周期,一个角色可能会经历多次重新启动后,当旧的实例替换为新的,对外面观察这是不可见的,仅仅看见ActorRef。

有人可能会想到“化身”的新实例。初始化可能需要一个角色的每一个化身,但有时人们需要初始化仅发生在第一个实例诞生时,当ActorRef被创建。以下各节提供的模式为不同的初始化需求。

通过构造函数初始化

使用构造函数初始化有着各种好处。首先,它使得有可能使用的val字段来存储任何状态,这并不在角色实例的生命周期中变化,使得角色实现更加健壮。该构造函数被角色的每一个化身调用,所以角色的内部总是可以认为正确的初始化发生。这也是这种方法的缺点,因为有当一个人想避免在重新启动时重新初始化的内部情况。例如,在重启过程,保持整个子角色通常是有用。以下部分提供了这种情况下的模式。

通过preStart初始化

在的第一个实例的初始化过程中,一个角色的preStart()方法仅仅被直接调用一次,那就是,在ActorRef的创建。在重新启动的情况下,preStart()从postRestart()被调用,因此,如果不重写,preStart()被每一个化身调用。然而,覆盖postRestart(),可以禁用此行为,并确保只调用一次preStart()。

这种模式的一个有用的用法是在重新启动时禁止创建子类新的ActorRef。这可以通过覆盖preRestart()来实现:

@Override

public void preStart() {

// Initialize children here

}

// Overriding postRestart to disable the call to preStart()

// after restarts

@Override

public void postRestart(Throwable reason) {

}

// The default implementation of preRestart() stops all the children

// of the actor. To opt-out from stopping the children, we

// have to override preRestart()

@Override

public void preRestart(Throwable reason, Option message)

throws Exception {

// Keep the call to postStop(), but no stopping of children

postStop();

}

请注意,该子角色还在重新启动,但不会创建新的ActorRef。对子类可以递归应用相同的原则,确保他们的preStart()方法被只在创建自己的引用时调用。

了解更多信息,请参阅What Restarting Means:

通过消息传递初始化

有这样的情况,在构造函数中,当它是不可能传递所需的所有角色初始化的信息,例如,在存在循环的依赖关系。在这种情况下,角色应该听一个初始化消息,并利用become()或有限状态机的状态对角色的初始化和未初始化的状态进行编码。

private String initializeMe = null;

@Override

public void onReceive(Object message) throws Exception {

if (message.equals("init")) {

initializeMe = "Up and running";

getContext().become(new Procedure() {

@Override

public void apply(Object message) throws Exception {

if (message.equals("U OK?"))

getSender().tell(initializeMe, getSelf());

}

});

}

}

如果在初始化之前,角色可以接收消息,一个有用的工具可能是Stash,可以保存消息直到初始化完成,在角色初始化之后重新放回。

注意:这个模式应小心使用,并且当上述的模式都不适用才使用。其中一个潜在的问题是,消息可能会在发送给远程角色丢失。另外,在未初始化状态发布一个ActorRef可能导致在其接收用户信息的初始化之前已经完成。

内容简介 本书将尝试帮助入门级、中级以及高级读者理解基本的分布式计算概念,并且展示 如何使用 Akka 来构建具备高容错性、可以横向扩展的分布式网络应用程序。Akka 是一 个强大的工具集,提供了很多选项,可以对在本地机器上处理或网络远程机器上处理的 某项工作进行抽象封装,使之对开发者不可见。本书将介绍各种概念,帮助读者理解 网络上各系统进行交互的困难之处,并介绍如何使用 Akka 提供的解决方案来解决这些 问题。 作者简介 Jason Goodwin 是一个基本上通过自学成才的开发者。他颇具企业家精神,在学校 学习商学。不过他从 15 岁起就开始学习编程,并且一直对技术保持着浓厚的兴趣。这对 他的职业生涯产生了重要的影响,从商学转向了软件开发。现在他主要从事大规模分布 式系统的开发。在业余时间,他喜欢自己原创电子音乐。 他在 mDialog 公司第一次接触到 Akka 项目。mDialog 是一家使用 Scala/Akka 的公司, 为主流出商提供视频广告插入软件。这家公司最终被 Google 收购。他同时还是一名很 有影响力的“技术控”,将 Akka 引入加拿大一家主要的电信公司,帮助该公司为客户提 供容错性更高、响应更及时的软件。除此之 外,他还为该公司中的一些团队教授 Akka、 函数式以及并发编程等知识。 目录 第 1 章 初识 ActorAkka 工具集以及 Actor 模型的介绍。 第 2 章 Actor 与并发:响应式编程。Actor 与 Future 的使用。 第 3 章 传递消息消息传递模式。 第 4 章 Actor 的生命周期—处理状态与错误:Actor 生命周期、监督机制、Stash/ Unstash、Become/Unbecome 以及有限自动机。 第 5 章 纵向扩展:并发编程、Router Group/Pool、Dispatcher、阻塞 I/O 的处理以 及 API。 第 6 章 横向扩展—集群化:集群、CAP 理论以及 Akka Cluster。 第 7 章 处理邮箱问题:加大邮箱负载、不同邮箱的选择、熔断机制。 第 8 章 测试与设计:行为说明、领域驱动设计以及 Akka Testkit。 第 9 章 尾声:其他 Akka 特性。下一步需要学习的知识。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值