org.protelis.lang.interpreter.impl

Class Invoke

java.lang.Object

org.protelis.lang.interpreter.impl.AbstractProtelisAST<java.lang.Object>

org.protelis.lang.interpreter.impl.Invoke

All Implemented Interfaces:

java.io.Serializable, ProtelisAST<java.lang.Object>, WithBytecode

public final class Invoke
extends AbstractProtelisAST<java.lang.Object>

Call an external Java non-static method.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	APPLY Special method name, that causes a Protelis function invocation if the left hand side of the Invoke is a FunctionDefinition.

Constructor Summary

Constructors

Constructor and Description
Invoke(Metadata metadata, java.lang.String name, ProtelisAST<?> target, java.util.List<ProtelisAST<?>> args)
Invoke(ProtelisAST<?> target, java.util.List<ProtelisAST<?>> args) Builds a new APPLY.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	evaluate(ExecutionContext context) Evaluates this AST node.
Bytecode	getBytecode()
ProtelisAST<?>	getLeftExpression()
java.lang.String	getName()
protected boolean	isNullable()
java.lang.String	toString()

Methods inherited from class org.protelis.lang.interpreter.impl.AbstractProtelisAST

branchesToString, branchesToString, eval, forEach, forEachWithIndex, getBranch, getBranches, getBranchesNumber, getMetadata, stringFor

Methods inherited from class java.lang.Object

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

Field Detail

APPLY

public static final java.lang.String APPLY

Special method name, that causes a Protelis function invocation if the left hand side of the Invoke is a FunctionDefinition.

See Also:

Constant Field Values

Constructor Detail

Invoke

public Invoke(Metadata metadata,
              java.lang.String name,
              ProtelisAST<?> target,
              java.util.List<ProtelisAST<?>> args)

Parameters:

metadata - A Metadata object containing information about the code that generated this AST node.

name - function (or method) name

target - Protelis sub-program that annotates itself with the target of this call

args - arguments of the function

Invoke

public Invoke(ProtelisAST<?> target,
              java.util.List<ProtelisAST<?>> args)

Builds a new APPLY.

Parameters:

target - the target of the invocation, must evaluate to either a FunctionDefinition or a @JVMEntity of type Method.

args - the arguments

Method Detail

evaluate

public java.lang.Object evaluate(ExecutionContext context)

Description copied from class: AbstractProtelisAST

Evaluates this AST node. This method can throw any exception, AbstractProtelisAST takes care of storing the necessary metadata.

Specified by:

evaluate in class AbstractProtelisAST<java.lang.Object>

Parameters:

context - the execution context

Returns:

the result of the evaluation

getBytecode

public Bytecode getBytecode()

Returns:

the element Bytecode

getLeftExpression

public ProtelisAST<?> getLeftExpression()

Returns:

the ProtelisAST representing the invocation receiver

getName

public java.lang.String getName()

Specified by:

getName in interface ProtelisAST<java.lang.Object>

Overrides:

getName in class AbstractProtelisAST<java.lang.Object>

Returns:

The name of the operation

toString

public java.lang.String toString()

Overrides:

toString in class AbstractProtelisAST<java.lang.Object>

isNullable

protected boolean isNullable()

Overrides:

isNullable in class AbstractProtelisAST<java.lang.Object>

Returns:

true if this node can get annotated with null values - namely, if it is an interaction with Java