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
ConstructorsConstructorDescriptionCreate an instance using the default class loading.DirectExecutionControl(LoaderDelegate loaderDelegate) Creates an instance, delegating loader operations to the specified delegate. -
Method Summary
Modifier and TypeMethodDescriptionvoidaddToClasspath(String cp) Adds the path to the execution class path.protected voidNotify that classes have been redefined.protected voidMarks entry into user code.protected voidMarks departure from user code.voidclose()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 StringInvoke the specified "doit-method", a static method with no parameters.Invokes an executable Snippet by calling a method on the specified wrapper class.voidload(ExecutionControl.ClassBytecodes[] cbcs) Attempts to load new classes.voidAttempts to redefine previously loaded classes.voidstop()Interrupts a running invoke.protected StringConverts incoming exceptions in user code into instances of subtypes ofExecutionControl.ExecutionControlExceptionand throws the converted exception.protected StringConverts incoming exceptions in agent code into instances of subtypes ofExecutionControl.ExecutionControlExceptionand throws the converted exception.protected static StringvalueString(Object value) Converts theObjectvalue 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:ExecutionControlAttempts to load new classes.- Specified by:
loadin 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:ExecutionControlAttempts to redefine previously loaded classes.- Specified by:
redefinein 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:ExecutionControlInvokes an executable Snippet by calling a method on the specified wrapper class. The method must have no arguments and return String.- Specified by:
invokein 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:ExecutionControlReturns the value of a variable.- Specified by:
varValuein 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:ExecutionControlAdds the path to the execution class path.- Specified by:
addToClasspathin 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:
stopin 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:ExecutionControlRun a non-standard command (or a standard command from a newer version).- Specified by:
extensionCommandin 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:ExecutionControlShuts 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:
closein interfaceAutoCloseable- Specified by:
closein 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.ExecutionControlExceptionto pass-through.
-
valueString
Converts theObjectvalue fromExecutionControl.invoke(String, String)orExecutionControl.varValue(String, String)toString.- Parameters:
value- the value to convert- Returns:
- the
Stringrepresentation
-
throwConvertedInvocationException
protected String throwConvertedInvocationException(Throwable cause) throws ExecutionControl.RunException, ExecutionControl.InternalException Converts incoming exceptions in user code into instances of subtypes ofExecutionControl.ExecutionControlExceptionand 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.ExecutionControlExceptionand 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
-