org.spf4j.zel.vm

Class Program

java.lang.Object

org.spf4j.zel.vm.Program

All Implemented Interfaces:

Serializable

@Immutable
public final class Program
extends Object
implements Serializable

A ZEL program (function)

This is a Turing machine a Program will always be pretty much an array of operations (instructions).

Version:

1.0

Author:

zoly

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Program.ExecutionType
static class	Program.HasClass
static class	Program.Type

Method Summary

Modifier and Type	Method and Description
static void	addValue(Map mem, String name, Object value) Load a value into memory Have to go through the VM so that the assignement is acurate
static Program	compile(String zExpr, String... varNames)
boolean	contains(Class<? extends Instruction> instr)
static String	dumpCore(String name, Object mem, int indent, int maxIndent) Output Core, in hierarchical tab indented mode
boolean	equals(Object obj)
Object	execute()
static Object	execute(ExecutionContext ectx)
Object	execute(ExecutorService execService, Object... args)
Object	execute(InputStream in, PrintStream out, PrintStream err, Object... args)
Object	execute(Object... args)
Object	execute(VMExecutor execService, InputStream in, PrintStream out, PrintStream err, Object... args)
Object	executeSingleThreaded(Object... args)
static Object	executeSync(ExecutionContext ectx)
Pair<Object,ExecutionContext>	executeX(VMExecutor execService, InputStream in, PrintStream out, PrintStream err, ResultCache resultCache, Object... args)
Instruction	get(int i)
Instruction[]	getCode()
ParsingContext.Location[]	getDebugInfo()
Program.ExecutionType	getExecType()
Map<String,Integer>	getGlobalSymbolTable()
int	getLocalMemSize()
Map<String,Integer>	getLocalSymbolTable()
String	getName()
String	getSource()
Program.Type	getType()
static Object	getValue(Map mem, String name) get a value of a variable from memory, this function is syntax safe
boolean	hasDeterministicFunctions()
int	hashCode()
<T> T	itterate(com.google.common.base.Function<Object,T> func)
static void	main(String[] args) * This allows to run ZEL in an interactive mode
int	size()
String	toAssemblyString()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

getSource

public String getSource()

getName

public String getName()

getGlobalSymbolTable

public Map<String,Integer> getGlobalSymbolTable()

getLocalSymbolTable

public Map<String,Integer> getLocalSymbolTable()

getLocalMemSize

public int getLocalMemSize()

equals

@CheckReturnValue
public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

@CheckReturnValue
public int hashCode()

Overrides:

hashCode in class Object

hasDeterministicFunctions

public boolean hasDeterministicFunctions()

get

@CheckReturnValue
public Instruction get(int i)

Parameters:

i - - inst address.

Returns:

the instruction.

getCode

@CheckReturnValue
public Instruction[] getCode()

getDebugInfo

@CheckReturnValue
public ParsingContext.Location[] getDebugInfo()

size

@CheckReturnValue
public int size()

getExecType

public Program.ExecutionType getExecType()

compile

@Nonnull
public static Program compile(@Nonnull
                                       String zExpr,
                                       @Nonnull
                                       String... varNames)
                                throws CompileException

Throws:

CompileException

execute

public Object execute()
               throws ExecutionException,
                      InterruptedException

Throws:

ExecutionException

InterruptedException

execute

public Object execute(Object... args)
               throws ExecutionException,
                      InterruptedException

Throws:

ExecutionException

InterruptedException

execute

public Object execute(@Nonnull
                      ExecutorService execService,
                      Object... args)
               throws ExecutionException,
                      InterruptedException

Throws:

ExecutionException

InterruptedException

executeSingleThreaded

public Object executeSingleThreaded(Object... args)
                             throws ExecutionException,
                                    InterruptedException

Throws:

ExecutionException

InterruptedException

execute

public Object execute(@Nullable
                      VMExecutor execService,
                      @Nullable
                      InputStream in,
                      @Nullable
                      PrintStream out,
                      @Nullable
                      PrintStream err,
                      Object... args)
               throws ExecutionException,
                      InterruptedException

Throws:

ExecutionException

InterruptedException

executeX

public Pair<Object,ExecutionContext> executeX(@Nullable
                                              VMExecutor execService,
                                              @Nullable
                                              InputStream in,
                                              @Nullable
                                              PrintStream out,
                                              @Nullable
                                              PrintStream err,
                                              ResultCache resultCache,
                                              Object... args)
                                       throws ExecutionException,
                                              InterruptedException

Throws:

ExecutionException

InterruptedException

executeSync

public static Object executeSync(@Nonnull
                                 ExecutionContext ectx)
                          throws ExecutionException,
                                 InterruptedException

Throws:

ExecutionException

InterruptedException

execute

public static Object execute(@Nonnull
                             ExecutionContext ectx)
                      throws ExecutionException,
                             InterruptedException

Throws:

ExecutionException

InterruptedException

execute

public Object execute(@Nonnull
                      InputStream in,
                      @Nonnull
                      PrintStream out,
                      @Nonnull
                      PrintStream err,
                      Object... args)
               throws ExecutionException,
                      InterruptedException

Throws:

ExecutionException

InterruptedException

getValue

public static Object getValue(@Nonnull
                              Map mem,
                              @Nonnull
                              String name)
                       throws CompileException,
                              InterruptedException,
                              ExecutionException

get a value of a variable from memory, this function is syntax safe

Parameters:

mem - Map

name - String

Returns:

Object

Throws:

Exception

CompileException

InterruptedException

ExecutionException

addValue

public static void addValue(@Nonnull
                            Map mem,
                            @Nonnull
                            String name,
                            Object value)
                     throws CompileException,
                            InterruptedException,
                            ExecutionException

Load a value into memory Have to go through the VM so that the assignement is acurate

Parameters:

mem -

name - String

value - Object

Throws:

InterruptedException

CompileException

ExecutionException

dumpCore

@CheckReturnValue
public static String dumpCore(String name,
                                                Object mem,
                                                int indent,
                                                int maxIndent)

Output Core, in hierarchical tab indented mode

Parameters:

name -

mem -

indent -

maxIndent -

Returns:

main

public static void main(String[] args)
                 throws IOException,
                        InterruptedException

* This allows to run ZEL in an interactive mode

Parameters:

args -

Throws:

IOException

InterruptedException

toAssemblyString

public String toAssemblyString()

toString

public String toString()

Overrides:

toString in class Object

getType

public Program.Type getType()

Returns:

the type

contains

public boolean contains(Class<? extends Instruction> instr)

itterate

@Nullable
public <T> T itterate(com.google.common.base.Function<Object,T> func)