java.lang.Object
jdk.jshell.execution.DirectExecutionControl
- All Implemented Interfaces:
AutoCloseable
,ExecutionControl
- Direct Known Subclasses:
LocalExecutionControl
,RemoteExecutionControl
An
ExecutionControl
implementation that runs in the current process.
May be used directly, or over a channel with
Util.forwardExecutionControl(ExecutionControl, java.io.ObjectInput, java.io.ObjectOutput)
.- Since:
- 9
-
Nested Class Summary
Nested classes/interfaces declared in interface jdk.jshell.spi.ExecutionControl
ExecutionControl.ClassBytecodes, ExecutionControl.ClassInstallException, ExecutionControl.EngineTerminationException, ExecutionControl.ExecutionControlException, ExecutionControl.InternalException, ExecutionControl.NotImplementedException, ExecutionControl.ResolutionException, ExecutionControl.RunException, ExecutionControl.StoppedException, ExecutionControl.UserException
-
Constructor Summary
ConstructorDescriptionCreate an instance using the default class loading.DirectExecutionControl
(LoaderDelegate loaderDelegate) Creates an instance, delegating loader operations to the specified delegate. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addToClasspath
(String cp) Adds the path to the execution class path.protected void
Notify that classes have been redefined.protected void
Marks entry into user code.protected void
Marks departure from user code.void
close()
Shuts down this execution engine.extensionCommand
(String command, Object arg) Run a non-standard command (or a standard command from a newer version).protected Class
<?> Finds the class with the specified binary name.protected String
Invoke the specified "doit-method", a static method with no parameters.Invokes an executable Snippet by calling a method on the specified wrapper class.void
load
(ExecutionControl.ClassBytecodes[] cbcs) Attempts to load new classes.void
Attempts to redefine previously loaded classes.void
stop()
Interrupts a running invoke.protected String
Converts incoming exceptions in user code into instances of subtypes ofExecutionControl.ExecutionControlException
and throws the converted exception.protected String
Converts incoming exceptions in agent code into instances of subtypes ofExecutionControl.ExecutionControlException
and throws the converted exception.protected static String
valueString
(Object value) Converts theObject
value fromExecutionControl.invoke(String, String)
orExecutionControl.varValue(String, String)
toString
.Returns the value of a variable.
-
Constructor Details
-
DirectExecutionControl
Creates an instance, delegating loader operations to the specified delegate.- Parameters:
loaderDelegate
- the delegate to handle loading classes
-
DirectExecutionControl
public DirectExecutionControl()Create an instance using the default class loading.
-
-
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 interfaceExecutionControl
- Parameters:
cbcs
- the class name and bytecodes to load- Throws:
ExecutionControl.ClassInstallException
- exception occurred loading the classes, some or all were not loadedExecutionControl.NotImplementedException
- if not implementedExecutionControl.EngineTerminationException
- the execution engine has terminated
-
redefine
public void redefine(ExecutionControl.ClassBytecodes[] cbcs) throws ExecutionControl.ClassInstallException, ExecutionControl.NotImplementedException, ExecutionControl.EngineTerminationException Description copied from interface:ExecutionControl
Attempts to redefine previously loaded classes.- Specified by:
redefine
in interfaceExecutionControl
- Parameters:
cbcs
- the class name and bytecodes to redefine- Throws:
ExecutionControl.ClassInstallException
- exception occurred redefining the classes, some or all were not redefinedExecutionControl.NotImplementedException
- if not implementedExecutionControl.EngineTerminationException
- the execution engine has terminated
-
classesRedefined
protected void classesRedefined(ExecutionControl.ClassBytecodes[] cbcs) throws ExecutionControl.NotImplementedException, ExecutionControl.EngineTerminationException Notify that classes have been redefined.- Parameters:
cbcs
- the class name and bytecodes to redefine- Throws:
ExecutionControl.NotImplementedException
- if not implementedExecutionControl.EngineTerminationException
- the execution engine has terminated
-
invoke
public String invoke(String className, String methodName) throws ExecutionControl.RunException, ExecutionControl.InternalException, ExecutionControl.EngineTerminationException Description copied from interface:ExecutionControl
Invokes an executable Snippet by calling a method on the specified wrapper class. The method must have no arguments and return String.- Specified by:
invoke
in interfaceExecutionControl
- Parameters:
className
- the class whose method should be invokedmethodName
- the name of method to invoke- Returns:
- the result of the execution or null if no result
- Throws:
ExecutionControl.UserException
- the invoke raised a user exceptionExecutionControl.ResolutionException
- the invoke attempted to directly or indirectly invoke an unresolved snippetExecutionControl.StoppedException
- if theinvoke()
was canceled byExecutionControl.stop()
ExecutionControl.InternalException
- an internal problem occurredExecutionControl.EngineTerminationException
- the execution engine has terminatedExecutionControl.RunException
-
varValue
public String varValue(String className, String varName) throws ExecutionControl.RunException, ExecutionControl.EngineTerminationException, ExecutionControl.InternalException Description copied from interface:ExecutionControl
Returns the value of a variable.- Specified by:
varValue
in interfaceExecutionControl
- Parameters:
className
- the name of the wrapper class of the variablevarName
- the name of the variable- Returns:
- the value of the variable
- Throws:
ExecutionControl.UserException
- formatting the value raised a user exceptionExecutionControl.ResolutionException
- formatting the value attempted to directly or indirectly invoke an unresolved snippetExecutionControl.StoppedException
- if the formatting the value was canceled byExecutionControl.stop()
ExecutionControl.EngineTerminationException
- the execution engine has terminatedExecutionControl.InternalException
- an internal problem occurredExecutionControl.RunException
-
addToClasspath
public void addToClasspath(String cp) throws ExecutionControl.EngineTerminationException, ExecutionControl.InternalException Description copied from interface:ExecutionControl
Adds the path to the execution class path.- Specified by:
addToClasspath
in interfaceExecutionControl
- Parameters:
cp
- the path to add- Throws:
ExecutionControl.EngineTerminationException
- the execution engine has terminatedExecutionControl.InternalException
- an internal problem occurred
-
stop
public void stop() throws ExecutionControl.EngineTerminationException, ExecutionControl.InternalExceptionInterrupts a running invoke.Not supported.
- Specified by:
stop
in interfaceExecutionControl
- Throws:
ExecutionControl.EngineTerminationException
- the execution engine has terminatedExecutionControl.InternalException
- an internal problem occurred
-
extensionCommand
public Object extensionCommand(String command, Object arg) throws ExecutionControl.RunException, ExecutionControl.EngineTerminationException, ExecutionControl.InternalException Description copied from interface:ExecutionControl
Run a non-standard command (or a standard command from a newer version).- Specified by:
extensionCommand
in interfaceExecutionControl
- Parameters:
command
- the non-standard commandarg
- the commands argument- Returns:
- the commands return value
- Throws:
ExecutionControl.UserException
- the command raised a user exceptionExecutionControl.ResolutionException
- the command attempted to directly or indirectly invoke an unresolved snippetExecutionControl.StoppedException
- if the command was canceled byExecutionControl.stop()
ExecutionControl.EngineTerminationException
- the execution engine has terminatedExecutionControl.NotImplementedException
- if not implementedExecutionControl.InternalException
- an internal problem occurredExecutionControl.RunException
-
close
public void close()Description copied from interface:ExecutionControl
Shuts down this execution engine. Implementation should free all resources held by this execution engine.No calls to methods on this interface should be made after close.
- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceExecutionControl
-
findClass
Finds the class with the specified binary name.- Parameters:
name
- the binary name of the class- Returns:
- the Class Object
- Throws:
ClassNotFoundException
- if the class could not be found
-
invoke
Invoke the specified "doit-method", a static method with no parameters. Theinvoke(java.lang.String, java.lang.String)
in this class will call this to invoke.- Parameters:
doitMethod
- the Method to invoke- Returns:
- the value or null
- Throws:
Exception
- any exceptions thrown byMethod.invoke(Object, Object...)
or anyExecutionControl.ExecutionControlException
to pass-through.
-
valueString
Converts theObject
value fromExecutionControl.invoke(String, String)
orExecutionControl.varValue(String, String)
toString
.- Parameters:
value
- the value to convert- Returns:
- the
String
representation
-
throwConvertedInvocationException
protected String throwConvertedInvocationException(Throwable cause) throws ExecutionControl.RunException, ExecutionControl.InternalException Converts incoming exceptions in user code into instances of subtypes ofExecutionControl.ExecutionControlException
and throws the converted exception.- Parameters:
cause
- the exception to convert- Returns:
- never returns as it always throws
- Throws:
ExecutionControl.RunException
- for normal exception occurrencesExecutionControl.InternalException
- for internal problems
-
throwConvertedOtherException
protected String throwConvertedOtherException(Throwable ex) throws ExecutionControl.RunException, ExecutionControl.InternalException Converts incoming exceptions in agent code into instances of subtypes ofExecutionControl.ExecutionControlException
and throws the converted exception.- Parameters:
ex
- the exception to convert- Returns:
- never returns as it always throws
- Throws:
ExecutionControl.RunException
- for normal exception occurrencesExecutionControl.InternalException
- for internal problems
-
clientCodeEnter
Marks entry into user code.- Throws:
ExecutionControl.InternalException
- in unexpected failure cases
-
clientCodeLeave
Marks departure from user code.- Throws:
ExecutionControl.InternalException
- in unexpected failure cases
-