Update transactor docs and switch to compiled examples

akka-docs/java/code/akka/docs/transactor/CoordinatedCounter.java

@@ -0,0 +1,40 @@
+/**
+ * Copyright (C) 2009-2011 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package akka.docs.transactor;
+
+//#class
+import akka.actor.*;
+import akka.transactor.*;
+import scala.concurrent.stm.*;
+
+public class CoordinatedCounter extends UntypedActor {
+    private Ref<Integer> count = Stm.ref(0);
+
+    private void increment(InTxn txn) {
+        Integer newValue = count.get(txn) + 1;
+        count.set(newValue, txn);
+    }
+
+    public void onReceive(Object incoming) throws Exception {
+        if (incoming instanceof Coordinated) {
+            Coordinated coordinated = (Coordinated) incoming;
+            Object message = coordinated.getMessage();
+            if (message instanceof Increment) {
+                Increment increment = (Increment) message;
+                if (increment.hasFriend()) {
+                    increment.getFriend().tell(coordinated.coordinate(new Increment()));
+                }
+                coordinated.atomic(new Atomically() {
+                    public void atomically(InTxn txn) {
+                        increment(txn);
+                    }
+                });
+            }
+        } else if ("GetCount".equals(incoming)) {
+            getSender().tell(count.single().get());
+        }
+    }
+}
+//#class

akka-docs/java/code/akka/docs/transactor/Coordinator.java

@@ -0,0 +1,27 @@
+/**
+ * Copyright (C) 2009-2011 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package akka.docs.transactor;
+
+import akka.actor.*;
+import akka.transactor.*;
+import scala.concurrent.stm.*;
+
+public class Coordinator extends UntypedActor {
+    public void onReceive(Object incoming) throws Exception {
+        if (incoming instanceof Coordinated) {
+            Coordinated coordinated = (Coordinated) incoming;
+            Object message = coordinated.getMessage();
+            if (message instanceof Message) {
+                //#coordinated-atomic
+                coordinated.atomic(new Atomically() {
+                    public void atomically(InTxn txn) {
+                        // do something in the coordinated transaction ...
+                    }
+                });
+                //#coordinated-atomic
+            }
+        }
+    }
+}

akka-docs/java/code/akka/docs/transactor/Counter.java

@@ -0,0 +1,28 @@
+/**
+ * Copyright (C) 2009-2011 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package akka.docs.transactor;
+
+//#class
+import akka.transactor.*;
+import scala.concurrent.stm.*;
+
+public class Counter extends UntypedTransactor {
+    Ref<Integer> count = Stm.ref(0);
+
+    public void atomically(InTxn txn, Object message) {
+        if (message instanceof Increment) {
+            Integer newValue = count.get(txn) + 1;
+            count.set(newValue, txn);
+        }
+    }
+
+    @Override public boolean normally(Object message) {
+        if ("GetCount".equals(message)) {
+            getSender().tell(count.single().get());
+            return true;
+        } else return false;
+    }
+}
+//#class

akka-docs/java/code/akka/docs/transactor/FriendlyCounter.java

@@ -0,0 +1,39 @@
+/**
+ * Copyright (C) 2009-2011 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package akka.docs.transactor;
+
+//#class
+import akka.actor.*;
+import akka.transactor.*;
+import java.util.Set;
+import scala.concurrent.stm.*;
+
+public class FriendlyCounter extends UntypedTransactor {
+    Ref<Integer> count = Stm.ref(0);
+
+    @Override public Set<SendTo> coordinate(Object message) {
+        if (message instanceof Increment) {
+            Increment increment = (Increment) message;
+            if (increment.hasFriend())
+                return include(increment.getFriend(), new Increment());
+        }
+        return nobody();
+    }
+
+    public void atomically(InTxn txn, Object message) {
+        if (message instanceof Increment) {
+            Integer newValue = count.get(txn) + 1;
+            count.set(newValue, txn);
+        }
+    }
+
+    @Override public boolean normally(Object message) {
+        if ("GetCount".equals(message)) {
+            getSender().tell(count.single().get());
+            return true;
+        } else return false;
+    }
+}
+//#class

akka-docs/java/code/akka/docs/transactor/Increment.java

@@ -0,0 +1,27 @@
+/**
+ * Copyright (C) 2009-2011 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package akka.docs.transactor;
+
+//#class
+import akka.actor.ActorRef;
+
+public class Increment {
+    private ActorRef friend = null;
+
+    public Increment() {}
+
+    public Increment(ActorRef friend) {
+        this.friend = friend;
+    }
+
+    public boolean hasFriend() {
+        return friend != null;
+    }
+
+    public ActorRef getFriend() {
+        return friend;
+    }
+}
+//#class

akka-docs/java/code/akka/docs/transactor/Message.java

@@ -0,0 +1,7 @@
+/**
+ * Copyright (C) 2009-2011 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package akka.docs.transactor;
+
+public class Message {}

akka-docs/java/code/akka/docs/transactor/TransactorDocJavaSpec.scala

@@ -0,0 +1,11 @@
+/**
+ * Copyright (C) 2009-2011 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package akka.docs.transactor
+
+import org.scalatest.junit.JUnitWrapperSuite
+
+class TransactorDocJavaSpec extends JUnitWrapperSuite(
+  "akka.docs.transactor.TransactorDocTest",
+  Thread.currentThread.getContextClassLoader)

akka-docs/java/code/akka/docs/transactor/TransactorDocTest.java

@@ -0,0 +1,99 @@
+/**
+ * Copyright (C) 2009-2011 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package akka.docs.transactor;
+
+import static org.junit.Assert.*;
+import org.junit.Test;
+
+//#imports
+import akka.actor.*;
+import akka.dispatch.Await;
+import akka.transactor.Coordinated;
+import akka.util.Duration;
+import akka.util.Timeout;
+import java.util.concurrent.TimeUnit;
+//#imports
+
+public class TransactorDocTest {
+
+    @Test
+    public void coordinatedExample() {
+        //#coordinated-example
+        ActorSystem system = ActorSystem.create("CoordinatedExample");
+
+        ActorRef counter1 = system.actorOf(new Props().withCreator(CoordinatedCounter.class));
+        ActorRef counter2 = system.actorOf(new Props().withCreator(CoordinatedCounter.class));
+
+        Timeout timeout = new Timeout(Duration.create(5, TimeUnit.SECONDS));
+
+        counter1.tell(new Coordinated(new Increment(counter2), timeout));
+
+        Integer count = (Integer) Await.result(counter1.ask("GetCount", timeout), timeout.duration());
+        //#coordinated-example
+
+        assertEquals(count, new Integer(1));
+
+        system.shutdown();
+    }
+
+    @Test
+    public void coordinatedApi() {
+        //#create-coordinated
+        Timeout timeout = new Timeout(Duration.create(5, TimeUnit.SECONDS));
+        Coordinated coordinated = new Coordinated(timeout);
+        //#create-coordinated
+
+        ActorSystem system = ActorSystem.create("CoordinatedApi");
+        ActorRef actor = system.actorOf(new Props().withCreator(Coordinator.class));
+
+        //#send-coordinated
+        actor.tell(new Coordinated(new Message(), timeout));
+        //#send-coordinated
+
+        //#include-coordinated
+        actor.tell(coordinated.coordinate(new Message()));
+        //#include-coordinated
+
+        coordinated.await();
+
+        system.shutdown();
+    }
+
+    @Test
+    public void counterTransactor() {
+        ActorSystem system = ActorSystem.create("CounterTransactor");
+        ActorRef counter = system.actorOf(new Props().withCreator(Counter.class));
+
+        Timeout timeout = new Timeout(Duration.create(5, TimeUnit.SECONDS));
+        Coordinated coordinated = new Coordinated(timeout);
+        counter.tell(coordinated.coordinate(new Increment()));
+        coordinated.await();
+
+        Integer count = (Integer) Await.result(counter.ask("GetCount", timeout), timeout.duration());
+        assertEquals(count, new Integer(1));
+
+        system.shutdown();
+    }
+
+    @Test
+    public void friendlyCounterTransactor() {
+        ActorSystem system = ActorSystem.create("FriendlyCounterTransactor");
+        ActorRef friend = system.actorOf(new Props().withCreator(Counter.class));
+        ActorRef friendlyCounter = system.actorOf(new Props().withCreator(FriendlyCounter.class));
+
+        Timeout timeout = new Timeout(Duration.create(5, TimeUnit.SECONDS));
+        Coordinated coordinated = new Coordinated(timeout);
+        friendlyCounter.tell(coordinated.coordinate(new Increment(friend)));
+        coordinated.await();
+
+        Integer count1 = (Integer) Await.result(friendlyCounter.ask("GetCount", timeout), timeout.duration());
+        assertEquals(count1, new Integer(1));
+
+        Integer count2 = (Integer) Await.result(friend.ask("GetCount", timeout), timeout.duration());
+        assertEquals(count2, new Integer(1));
+
+        system.shutdown();
+    }
+}