org.apache.ode.jacob.vpu

Class JacobVPU

java.lang.Object

org.apache.ode.jacob.vpu.JacobVPU

public final class JacobVPU
extends java.lang.Object

The JACOB Virtual Processing Unit ("VPU").

Author:

Maciej Szefler

Constructor Summary

Constructors

Constructor and Description
JacobVPU() Default constructor.
JacobVPU(ExecutionQueue executionQueue) Re-hydration constructor.
JacobVPU(ExecutionQueue context, JacobRunnable concretion) Instantiation constructor; used to initialize context with the concretion of a process abstraction.

Method Summary

Methods

Modifier and Type	Method and Description
static JacobThread	activeJacobThread() Get the active Jacob thread, i.e.
void	addReaction(JacobObject jo, java.lang.reflect.Method method, java.lang.Object[] args, java.lang.String desc) Add an item to the run queue.
void	dumpState() Dump the state of the VPU for debugging purposes.
boolean	execute() Execute one VPU cycle.
void	flush()
void	inject(JacobRunnable concretion) Inject a concretion into the process context.
boolean	isComplete()
void	registerExtension(java.lang.Class extensionClass, java.lang.Object obj)
void	setClassLoader(java.lang.ClassLoader classLoader)
void	setContext(ExecutionQueue executionQueue) Set the state of of the VPU; this is analagous to loading a CPU with a thread's context (re-hydration).

Methods inherited from class java.lang.Object

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

Constructor Detail

JacobVPU

public JacobVPU()

Default constructor.

JacobVPU

public JacobVPU(ExecutionQueue executionQueue)

Re-hydration constructor.

Parameters:

executionQueue - previously saved execution context

JacobVPU

public JacobVPU(ExecutionQueue context,
        JacobRunnable concretion)

Instantiation constructor; used to initialize context with the concretion of a process abstraction.

Parameters:

context - virgin context object

concretion - the process

Method Detail

execute

public boolean execute()

Execute one VPU cycle.

Returns:

true if the run queue is not empty after this cycle, false otherwise.

flush

public void flush()

setContext

public void setContext(ExecutionQueue executionQueue)

Set the state of of the VPU; this is analagous to loading a CPU with a thread's context (re-hydration).

Parameters:

executionQueue - process executionQueue (state)

registerExtension

public void registerExtension(java.lang.Class extensionClass,
                     java.lang.Object obj)

addReaction

public void addReaction(JacobObject jo,
               java.lang.reflect.Method method,
               java.lang.Object[] args,
               java.lang.String desc)

Add an item to the run queue.

activeJacobThread

public static JacobThread activeJacobThread()

Get the active Jacob thread, i.e. the one associated with the current Java thread.

inject

public void inject(JacobRunnable concretion)

Inject a concretion into the process context. This amounts to chaning the process context from P to P|Q where P is the previous process context and Q is the injected process. This method is equivalent to the parallel operator, but is intended to be used from outside of an active JacobThread.

setClassLoader

public void setClassLoader(java.lang.ClassLoader classLoader)

dumpState

public void dumpState()

Dump the state of the VPU for debugging purposes.

isComplete

public boolean isComplete()