All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface Jaja.EvaluationAble

public interface EvaluationAble
extends Remote
This interface characterizes an Evaluation performed by a World on behalf of a Listener. The interface looks a little like a Thread: one may start an evaluation or stop it. One may also inspect the Evaluation to discover in which world it is run.


Variable Index

 o EVALUATED
 o EVALUATING
 o EXITED
 o EXITING
 o EXPANDED
 o EXPANDING
 o STARTING
 o statusName
 o UNCAUGHT
 o UNEVALUATED
 o UNEXPANDED
 o UNSTARTED

Method Index

 o getDynamicEnvironment()
Discover in which dynamic environment the evaluation takes place.
 o getStatus()
An EvaluationAble always maintains an uptodate status which may be one of the codes below.
 o getStatusName()
This method converts the current status into a String.
 o getWorld()
Discover in which world the evaluation takes place.
 o obtain()
The obtain method allows to get the final Value computed by an EvalutationAble evaluation or to raise the Exception yielded by this EvaluationAble evaluation.
 o resume()
 o start()
 o stop()
 o suspend()

Variables

 o EVALUATED
 public static final int EVALUATED
 o UNSTARTED
 public static final int UNSTARTED
 o STARTING
 public static final int STARTING
 o EVALUATING
 public static final int EVALUATING
 o UNEVALUATED
 public static final int UNEVALUATED
 o EXPANDING
 public static final int EXPANDING
 o UNEXPANDED
 public static final int UNEXPANDED
 o EXPANDED
 public static final int EXPANDED
 o EXITING
 public static final int EXITING
 o EXITED
 public static final int EXITED
 o UNCAUGHT
 public static final int UNCAUGHT
 o statusName
 public static final String statusName[]

Methods

 o getWorld
 public abstract WorldAble getWorld() throws RemoteException
Discover in which world the evaluation takes place.

 o getDynamicEnvironment
 public abstract DynamicEnvironment getDynamicEnvironment() throws RemoteException
Discover in which dynamic environment the evaluation takes place.

 o getStatus
 public abstract int getStatus() throws RemoteException
An EvaluationAble always maintains an uptodate status which may be one of the codes below. The status is initially UNSTARTED and, mormally, ends up with DONE. Various intermediary phases exist to record the various states of the EvaluationAble: UNEVALUATED means that an error occured when evaluating while UNEXPANDED means that an error occured when expanding.

The normal succession of state is as follows: UNSTARTED -> STARTING -> EXPANDING -> EXPANDED -> EVALUATING -> EVALUATED | | +> UNEXPANDED +> UNEVALUATED

 o getStatusName
 public abstract String getStatusName() throws RemoteException
This method converts the current status into a String. Unfortunately its code must be duplicated in every class implementing the current interface.

 o obtain
 public abstract Value obtain() throws Exception, RemoteException
The obtain method allows to get the final Value computed by an EvalutationAble evaluation or to raise the Exception yielded by this EvaluationAble evaluation. If a final state of the EvaluationAble is not yet attained, wait until this is true. This method is therefore synchronous.

Throws: Exception
errors when running Jaja belong to RuntimeException, Other errors may occur due to remote method invokation.
 o start
 public abstract void start() throws RemoteException
 o stop
 public abstract void stop() throws RemoteException
 o suspend
 public abstract void suspend() throws RemoteException
 o resume
 public abstract void resume() throws RemoteException

All Packages  Class Hierarchy  This Package  Previous  Next  Index