Skip to content

Latest commit

 

History

History
412 lines (280 loc) · 24 KB

akka.md

File metadata and controls

412 lines (280 loc) · 24 KB

#Akka

Hello World

Akka手册

概述

2.1 术语和概念

2.1.1 并发与并行

并发和并行是类似的概念,但是有一些不同.并发意味着两个或多个task是有进度的,它们可能并不是同时执行的.一个简单的例子是通过时间片切分让task的某些部分和其它task的部分顺序执行.而并行则是真正意义上的同时执行.

2.1.2 异步 vs. 同步

如果调用者在函数调用返回或者抛出异常之前不能继续执行的话,该调用方法就是同步的.相反,异步调用允许调用者在有限的步骤后继续执行,在方法结束后可以通过一些附加机制来被唤醒(可以注册回调,future或者message).

同步API可能会用阻塞来实现同步,但这不是必须的.CPU密集型任务的行为可能会和阻塞相似.总的来说,还是建议用户使用异步API,只要他们确保系统可以继续执行. Actor模式天生就是异步的: 一个actor可以在发送完一个消息后继续执行别的任务,而不需要等到发送行为真正发生.

2.1.3 非阻塞 vs. 阻塞

如果一个线程的延迟可以无限期的影响到其他线程,这就是阻塞. 一个很好的例子是被某个线程互斥使用的资源. 如果一个线程无限期持有该资源(比如运行在一个无线循环中)而其他等待该资源的线程则无法继续执行.相反的, 非阻塞意味着没有线程可以无限期的延迟别的线程.

相比阻塞操作, 我们更倾向于非阻塞操作, 因为如果包含阻塞操作的话, 系统的整体运行无法被保证.

2.1.4 死锁 vs. 饥饿 vs. 活锁

死锁是在几个参与者互相等待达到某一个状态而无法继续运行的时候形成的. 在其他参与者没有达到某一种状态的时候, 没有人可以继续执行, 最终影响整个系统. 死锁和阻塞的概念很相关, 需要某个参与线程能够无限期延迟其他线程的执行.

在死锁的情况下, 没有参与者可以继续进行. 相反的是饥饿现象, 这时候有某些参与者可以继续执行, 但是有些却永远不能. 典型的场景是一个简单的调度算法, 每次都优先选择优先级高的作业. 如果高优先级的作业持续到来的话, 那么低优先级的作业就永远没有执行的机会.

活锁和死锁类似, 也是没有参与者可以继续运行. 区别在于活锁在等待其他线程处理的状态中不是被冻结, 而是参与者不断改变状态. 一个例子是当两个参与者分别有两份独立资源的时候. 他们互相试图获取资源, 但是它们也互相检测对方时候需要资源. 如果某个资源被另一个参与者请求了, 他们就试图获取另外一份实例. 在极端情况下会出现两个参与者在两份资源之间来回跳跃, 却永远不会获取, 总是让给另外一个人.

2.1.5 竞争条件

当一系列事件集合的顺序可能被外部非确定影响所违反时, 我们称之为竞争条件. 竞争条件通常在多个线程使用一个共享可变状态的时候发生, 线程在某个状态的操作可能会被非预期的行为所交错. 共享状态并不是产生竞争条件的必要条件. 一个例子是客户端发送无序的包P1, P2给服务器. 因为包可能会走不同的网络路由, 因为服务器可能会先收到P2再收到P1. 如果没有包含它们之间的顺序信息, 那么服务端就不可能知道它们发送的顺序错乱了. 在这种情况下就会导致竞争条件.

*** 注意: Akka为消息传递提供的唯一保证就是一对actor之间的消息始终是保序的. ***

2.1.6 非阻塞保证(过程条件)

如前面章节所述阻塞通常是导致几种异常的原因, 包括死锁和系统吞吐降低. 在下面几节我们讨论几种非阻塞的属性.

Wait-freedom

如果每次调用可以确保在有限的步骤内完成则称之为wait-free. 如果这些步骤有一个上界则称之为bounded wait-free.

