9bc01ae265
The idea is to filter the sources, replacing @<var>@ occurrences with the mapping for <var> (which is currently hard-coded). @@ -> @. In order to make this work, I had to move the doc sources one directory down (into akka-docs/rst) so that the filtered result could be in a sibling directory so that relative links (to _sphinx plugins or real code) would continue to work. While I was at it I also changed it so that WARNINGs and ERRORs are not swallowed into the debug dump anymore but printed at [warn] level (minimum). One piece of fallout is that the (online) html build is now run after the normal one, not in parallel.
95 lines
2.6 KiB
Java
95 lines
2.6 KiB
Java
/**
|
|
* Copyright (C) 2009-2012 Typesafe Inc. <http://www.typesafe.com>
|
|
*/
|
|
package docs.testkit;
|
|
|
|
//#fullsample
|
|
import org.junit.AfterClass;
|
|
import org.junit.Assert;
|
|
import org.junit.BeforeClass;
|
|
import org.junit.Test;
|
|
|
|
import akka.actor.ActorRef;
|
|
import akka.actor.ActorSystem;
|
|
import akka.actor.Props;
|
|
import akka.actor.UntypedActor;
|
|
import akka.testkit.JavaTestKit;
|
|
import scala.concurrent.util.Duration;
|
|
|
|
public class TestKitSampleTest {
|
|
|
|
public static class SomeActor extends UntypedActor {
|
|
ActorRef target = null;
|
|
|
|
public void onReceive(Object msg) {
|
|
|
|
if (msg.equals("hello")) {
|
|
getSender().tell("world", getSelf());
|
|
if (target != null) target.forward(msg, getContext());
|
|
|
|
} else if (msg instanceof ActorRef) {
|
|
target = (ActorRef) msg;
|
|
getSender().tell("done", getSelf());
|
|
}
|
|
}
|
|
}
|
|
|
|
static ActorSystem system;
|
|
|
|
@BeforeClass
|
|
public static void setup() {
|
|
system = ActorSystem.create();
|
|
}
|
|
|
|
@AfterClass
|
|
public static void teardown() {
|
|
system.shutdown();
|
|
}
|
|
|
|
@Test
|
|
public void testIt() {
|
|
/*
|
|
* Wrap the whole test procedure within a testkit constructor
|
|
* if you want to receive actor replies or use Within(), etc.
|
|
*/
|
|
new JavaTestKit(system) {{
|
|
final Props props = new Props(SomeActor.class);
|
|
final ActorRef subject = system.actorOf(props);
|
|
|
|
// can also use JavaTestKit “from the outside”
|
|
final JavaTestKit probe = new JavaTestKit(system);
|
|
// “inject” the probe by passing it to the test subject
|
|
// like a real resource would be passed in production
|
|
subject.tell(probe.getRef(), getRef());
|
|
// await the correct response
|
|
expectMsgEquals(duration("1 second"), "done");
|
|
|
|
// the run() method needs to finish within 3 seconds
|
|
new Within(duration("3 seconds")) {
|
|
protected void run() {
|
|
|
|
subject.tell("hello", getRef());
|
|
|
|
// This is a demo: would normally use expectMsgEquals().
|
|
// Wait time is bounded by 3-second deadline above.
|
|
new AwaitCond() {
|
|
protected boolean cond() {
|
|
return probe.msgAvailable();
|
|
}
|
|
};
|
|
|
|
// response must have been enqueued to us before probe
|
|
expectMsgEquals(Duration.Zero(), "world");
|
|
// check that the probe we injected earlier got the msg
|
|
probe.expectMsgEquals(Duration.Zero(), "hello");
|
|
Assert.assertEquals(getRef(), probe.getLastSender());
|
|
|
|
// Will wait for the rest of the 3 seconds
|
|
expectNoMsg();
|
|
}
|
|
};
|
|
}};
|
|
}
|
|
|
|
}
|
|
//#fullsample
|