入门

准备工作

Akka要求安装 Java 1.6或更高版本。

入门指南和模板工程

最好的学习Akka的方法是下载“Typesafe Activator”并且尝试一下其中的Akka模板工程。

下载

下载Akka有几种方法。你可以通过下载Typesafe平台来下载Akka(如前所述)。你可以下载包含微内核的完整发布包(包含所有的模块)。或者也可以使用构建工具如Maven或SBT从Akka Maven仓库下载依赖。

模块

Akka的模块化做得非常好,它为不同的功能提供了不同的Jar包。

  • akka-actor – 标准Actor, 类型Actor,IO Actor等。
  • akka-agent – Agent,与 Scala STM 集成
  • akka-camel – Apache Camel 集成
  • akka-cluster – 集群成员管理,弹性路由器。
  • akka-kernel – Akka 微内核来运行简单应用服务器
  • akka-osgi – 在OSGi容器中使用Akka的基本组件,包含akka-actor类
  • akka-osgi-aries – Aries 的actor系统蓝图
  • akka-remote.jar – 远程Actor
  • akka-slf4j.jar – SLF4J日志(事件总线监听器)
  • akka-testkit.jar – Actor系统的测试工具包
  • akka-zeromq – ZeroMQ 集成

部署模型

  • 作为一个jar包
  • 微内核

使用构建工具

Akka可以与支持Maven仓库的构建工具一起使用。

通过Maven使用Akka

这是akka-actor的依赖:

    <dependency>
      <groupId>com.typesafe.akka</groupId>
      <artifactId>akka-actor_2.10</artifactId>
      <version>2.3.6</version>
    </dependency>

通过SBT使用Akka

通过SBT使用Akka的要点:

SBT安装指导 https://github.com/harrah/xsbt/wiki/Setup

build.sbt 文件:

name := "My Project"

version := "1.0"

scalaVersion := "2.10.4"

resolvers += "Typesafe Repository" at "http://repo.typesafe.com/typesafe/releases/"

libraryDependencies +=
  "com.typesafe.akka" %% "akka-actor" % "2.3.6"

注意:以上的libraryDependencies设置需要SBT 0.12.x或更高的版本。如果你使用更老版本的SBT,libraryDependencies需要这样设置:

libraryDependencies +=
  "com.typesafe.akka" % "akka-actor_2.10" % "2.3.6"

Using Akka with Gradle

需要 Gradle 1.4 及以上的版本来使用 Scala 插件

apply plugin: 'scala'

repositories {
  mavenCentral()
}

dependencies {
  compile 'org.scala-lang:scala-library:2.10.4'
}

tasks.withType(ScalaCompile) {
  scalaCompileOptions.useAnt = false
}

dependencies {
  compile group: 'com.typesafe.akka', name: 'akka-actor_2.10', version: '2.3.6'
  compile group: 'org.scala-lang', name: 'scala-library', version: '2.10.4'
}