Packages

  • package root
    Definition Classes
    root
  • package akka
    Definition Classes
    root
  • package testkit
    Definition Classes
    akka
  • class JavaTestKit extends AnyRef

    Java API: Test kit for testing actors.

    Java API: Test kit for testing actors. Inheriting from this class enables reception of replies from actors, which are queued by an internal actor and can be examined using the expectMsg... methods. Assertions and bounds concerning timing are available in the form of Within blocks.

    Beware of two points:

    • the ActorSystem passed into the constructor needs to be shutdown, otherwise thread pools and memory will be leaked - this trait is not thread-safe (only one actor with one queue, one stack of Within blocks); take care not to run tests within a single test class instance in parallel.
    • It should be noted that for CI servers and the like all maximum Durations are scaled using the dilated method, which uses the TestKitExtension.Settings.TestTimeFactor settable via akka.conf entry "akka.test.timefactor".
    Definition Classes
    testkit
    Deprecated

    Use akka.testkit.javadsl.TestKit instead, since 2.5.0

  • AwaitAssert
  • AwaitCond
  • EventFilter
  • ExpectMsg
  • IgnoreMsg
  • ReceiveWhile
  • Within

abstract class ExpectMsg[T] extends AnyRef

Receive one message from the test actor and assert that the given matching function accepts it. Wait time is bounded by the given duration, with an AssertionFailure being thrown in case of timeout.

The received object as transformed by the matching function can be retrieved with the get method.

Use this variant to implement more complicated or conditional processing.


final String out = new ExpectMsg<String>("match hint") {
  protected String match(Object in) {
    if (in instanceof Integer)
      return "match";
    else
      throw noMatch();
  }
}.get(); // this extracts the received message

Source
JavaTestKit.java
Linear Supertypes
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. ExpectMsg
  2. AnyRef
  3. Any
Implicitly
  1. by any2stringadd
  2. by StringFormat
  3. by Ensuring
  4. by ArrowAssoc
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new ExpectMsg(max: Duration, hint: String)
  2. new ExpectMsg(hint: String)

Concrete Value Members

  1. def get(): T