集成Akka

Integrating with Akka

Akka 使用Actor模型来提升抽象等级并且提供一个更好的平台去构建正确的并发和可扩展的应用。对于容错它采用了Let it crash模型，这是很成功的应用在电信行业构建一个永不停止的自愈系统。Actor提供了对于transparent distribution和基本的真正可拓展和容错的应用。

The application actor system

Akka可以使用一些称作actor systems的容器。一个actor system 管理它的配置资源用于运行他所包含的actors.

一个Play应用定义了一个特殊的actor system被自身使用。这个actor system跟随着这个应用的生命周期并且会自动的重启当应用重启的时候。

Writing actors

想要使用Akka，你需要写一个actor.下面是一个简单的actor.

package actors;

import akka.actor.*;
import actors.HelloActorProtocol.*;

public class HelloActor extends UntypedActor {

    public static Props props = Props.create(HelloActor.class);

    public void onReceive(Object msg) throws Exception {
        if (msg instanceof SayHello) {
            sender().tell("Hello, " + ((SayHello) msg).name, self());
        }
    }
}

注意这里的HelloActor定义了一个static field叫做props，它返回一个Props对象用于描述如何创建这个actor。这是一个非常好的Akka惯例，用来分离实例化的逻辑从创建actor的代码中。

这里有一个best practice。把HelloActor发送和接收定义为static inner classes叫做HelloActorProtocol:

package actors;

public class HelloActorProtocol {

    public static class SayHello {
        public final String name;

        public SayHello(String name) {
            this.name = name;
        }
    }
}

Creating and using actors

创建或是使用一个actor,你需要一个ActorSystem.可以通过申明一个依赖来获得，然后你可以使用actorOf方法去创建一个新的actor.

最基本的事情就是你可以给一个actor发送一个message.当你发送一个message给一个actor，没有响应, it`s fire and forget.这也被称作tell模式.

然而在一个web应用中,tell模式通常是没有用的，因为HTTP协议是一个request和responses.在这种情况下，你可能想要的是一个ask模式.这个ask模式返回一个Scala的Future,你可以通过使用scala.compat.java8.FutureConverts.toJava来转换为Java的CompletionStage.

下面是一个使用ask模式的HelloActor的例子：

import akka.actor.*;
import play.mvc.*;
import scala.compat.java8.FutureConverters;
import javax.inject.*;
import java.util.concurrent.CompletionStage;

import static akka.pattern.Patterns.ask;//need imported

@Singleton
public class Application extends Controller {

    final ActorRef helloActor;

    @Inject public Application(ActorSystem system) {
        helloActor = system.actorOf(HelloActor.props);
    }

    public CompletionStage sayHello(String name) {
        return FutureConverters.toJava(ask(helloActor, new SayHello(name), 1000))
                .thenApply(response -> ok((String) response));
    }
}

有一些需要注意的地方：

• ask模式需要被导入，静态导入ask通常是最方便的方式。
• 返回的future被转换为CompletionStage.这导致promise是一个CompletionStage