AKKA 2.3.6 Scala 文档

入门

准备工作

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 集成

除了这些稳定的模块之外，还有一些虽然趋于稳定但仍然被标记为“实验”的模块。这并不是说他们的功能不符合预期，而主要的意思是他们的API还没有足够稳定到被认为已经固定了。你可以通过在我们的邮件组里进行反馈，来加速试验模块发布的进程。

  • akka-contrib – 一系列的Akka贡献，他们有可能被加入核心模块中，详情见外部贡献。

实际的jar包文件名会加上版本号，如akka-actor_2.10-2.3.6.jar（对其他模块也是类似）。

查看Akka模块之间的jar依赖的详情在依赖这一节中。

使用发布版

从http://akka.io/downloads 下载发布包并解压.

使用快照版

Akka的每日快照发布在 http://repo.akka.io/snapshots/， 版本号中包含 SNAPSHOT 和时间戳. 你可以选择一个快照版，可以决定何时升级到一个新的版本。Akka快照仓库也可以在 http://repo.typesafe.com/typesafe/snapshots/ 找到，此处还包含Akka模块依赖的其它仓库。

警告

不鼓励直接使用Akka快照版（SNAPSHOT）、每日构建版（nightly）和里程碑版（milestone），除非你知道自己在做什么。

微内核

Akka发布包包含微内核。要运行微内核，将你应用的jar包放到 deploy 目录下并运行 bin 目录下的脚本即可。

关于微内核的更多文档在 微内核(Scala) / 微内核(Java)。

使用构建工具

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

Maven仓库

对Akka 2.1-M2 及以后的版本：

Maven Central

对以前的Akka 版本：

Akka Repo Typesafe Repo

通过Maven使用Akka

通过Maven使用Akka最简单的入门是检出“Typesafe Activator”中的模板工程“Akka Main in Java”。

由于Akka已经发布到Maven中心仓库了（自2.1-M2版本起），所以直接在POM文件中加入Akka依赖即可。例如。这是akka-actor的依赖：

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

注意：对快照版本，SNAPSHOT和时间戳都在版本号中。

通过SBT使用Akka

通过SBT使用Akka最简单的入门是检出“Akka/SBT”模板工程。

通过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'
}

通过Eclipse使用Akka

建好SBT项目并使用 sbteclipse 来创建Eclipse项目。

通过IntelliJ IDEA使用Akka

建好SBT项目并使用 sbt-idea 来创建IntelliJ IDEA 项目。

通过NetBeans使用Akka

建好SBT项目并使用 nbsbt 来创建NetBeans项目。

你也应该使用nbscala提供的scala IDE支持

不要使用scala编译器的-optimize选项

警告

Akka并没有在scala编译器的-optimize选项下编译和测试过。尝试过这种方式的用户发现了Akka的奇怪行为。

从源码编译

Akka使用Git并托管在 Github。

具体请参考 构建Akka。

需要帮助?

如果有问题，你可以在 Akka Mailing List 获得帮助。

也可以寻求 商业支持。

感谢你成为Akka社区的一部分。