从这个定义来看, wait-free方法永远不会阻塞, 因此也不会发生死锁. 此外, 每个参与者都可以在有限步骤后继续运行, wait-free方法也不存在接现象.

Lock-freedom

Lock-freedom的语义比wait-freedom较弱. 在lock-free场景下, 总有一些方法可以在有限步骤内结束. 这个定义意味着lock-free调用不会有死锁出现. 另一方面, 有一些方法可以在有限步骤内结束不足以保证所有的调用最终都能结束. 换言之, lock-freedom不足以避免饥饿现象.

Obstruction-freedom

TODO.

2.2 Actor系统

Actors是封装了状态和行为的对象, 他们通过交换信息(存储在接受者的mailbox中)来完成通信. 在某种意义上, actors是最严格的面向对象编程, 它们可以被视为一个一个人: 通过actors建立解决方案, 分配出子任务划分给一组人, 将函数分配成一个组织结构并且考虑容错. 最终Actor可以形成一个构建软件的脚手架.

2.2.1 分级结构

TODO.

Actors

3.1 Actors

Actors模型提供了写并发和分布式系统的高层抽象. 它使得开发者不用处理显示的锁和线程管理, 可以更容易的写出正确的并发和并行系统. Actors在1973年Carl Hewitt的论文中首次提出并在Erlang语言中流行起来, 被爱立信成功的用于构建高并发和高可用的电信系统.

Akka Actor的API和Scala的Actor很类似, 都从Erlang中借鉴了一些语法.

3.1.1 创建Actors

注意: 因为Akka强制父监控, 每个actor都被监控并且要监控它的孩子, 建议你熟悉下Actor Systems, Supervision和Monitoring, 最好也阅读下Actor References, Paths和Addresses.

定义Actor class

Actor类通过扩展Actor基类并且实现receive方法来实现. receive方法需要定义一系列case状态机来定义该Actor可以处理的消息(使用Scala的模式识别)以及如何处理该消息.

这里有一个例子:

import akka.actor.Actor
import akka.actor.Props
import akka.event.Logging

class MyActor extends Actor {
	val log = Logging(context.system, this)
	def receive = {
		case "test" => log.info("receive test")
		cast _      => log.info("received unkown message")
	}
}

请注意Akka Actor的receive消息循环是完整的, 这和Erlang和Scala Actor不一样. 这意味着你需要提供一个所有消息的模式匹配, 如果你想处理未知的消息, 你需要提供一个default case. 否则会有一个akka.actor.UnhandleMessage(message, sender, recipient)会发布到ActorSystem的EventStream.

注意receive的返回类型是Unit;如果actor需要对收到的消息进行回复那么必须如下文显示操作.

receive方法的结果是一个partial function对象, 该对象会被actor保存作为"初始行为", 如果在actor创建后向修改该行为可以参见Become/Unbecome.

Props

Props是一个在创建actor时指定选项的配置类, 你可以认为它是一个不可变量, 因此创建带有部署信息的actor时可以自由共享. 这里有几个创建Props实例的例子:

import akka.actor.Props

val props1 = Props[MyActor]
val props2 = Props[new ActorWithArgs("arg")) // careful, see below
val props3 = Props(calssOf[ActorWithArgs], "arg")

第二个变量声明展示了如果在创建Actor的时候传递构造参数, 这种方法只能用在actor外部.

最后一行TODO

危险的声明
// NOT RECOMMENDED with another actor:
// encourages to close over enclosing class
val props7 = Props(new MyActor)

该方法在另一个actor内部不建议使用, 因为它鼓励close over the enclosing scope, 导致Props不可序列化并有可能导致竞争条件(打破了actor封装). 我们会在未来的版本中提供一个宏来支持相似的语法, 在目前该声明会被丢弃. 另外也可以在actor的伴随对象的Props工场中做这种声明.

这里有这些方法的两个use-case: 为actor传递参数-可以通过新引入的Props.apply(clazz, args)方法来解决, 或者在本地匿名类中创建actor. 后一种方法可以用actor来命名类(如果在最上层object中没有声明, 那么需要把该instance的this引用作为第一个参数传递进去)

