com.heirloomcomputing.epli.runtime

Class Entry

java.lang.Object

com.heirloomcomputing.epli.runtime.Entry

public class Entry
extends java.lang.Object

Simulate PL/I ENTRY variables and constants, which are used to transfer control (call) a procedure or function or an alternate entry point within those procedures. Uses Java reflection to find methods of a (PL/I) class and invoke. not-immutable. an Entry variable may be assigned an Entry constant.

Author:

Heirloom Computing, Inc.

Constructor Summary

Constructors

Constructor and Description
Entry() constructor - create a empty Entry variable
Entry(java.lang.Object base, java.lang.String name) constructor - create a Entry constant

Method Summary

Modifier and Type	Method and Description
void	assign(Entry cpy) assign - assign an ENTRY variable or constant to an Entry variable
java.lang.Object	invoke(java.lang.Object... actuals) invoke - invoke the entry point

Methods inherited from class java.lang.Object

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

Constructor Detail

Entry

public Entry()

constructor - create a empty Entry variable

Entry

public Entry(java.lang.Object base,
             java.lang.String name)

constructor - create a Entry constant

Throws:

NAME - condition if name could not be found in base

Method Detail

assign

public void assign(Entry cpy)

assign - assign an ENTRY variable or constant to an Entry variable

Parameters:

cpy - - the ENTRY variable or constant to assign this variable

invoke

public java.lang.Object invoke(java.lang.Object... actuals)
                        throws java.lang.Throwable

invoke - invoke the entry point

Parameters:

actuals - - array of arbitrary number of parms passed to the entry point

Returns:

- null if PROCEDURE, non-null if a PROCEDURE with RETURNS

Throws:

NAME - condition if name could not be found, mismatched formal and actual parameters, or an Exception occurs during invocation

other - conditions if the invoked PROCEDURE raised a CONDITION

java.lang.Throwable