No description
Find a file
2009-07-31 20:30:47 +02:00
bin Comet support added. 2009-07-29 19:57:32 +02:00
config merged in jersey-scala and atmosphere support 2009-07-31 20:29:01 +02:00
deploy removed akka jars from deploy directory 2009-07-31 20:30:47 +02:00
docs/images added images for wiki 2009-07-31 19:47:38 +02:00
embedded-repo fixed wrong path in embedded repository 2009-07-29 17:01:13 +02:00
fun-test-java added generated protocol buffer test file 2009-07-28 13:28:51 +02:00
kernel merged in jersey-scala and atmosphere support 2009-07-31 20:29:01 +02:00
lib removed akka jars from lib directory 2009-07-31 20:30:08 +02:00
samples-java fixed performance problem in dispatcher 2009-07-28 10:45:41 +02:00
samples-scala merged in jersey-scala and atmosphere support 2009-07-31 20:29:01 +02:00
scripts fixed wrong path in embedded repository 2009-07-29 17:01:13 +02:00
util-java added protobuf, jackson, sbinary, scala-json to embedded repository 2009-07-27 21:36:22 +02:00
.gitignore merged in protocol branch 2009-07-24 00:53:22 +02:00
akka.iml fixed some major bugs + wrote thread pool builder and dispatcher config + various spawnLink variations on Actor 2009-07-01 15:29:06 +02:00
akka.ipr fixed performance problem in dispatcher 2009-07-28 10:45:41 +02:00
akka.iws concurrent mode is now per-dispatcher 2009-07-28 17:48:11 +02:00
buildfile init impl of camel bean:actor routing 2009-05-11 13:48:32 +02:00
LICENSE added apache 2 license 2009-07-13 00:53:47 +02:00
pom.xml added protobuf, jackson, sbinary, scala-json to embedded repository 2009-07-27 21:36:22 +02:00
README.textile merged in protocol branch 2009-07-24 00:53:22 +02:00

h1. Akka Actor Kernel:
__RESTful Distributed Persistent Transactional Actors__

h1. Introduction

The Akka kernel implements a unique hybrid of:
* The Actor model (Actors and Active Objects)
** Asynchronous, non-blocking highly concurrent components.
** Supervision with "let-it-crash" semantics. Components are loosely coupled and restarted upon failure.
* Software Transactional Memory (STM).
* BASE persistence - Pluggable Eventually Consistent distributed scalable persistent storage.
* Remoting - Distributed services.
* REST - JAX-RS binding.

h2. Here is a short overview

h3. The Actor model and supervisor hierarchies

"Actors":http://en.wikipedia.org/wiki/Actor_model with "Erlang OTP-style supervisors":http://www.erlang.org/doc/design_principles/sup_princ.html#5 and "embrace failure/let-it-crash" semantics to allow implementation of asynchronous, non-blocking and highly fault-tolerant systems. Sort of "SEDA":http://www.eecs.harvard.edu/~mdw/proj/seda/ in a box with highly configurable and monitorable (JMX and w3c) thread pools and message queues.

h3. Software Transactional Memory (STM)

"Software Transactional Memory (STM)":http://en.wikipedia.org/wiki/Software_transactional_memory for composable message flows. Distributed transactions will come very soon, backed up by "ZooKeeper":http://hadoop.apache.org/zookeeper/. The STM works with both persistent datastructures and in-memory datastructures (see below).

h3. BASE: Eventually Consistent Distributed persistence

Akka provides a "Eventually Consistent":http://www.allthingsdistributed.com/2008/12/eventually_consistent.html Transactional Persistent Map, Vector and Ref. Backed up by the "Cassandra":http://incubator.apache.org/cassandra/  highly scalable, eventually consistent, distributed, structured key-value store. Akka will add support for "Terracotta":http://terracotta.org, "Redis":http://code.google.com/p/redis/, "Memcached":http://www.danga.com/memcached/, "Voldemort":http://project-voldemort.com/, "Tokyo Cabinet/Tyrant":http://tokyocabinet.sourceforge.net/ and "Hazelcast":http://www.hazelcast.com/ shortly.

New nodes can be added and removed on the fly to support true scaling of cluster. The addition of Terracotta and Hazelcast will allow for atomic (ACID) transactions (non-BASE).

h3. REST

Actors can be exposed as "REST":http://en.wikipedia.org/wiki/Representational_State_Transfer services through "JAX-RS":https://jersey.dev.java.net/.

h3. Remoting

Actors can be defined and started on remote nodes, supporting both remote failures and supervision/linking. Enabling another dimension of fault-tolerance.

h3. Java and Scala API

Both a Java API through Active Objects and annotations as well as a Scala API with Erlang-style Actors with pattern matching etc.

h3. Microkernel

Akka has a microkernel that embeds the Actor management, Persistence service, REST integration, JMX management and Remote service. Simply drop your application in the /deploy directory and start up the kernel and you should be able to access your Actors through REST.

h2. Documentation

Akka has pretty thorough "reference documentation":https://github.com/jboner/akka/wikis. Covering examples, APIs and configuration.

h2. Distribution

The latest distribution can be found in the "downloads section":https://github.com/jboner/akka/downloads

h2. License

<pre>
This software is licensed under the Apache 2 license, quoted below.

Copyright 2009 Scalable Solutions AB <http://scalablesolutions.se>

Licensed under the Apache License, Version 2.0 (the "License"); you may not
use this file except in compliance with the License. You may obtain a copy of
the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations under
the License.
</pre>