http://ifeve.com/akka-doc-java-getting-started/

AKKA文檔（java版）——準備開始

原文：http://doc.akka.io/docs/akka/2.3.6/intro/getting-started.html? 譯者：吳京潤

預備知識

AKKA要求你的計算機已經安裝了Java1.6或更高版本。

入門指南與模板項目

學習AKKA的最好方式是下載Typesafe Activator并嘗試一個AKKA模板項目。

下載

有許多種下載AKKA的方式。你可以把它當作Typesafe平臺的一部分下載（就像上面描述的）。還可以下載完全發布版，它包含微內核以及所有模塊。或者使用像Maven或SBT這樣的構建工具從AKKA Maven倉庫下載依賴。

模塊

AKKA是調度模塊化的，它由許多擁有不同特性的JAR組成。

• akka-actor?– 經典角色、類型角色、IO角色等。
• akka-agent?– 代理、整合了Scala的STM特性
• akka-camel?– 整合Apache的Camel
• akka-cluster?– 集群成員管理、彈性路由
• akka-kernel?– AKKA微內核，運行著一個極簡應用服務器
• akka-osgi?– 在OSG容器里使用AKKA的基本bundle，包括akka-actor的類
• akka-osgi-aries?– Aries——服務提供角色系統的藍圖
• akka-remote?– 遠程角色
• akka-slf4j?– SLF4J Logger (事件總線監聽器)
• akka-testkit?– 測試角色系統的工具包Toolkit for testing Actor systems
• akka-zeromq?– 整合ZeroMQ

除了這些已進入穩定內核的穩定模塊之外，還有許多標記為“試驗（experimental）”的模塊。這并不是意味著它們沒有達到預期的功能，它的主要意義是它些模塊的API尚不夠穩定。你可以通過郵件列表向我們反饋這些模塊的使用情況，幫助加快這一進程。

• akka-contrib?– 提交者貢獻的各種模塊可能會也可能不被移到核心模塊，見外部貢獻了解更多細節。

一個實際的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的快照版、每日構建版和里程碑版。

微內核

AKKA的發布版擁有一個微內核。將你的應用JAR放到deploy目錄并運行bin?目錄下的腳本。

更多信息請見微內核（Scala）|（Java）

使用構建工具

AKKA可以使用支持Maven倉庫的構建工具

Maven倉庫

從AKKA2.1-M2版開始：

Maven中央倉庫

之前的版本：

AKKA倉庫?Typesafe倉庫

通過Maven使用AKKA

開始使用AKKA和Maven的最簡單的方式是檢出Typesafe Activator名為Akka Main in Java的教程。

既然AKKA發布到了Maven中央倉庫（從v2.1-M2開始），當然可以通過POM添加AKKA依賴。比如下面就是akka-actor模塊的依賴

查看源代碼 打印幫助

1	<dependency>

2	????<groupId>com.typesafe.akka</groupId>

3	????<artifactId>akka-actor_2.10</artifactId>

4	????<version>2.3.6</version>

5	</dependency>

注意：對于快照版，SNAPSHOT?與時間戳版本同時發布。

通過SBT使用AKKA

最簡單的方法是檢出Akka/SBT template工程。

SBT中的AKKA的必要部分：

SBT安裝指南：https://github.com/harrah/xsbt/wiki/Setup

build.sbt文件：

查看源代碼 打印幫助

1

</pre>

2	<pre>name:="My Project"

3	version:="1.0"

4	scalaVersion:="2.10.4"

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

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

注意：在上面的libraryDependencies設置中，指定SBT版本為v0.12.x或更高版本。如果你使用較早的SBT版本，libraryDependencies應像下面這樣：

查看源代碼 打印幫助

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

通過Gradle使用AKKA

要求至少是Gradle1.4以上，包含Scala插件。

查看源代碼 打印幫助

01	apply plugin:'scala'

02	repositories {

03	????mavenCentral()

04

}

05	dependencies {

06	????compile 'or.scala-lang:scala-library:2.10.4'

07

}

08	tasks.withType(ScalaCompile) {

09	????scalaCompileOptions.useAnt=false

10

}

11	dependencies {

12	????compile group: 'com.typesafe.akka', name: 'akka-actor_2.10', version: '2.3.6'

13	????compile group: 'org.scala-lang', name: 'scala-library', version: '2.10.4'

14

}

在Eclipse中使用AKKA

安裝SBT工程然后使用sbteclipse生成Eclipse工程。

在IntelliJ IDEA中使用AKKA

安裝SBT工程然后使用?sbt-idea生成IntelliJ IDEA工程。

在NetBeans中使用AKKA

安裝SBT工程然后使用?nbsbt?生成NetBeans工程。

你同樣應該為IDE對scala的通用支持使用?nbsbt?。

不要使用Scala編譯器優化選項 -optimize

警告

從沒有使用Scala編譯器的-optimize選項編譯或測試過akka。有嘗試過的用戶報告使用該選項發生了奇怪的行為。

從源碼構建

Akka使用Git托管在Github上。

• 從http://github.com/akka/akka克隆Akka倉庫

更多內容參考構建Akka

需要幫助？

如果你有問題可以從Akka郵件列表獲得幫助。

你也可以獲取商業支持。

感謝您成為AKKA社區的一員。

?

譯者注：本人正在翻譯AKKA官網文檔，本篇是文檔第一章，歡迎有興趣的同學加入一起翻譯。更多內容請讀這里：https://tower.im/projects/ac49db18a6a24ae4b340a5fa22d930dc/todos/640e53d6e8c149ab95c47cd333b91073/?

原創文章，轉載請注明： 轉載自并發編程網 – ifeve.com

總結

以上是生活随笔為你收集整理的AKKA文档（java版）——准备开始的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。