Class DirectExecutionControl
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 SummaryNested classes/interfaces declared in interface jdk.jshell.spi.ExecutionControlExecutionControl.ClassBytecodes, ExecutionControl.ClassInstallException, ExecutionControl.EngineTerminationException, ExecutionControl.ExecutionControlException, ExecutionControl.InternalException, ExecutionControl.NotImplementedException, ExecutionControl.ResolutionException, ExecutionControl.RunException, ExecutionControl.StoppedException, ExecutionControl.UserException
- 
Constructor SummaryConstructorsConstructorDescriptionCreate an instance using the default class loading.DirectExecutionControl(LoaderDelegate loaderDelegate) Creates an instance, delegating loader operations to the specified delegate.
- 
Method SummaryModifier 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- 
DirectExecutionControlCreates an instance, delegating loader operations to the specified delegate.- Parameters:
- loaderDelegate- the delegate to handle loading classes
 
- 
DirectExecutionControlpublic DirectExecutionControl()Create an instance using the default class loading.
 
- 
- 
Method Details- 
loadpublic void load(ExecutionControl.ClassBytecodes[] cbcs) throws ExecutionControl.ClassInstallException, ExecutionControl.NotImplementedException, ExecutionControl.EngineTerminationException Description copied from interface:ExecutionControlAttempts to load new classes.- Specified by:
- loadin interface- ExecutionControl
- 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
 
- 
redefinepublic 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 interface- ExecutionControl
- Parameters:
- cbcs- the class name and bytecodes to redefine
- Throws:
- ExecutionControl.ClassInstallException- exception occurred redefining the classes, some or all were not redefined
- ExecutionControl.NotImplementedException- if not implemented
- ExecutionControl.EngineTerminationException- the execution engine has terminated
 
- 
classesRedefinedprotected 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 implemented
- ExecutionControl.EngineTerminationException- the execution engine has terminated
 
- 
invokepublic 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 interface- ExecutionControl
- Parameters:
- className- the class whose method should be invoked
- methodName- 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 exception
- ExecutionControl.ResolutionException- the invoke attempted to directly or indirectly invoke an unresolved snippet
- ExecutionControl.StoppedException- if the- invoke()was canceled by- ExecutionControl.stop()
- ExecutionControl.InternalException- an internal problem occurred
- ExecutionControl.EngineTerminationException- the execution engine has terminated
- ExecutionControl.RunException
 
- 
varValuepublic 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 interface- ExecutionControl
- Parameters:
- className- the name of the wrapper class of the variable
- varName- the name of the variable
- Returns:
- the value of the variable
- Throws:
- ExecutionControl.UserException- formatting the value raised a user exception
- ExecutionControl.ResolutionException- formatting the value attempted to directly or indirectly invoke an unresolved snippet
- ExecutionControl.StoppedException- if the formatting the value was canceled by- ExecutionControl.stop()
- ExecutionControl.EngineTerminationException- the execution engine has terminated
- ExecutionControl.InternalException- an internal problem occurred
- ExecutionControl.RunException
 
- 
addToClasspathpublic void addToClasspath(String cp) throws ExecutionControl.EngineTerminationException, ExecutionControl.InternalException Description copied from interface:ExecutionControlAdds the path to the execution class path.- Specified by:
- addToClasspathin interface- ExecutionControl
- Parameters:
- cp- the path to add
- Throws:
- ExecutionControl.EngineTerminationException- the execution engine has terminated
- ExecutionControl.InternalException- an internal problem occurred
 
- 
stoppublic void stop() throws ExecutionControl.EngineTerminationException, ExecutionControl.InternalExceptionInterrupts a running invoke.Not supported. - Specified by:
- stopin interface- ExecutionControl
- Throws:
- ExecutionControl.EngineTerminationException- the execution engine has terminated
- ExecutionControl.InternalException- an internal problem occurred
 
- 
extensionCommandpublic 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 interface- ExecutionControl
- Parameters:
- command- the non-standard command
- arg- the commands argument
- Returns:
- the commands return value
- Throws:
- ExecutionControl.UserException- the command raised a user exception
- ExecutionControl.ResolutionException- the command attempted to directly or indirectly invoke an unresolved snippet
- ExecutionControl.StoppedException- if the command was canceled by- ExecutionControl.stop()
- ExecutionControl.EngineTerminationException- the execution engine has terminated
- ExecutionControl.NotImplementedException- if not implemented
- ExecutionControl.InternalException- an internal problem occurred
- ExecutionControl.RunException
 
- 
closepublic 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 interface- AutoCloseable
- Specified by:
- closein interface- ExecutionControl
 
- 
findClassFinds 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
 
- 
invokeInvoke 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 by- Method.invoke(Object, Object...)or any- ExecutionControl.ExecutionControlExceptionto pass-through.
 
- 
valueStringConverts theObjectvalue fromExecutionControl.invoke(String, String)orExecutionControl.varValue(String, String)toString.- Parameters:
- value- the value to convert
- Returns:
- the Stringrepresentation
 
- 
throwConvertedInvocationExceptionprotected 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 occurrences
- ExecutionControl.InternalException- for internal problems
 
- 
throwConvertedOtherExceptionprotected 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 occurrences
- ExecutionControl.InternalException- for internal problems
 
- 
clientCodeEnterMarks entry into user code.- Throws:
- ExecutionControl.InternalException- in unexpected failure cases
 
- 
clientCodeLeaveMarks departure from user code.- Throws:
- ExecutionControl.InternalException- in unexpected failure cases
 
 
-