org.arl.fjage

Class TestBehavior

java.lang.Object

org.arl.fjage.Behavior

org.arl.fjage.OneShotBehavior

org.arl.fjage.TestBehavior

All Implemented Interfaces:

java.lang.Comparable<Behavior>

public class TestBehavior
extends OneShotBehavior

A behavior for JUnit test case design. This behavior is executed only once. The test() method of this behavior is called only once. Any AssertionError encountered during the test is stored and can be later thrown using the checkAssertions() method.

Typical usage of this behavior is shown below:

 // setup
 Platform platform = new RealtimePlatform();
 Container container = new Container(platform);
 Agent agent = new Agent();
 container.add(agent);
 platform.start();

 // test
 TestBehavior test = new TestBehavior() {
   public void test() {
     :
     :
   }
 };
 test.runOn(agent);

 // tear down
 platform.shutdown();
 

Field Summary

Fields inherited from class org.arl.fjage.Behavior

action, agent, log

Constructor Summary

Constructors

Constructor and Description
TestBehavior() Creates a test behavior.
TestBehavior(java.lang.Runnable runnable) Creates a test behavior.

Method Summary

Modifier and Type	Method and Description
void	action() This method is repeatedly called during the life of a behavior.
void	checkAssertions() Throws any AssertionError that was encountered during the test.
boolean	hasCompleted() Checks if the test has been completed.
void	reset() Resets a behavior to its initial state.
void	runOn(Agent agent) Runs a test as a behavior of a specified agent.
void	test() This method should be overridden by sub-classes.

Methods inherited from class org.arl.fjage.OneShotBehavior

done

Methods inherited from class org.arl.fjage.Behavior

agent, agentForService, agentForService, agentsForService, agentsForService, block, block, compareTo, getPriority, isBlocked, onEnd, onStart, println, restart

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TestBehavior

public TestBehavior()

Creates a test behavior.

TestBehavior

public TestBehavior(java.lang.Runnable runnable)

Creates a test behavior.

Parameters:

runnable - Runnable to run.

Method Detail

action

public final void action()

Description copied from class: Behavior

This method is repeatedly called during the life of a behavior. A behavior may override this to provide appropriate functionality.

Overrides:

action in class Behavior

reset

public void reset()

Description copied from class: Behavior

Resets a behavior to its initial state.

Overrides:

reset in class Behavior

hasCompleted

public boolean hasCompleted()

Checks if the test has been completed.

Returns:

true if the test is completed, false otherwise.

checkAssertions

public void checkAssertions()

Throws any AssertionError that was encountered during the test.

runOn

public void runOn(Agent agent)

Runs a test as a behavior of a specified agent.

Parameters:

agent - agent to use for the test.

test

public void test()

This method should be overridden by sub-classes. AssertionErrors may be thrown if the test fails.