Warning: 在一个actor中声明另一个actor是十分危险的, 会破坏actor的封装. 永远不要把actor的this引用传递给Props!

建议实践

在每个Actor的伴随对象中提供一个工厂方法可以保证Props的创建和actor的定义尽可能的接近.这可以避免使用Props.apply(...)方法使用传名引用的陷阱, 因为伴随对象的代码段在作用域范围内不会维持引用.

object DemoActor {
	/**
	 * Create Props for an actor of this type.
	 * @param magicNumber The magic number to be passed to this actor's constructor.
	 * @return a Props for creating this actor, which can then be further configured
 	 * (e.g. calling `.withDispathcer()` on it)
 	 * /
 	def props(magicNumber: Int): Props = Props(new DemoActor(magicNumber))
}

class DemoActor(magicNumber: Int) extends Actor {
	def receive = {
		case x: Int => sender() ! (x + magicNumber)
	}
}

class SomeOtherActor extends Actor {
	// Props(new DemoActor(42)) would not be safe
	context.actorOf(DempActor.props(42), "demo")
	// ...
}
通过Props创建Actor

Actors可以通过向Props市里传递给actorOf工厂方法来创建, actorOf方法是ActorSystem和ActorContext提供的.

import akka.actor.ActorSystem

// ActorSystem is a heavy object: create only one per application
val system = ActorSystem("mySystem")
val myActor = system.actorOf(Props[MyActor], "myactor2")

使用ActorSystem可以创建顶层actor, 该actor由actor系统提供的监控actor监管, 使用actor的context可以创建一个子actor.

class FirstActor extends Actor {
	val child = context.actorOf(Props[MyActor], name = "myChild")
	// plus some behavior ...
}

强烈建议创建子, 孙子的层次结构, 这样和应用的逻辑容错处理结构吻合, 参见ActorSystems.

调用actorOf会返回一个ActorRef实例. 这是一个actor实例的handler并且是唯一可以与它交互的方式. ActorRef是不可变的, 并且和Actor之间有一对一的关系. ActorRef是可序列化并且可以网络感知的. 这意味着你可以序列化, 发送到网络上并且在一个远程机器上使用并且它仍然代表着同一个原始节点的actor.

其中name参数是可选的, 但是你必须为你的actor的命名, 因为它要被用来记录消息区分. 命名不能为空或者以$开头, 但是可以包含URL加密的字符(eg. %20代表空格). 如果给定的名字已经被另一个子actor使用会抛出InvalidAQctorNameException异常.

Actor在创建后会自动异步启动.

依赖侵入

如上文所述, 如果你的Actor有一个带参构造函数那么它必须称为Props的一部分. 但有时候当必须使用工场方法, 例如当实际构造参数是由依赖侵入框架锁决定的.

import akka.actor.IndirectActorProducer

class DependencyInjector(applicationContext: AnyRef, beanName: String)
	extends IndirectActorProducer {
	override def actorClass = classOf[Actor]
	override def produce = 
		// obtain fresh Actor instance from DI framwork ...
}

val actorRef = system.actorOf(
	Props(classOf[DependencyInjector], applicationContext, "hello"),
	"helloBean")

Warning: 有时候你可能被诱导提供一个IndirectActorProducer, 让它总是返回一个相同的instance, e.g. 使用一个lazy val. 这是不支持的, 因为它和一个actor充气的意义不符, 在这里有讨论: 重启意味着什么. 当使用依赖侵入框架时, actor必须有单例作用域

收件箱

当在actor外部写需要和actor交互的代码时, ask模式是一个解决方案, 但是你不能做以下两件事: 接受多个回复(e.g. 订阅一个ActorRef到一个通知服务), 观察其他actor的生命周期. 为了实现这些功能诞生了Inbox类:

implicit val i = inbox()
echo ! "hello"
i.receive() should be("hello")

这里有一个从inbox到actor引用的隐式转换, 这意味着在这个例子里sender引用会被隐藏. 因为允许在最后响应接收信息. Watch一个actor也很简答:

val target = // some actor
val i = inbox()
i watch target
3.1.2 Actor API

Actor特质只定义了一个抽象方法, 就是上文中出现的receive, 该方法实现了actor的行为.

如果当前actor的行为和接收到的消息不匹配, unhandled会被调用并将一个akka.actor.UnhandledMessage(message, sender, recipient)发布到acotr系统事件流(可以在akka.actor.debug.unhandled中设置将错误信息转换为debug消息).

此外, 还提供了: self 该actor的ActorRef引用.

sender 最后接收的消息的发送者actor引用, 通常用于回复消息.

supervisorStrategy 用户重写该策略以管理子actor. 该策略通常在acotr内部声明, 以便通过决策函数获取actor内部状态: 因为错误信息和其他信息一样, 都会被发送给管理者, 该actor的所有值和变量通过sender引用都可以获取到.

context 暴露该actor的上下文信息和当前当前消息, 如:

  • 用于创建子actor的工场方法(actorOf)
  • 该actor属于的系统
  • 父管理者
  • 所有管理的子actor
  • 生命周期监控
  • 热插拔行为栈(Become/Unbecome)

你可以引用context成员来省略context.前缀: class FirstActor extends Actor { import context._ val myActor = actorOf(Props[MyActor], name = "myactor") def receive = { case x => myActor ! x } }

此外一些可见的方法是需要用户重写的生命周期hook方法:

def preStart(): Unit = ()

def postStop(): Unit = ()

def preRestart(reason: Throwable, message: Option[Any]): Unit = {
	context.children foreach { child =>
		context.unwatch(child)
		context.stop(child)
	}
	postStop()
}

def postRestart(reason: Throwable): Unit = {
	preStart()
}

上面的实现是actor特质默认提供的.

Actor生命周期

actor系统中的路径表示一个可能被一个活跃actor占据的"地址". 最初路径是空的(系统初始actor除外). 当调用actorOf()方法时, 通过向Props传递指定路径来分配一个该actor的化身. actor的化身由路径和一个UID唯一标识. 重启操作仅仅交换由Props定义的actor实例, 化身保持不变, 因此UID也不变.

该化身的生命周期在actor停止的时候结束. 此时适当的生命周期事件会被调用, 处于监控状态的actor会收到通知. 在该化身结束后, 该路径可以通过actorOf方法重用. 此时新化身的名称和之前一样但是UID不同.

ActorRef始终表示一个化身(路径和UID)而不仅仅是一个给定的路径. 因此如果一个actor停止并且创建了一个新的同名actor, 旧化身的ActorRef不会指向新的.

ActorSelection也指向该路径并且无视当前哪个化身正占据该路径. 因此ActorSelection不能被watch. 可以通过向ActorSelection发送Identify消息来获取该路径下的ActorRef, 该消息会返回一个包含正确引用的ActorIdentify结构. 具体可以通过ActorSelection的resolveOne方法, 该方法返回一个匹配ActorRef的Future.

生命周期监控(DeathWatch)

当一个actor终止时(i.e. 永久结束, 非临时错误或重启), 为了得到通知, 该actor需要将自己的终止消息注册到其他actor上(参见Stopping Actors). 该服务是由actor系统的DeatchWatch组件提供的.

注册一个监控很简单: import akka.actor.{ Actor, Props, Terminated }

class WatchActor extends Actor {
	val child = context.actorOf(Props.empty, "child")
	context.watch(child) // <- this is the only call needed for registration
	var lastSender = system.deadLetters

	def receive = {
		case "kill" =>
			context.stop(child); lastSender = sender()
		case Terminated(`child`) => lastSender ! "finished"
	}
}

需要注意终止消息的生成的顺序和注册以及终止发生的顺序是独立无关的. 特别是, 即使被观察的actor在注册的时候已经终止了, 观察者actor一样也会收到终止消息.

重复注册多次不会多次生成消息, 但是不能保证只收到一个消息: 如果被观察的actor终止并且将消息放入队列了, 而在这个消息被处理之前另一个注册刚好完成了, 这时候队列中会再次放入一个消息, 因为一个已经终止的actor注册监控将会立即生成一个终止消息.

也可以通过context.unwatch(target)方法来解注册监控另一个actor的存活状态. 这在终止消息被放入mailbox以后也是有效的, 只要调用unwatch方法该actor的所有终止消息都不会再被处理了.

Start Hook

所有的actor通过一个容错策略链接到另一个actor, 都可以被监控起来. Actors可能在处理某个消息的时候重启了, 该重启可能会设计到以下几个hook:

  1. 旧actor通过调用preRestart方法可以得到导致重启的异常和触发异常的消息; 如果重启不是由于处理某个消息导致的, 那么第二个参数为空, e.g. 当监控着不处理异常并且由监控者控制重启, 或者actor由于兄弟节点的错误导致重启. 如果消息可用, 那么消息的发送者通常也可以获取到(通过调用sender).
  2. actorOf调用的工场方法用于生成新的实例.
  3. 新actor的PostRestart方法在异常重启时被调用. 默认preStart会被调用, 就像正常启动一样.

actor重启只替换实际的actor对象; mailbox的内容在重启时不收影响, 所以在postRestart hook返回后可以继续处理消息. 导致异常的消息不回再被接受. 任何发送给正在重启的actor的信息都会正常的放入它的mailbox.

Warning: 注意错误通知的顺序和相关的用户消息不是确定的. 特别的, 父actor可能会在它处理最后一条子actor发送过来的消息时重启该子actor. 参见讨论: 消息顺序.

Stop Hook

在停止某个actor之后, 它的postStop会被调用, 这可以用于e.g. 向其它服务解注册该actor. 该hook可以确保在所有队列的消息已被禁用后才被调用, i.e. 发送给停止的actor的消息会被转送到ActorSystem的deadLetters.

3.1.3 通过Actor Selection区分Actor

如同Actor Reference, Path和Address描述的那样, 每个actor都有独立的逻辑地址, 该地址可以通过追踪actor链来获取(该链从子到父直到actor系统的根); actor还有一个物理地址, 如果监控者的链包含了任何远程监控者, 该地址会发生变化. 这些地址都是让系统寻找actor的, e.g. 当接受到一个远程消息时可以找到接受者, 该地址还有更直接的用处: actor可能会通过指明绝对或相对路径来寻找其他acotr-不管是物理地址还是逻辑地址-并且接收到ActorSelection的结果:

// will look up this absolute path
context.actorSelection("/user/serviceA/aggregator")
// will look up sibling beneath same supervisor
context.actorSelection("../joe")

提供的路径按照java.net.URI来解析, 这意味着路径元素是用/分割的. 如果路径以/开始, 它就是绝对路径并且搜寻会从根("/user"的父)开始查找; 否则就是从当前actor开始. 如果路径元素等于.., 那么就会从当前actor的上一层监控者地址开始查找. 需要注意在actor路径中..始终表示逻辑结构, i.e.监控者.

actor selection的路径元素可能会包含通配符, 允许消息广播:

// will look all children to serviceB with names starting with worker
context.actorSelection("/user/serviceB/worker*")
// will look up all siblings beneath same supervisor
context.actorSelection("../*")

消息可以通过ActorSelection来传递, ActorSelection的路径会在传递消息的时候查找. 如果该selection不匹配任何actors则该消息将被丢弃.

为了ActorSelection获取一个ActorRef你需要发送一个消息给selection并且使用sender引用来回复. 这是一个系统内建的Identify消息, 所有的actor都可以识别并且自动回复一个包含ActorRef的ActorIdentity消息. 该消息会被actors which are traversed特殊处理, 如果一个具体的名称查找失败了, 会生成负结果. 请注意这不意味着该回复消息一定会被发送, 这仍然只是一条普通消息.

import akka.actor.{ Actor, Props, Identity, ActorIdentity, Terminated }

class Follower extends Actor {
	val identifyId = 1
	context.actorSelection("/user/another") ! Identity(identifyId)

	def receive = {
		case ActorIdentity(`identifyId`, Some(ref)) =>
			context.watch(ref)
			context.watch(active(ref))
		case ActorIdentity(`identifyId`, Node) => context.stop(self)
	}

	def active(another: ActorRef): Actor.Receive = {
		case Terminated(`another`) => context.stop(self)
	}
}

你可以通过ActorSelection的resolveOne方法来获取一个ActorSelection的ActorRef. 如果actor存在, 它会返回一个匹配ActorRef的Future; 如果actor不存在的话会返回错误[akka.actor.ActorNotFound], 或者如果identification为完成则返回超时.

如果开启了remoting, 远程actor地址也可以被查找到:

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

在Remoting Example中给出了一个actor查找的例子.

注意: actorFor已经弃用

3.1.4 消息和不可变性

IMPORT: 消息可以是任意类型的, 但是是不可变的. Scala不能强制不可变, 所以这只能形成习惯. 原始类型如String, Int, Boolean始终是不可变的. 和这些不同的是, 建议使用Scala不可变的case class(如果你不显示地暴露状态), 在接收端用模式匹配来配合.

这里是一个例子:

// define the case class
case class Register(user: User)

// create a new case class message
val message = Register(user)
3.1.5 发送消息

消息可以通过以下方法来发送给Actor.

  • ! 意味着"fire-and-forget", e.g. 异步发送消息并立刻返回. 也称为tell.
  • ? 异步发送消息并且返回一个代表可能回复的Future. 也称为ask.

在每个发送者端消息是保序的.

***Note: 使用ask有性能隐患, 因为当超时时需要追踪某些信息, 需要将Promise过度到ActorRef并且需要通过remoting可以获取. 所以考虑到性能尽可能使用tell, 只有在必须时使用ask.

Tell: Fire-forget

这是推荐的发送消息的方法. 非阻塞等待消息. 有最好的并发和可扩展特性.

actorRef ! message

如果在一个actor内部被唤醒, 发送actor的引用会伴随着消息被隐式地传递, 接受actor可以通过sender(): ActorRef成员函数来获取. 目标actor可以通过sender() ! replyMsg来回复原始发送者.

如果被一个不是actor的实例唤醒, 发送者默认将是deadLetters的actor引用.

Ask: Send-And-Receive-Future

ask模式包含了actor和future, 因此它提供了使用模式而不是一个ActorRef方法:

import akka.pattern.{ ask, pipe }
import system.dispatcher // The ExecutionContext that will be used
case class Result(x: Int, s: String, d: Double)
case object Request

implicit val timeout = Timeout(5 seconds) // needed for `?` below

val f: Future[Result] = 
	for {
		x <- ask(actorA, Request).mapTo[Int] // call pattern directly
		s <- (actorB ask Request).mapTo[String] // call by implicit conversion
		d <- (actorC ? Request).mapTo[Double] // call by symbolic name
	} yield Result(x, s, d)

f pipeTo actorD // .. or ..
pipe(f) to ActorD

该例子阐明了ask和future的pipeTo模式, 因为这类似一种天然的融合. 请注意以上所有都是非阻塞和异步的: ask产生一个Future, for表达式组成了一个新的future, pipeTo为future安装了一个onComplete-handler来影响另一个actor的结果汇集(???)

使用ask可以像tell一样给接收actor发送消息, 接收actor必须回复sender() ! reply来完成返回Future. ask操作 //TODO ask.

3.1.6 接收消息

Actor必须实现receive方法来接受消息:

type Receive = PartialFunction[Any, Unit]

def receive: Actor.Receive

该方法返回一个PartialFunction, e.g.一个'match/case'语句, 使用Scala的模式匹配可以让消息匹配到不同的case语句. 这里有一个例子:

import akka.actor.Actor
import akka.actor.Props
import akka.event.Logging

class MyActor extends Actor {
	val log = Logging(context.system, this)
	def receive = {
		case "test" => log.info("received test")
		case _      => log.info("received unknown message")
	}
}
3.1.7 回复消息