Class LocalExecutionControl

java.lang.Object

jdk.jshell.execution.DirectExecutionControl

jdk.jshell.execution.LocalExecutionControl

All Implemented Interfaces:

AutoCloseable, ExecutionControl

public class LocalExecutionControl
extends DirectExecutionControl

An implementation of ExecutionControl which executes in the same JVM as the JShell-core.

Since:

9

Nested Class Summary

Nested classes/interfaces inherited from interface ExecutionControl

ExecutionControl.ClassBytecodes, ExecutionControl.ClassInstallException, ExecutionControl.EngineTerminationException, ExecutionControl.ExecutionControlException, ExecutionControl.InternalException, ExecutionControl.NotImplementedException, ExecutionControl.ResolutionException, ExecutionControl.RunException, ExecutionControl.StoppedException, ExecutionControl.UserException

Constructor Summary

Constructors

Constructor	Description
LocalExecutionControl()	Create an instance using the default class loading, which delegates to the system class loader.
LocalExecutionControl(ClassLoader parent)	Create an instance using the default class loading, but delegating to the specified parent class loader.
LocalExecutionControl(LoaderDelegate loaderDelegate)	Creates an instance, delegating loader operations to the specified delegate.

Method Summary

Modifier and Type	Method	Description
protected void	clientCodeEnter()	Marks entry into user code.
protected void	clientCodeLeave()	Marks departure from user code.
protected String	invoke(Method doitMethod)	Invoke the specified "doit-method", a static method with no parameters.
void	load(ExecutionControl.ClassBytecodes[] cbcs)	Attempts to load new classes.
void	stop()	Interrupts a running invoke.

Methods inherited from class DirectExecutionControl

addToClasspath, classesRedefined, close, extensionCommand, findClass, invoke, redefine, throwConvertedInvocationException, throwConvertedOtherException, valueString, varValue

Methods inherited from class Object

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

Constructor Details

LocalExecutionControl

public LocalExecutionControl(LoaderDelegate loaderDelegate)

Creates an instance, delegating loader operations to the specified delegate.

Parameters:

loaderDelegate - the delegate to handle loading classes

LocalExecutionControl

public LocalExecutionControl()

Create an instance using the default class loading, which delegates to the system class loader.

LocalExecutionControl

public LocalExecutionControl(ClassLoader parent)

Create an instance using the default class loading, but delegating to the specified parent class loader.

Parameters:

parent - parent class loader

Since:

22

Method Details

load

public void load(ExecutionControl.ClassBytecodes[] cbcs)
          throws ExecutionControl.ClassInstallException,
ExecutionControl.NotImplementedException,
ExecutionControl.EngineTerminationException

Description copied from interface: ExecutionControl

Attempts to load new classes.

Specified by:

load in interface ExecutionControl

Overrides:

load in class DirectExecutionControl

Parameters:

cbcs - the class name and bytecodes to load

Throws:

ExecutionControl.ClassInstallException - exception occurred loading the classes, some or all were not loaded

ExecutionControl.NotImplementedException - if not implemented

ExecutionControl.EngineTerminationException - the execution engine has terminated

invoke

protected String invoke(Method doitMethod)
                 throws Exception

Description copied from class: DirectExecutionControl

Invoke the specified "doit-method", a static method with no parameters. The DirectExecutionControl.invoke(java.lang.String, java.lang.String) in this class will call this to invoke.

Overrides:

invoke in class DirectExecutionControl

Parameters:

doitMethod - the Method to invoke

Returns:

the value or null

Throws:

Exception - any exceptions thrown by Method.invoke(Object, Object...) or any ExecutionControl.ExecutionControlException to pass-through.

stop

public void stop()
          throws ExecutionControl.EngineTerminationException,
ExecutionControl.InternalException

Description copied from class: DirectExecutionControl

Interrupts a running invoke.

Not supported.

Specified by:

stop in interface ExecutionControl

Overrides:

stop in class DirectExecutionControl

Throws:

ExecutionControl.EngineTerminationException - the execution engine has terminated

ExecutionControl.InternalException - an internal problem occurred

clientCodeEnter

protected void clientCodeEnter()

Description copied from class: DirectExecutionControl

Marks entry into user code.

Overrides:

clientCodeEnter in class DirectExecutionControl

clientCodeLeave

protected void clientCodeLeave()

Description copied from class: DirectExecutionControl

Marks departure from user code.

Overrides:

clientCodeLeave in class DirectExecutionControl