Class JdiDefaultExecutionControl
java.lang.Object
jdk.jshell.execution.StreamingExecutionControl
jdk.jshell.execution.JdiExecutionControl
jdk.jshell.execution.JdiDefaultExecutionControl
- All Implemented Interfaces:
AutoCloseable, ExecutionControl
The implementation of
ExecutionControl
that the
JShell-core uses by default.
Launches a remote process -- the "remote agent".
Interfaces to the remote agent over a socket and via JDI.
Designed to work with RemoteExecutionControl
.- Since:
- 9
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic interface
Start an external process where the user's snippets can be run.Nested classes/interfaces declared in interface ExecutionControl
ExecutionControl.ClassBytecodes, ExecutionControl.ClassInstallException, ExecutionControl.EngineTerminationException, ExecutionControl.ExecutionControlException, ExecutionControl.InternalException, ExecutionControl.NotImplementedException, ExecutionControl.ResolutionException, ExecutionControl.RunException, ExecutionControl.StoppedException, ExecutionControl.UserException
Modifier and TypeInterfaceDescriptionstatic final class
Bundles class name with class bytecodes.static class
A class install (load or redefine) encountered a problem.static class
Unbidden execution engine termination has occurred.static class
The abstract base of allExecutionControl
exceptions.static class
An internal problem has occurred.static class
The command is not implemented.static class
An exception indicating that aDeclarationSnippet
with unresolved references has been encountered.static class
The abstract base of of exceptions specific to running user code.static class
An exception indicating that anExecutionControl.invoke(java.lang.String, java.lang.String)
(or theoretically aExecutionControl.varValue(java.lang.String, java.lang.String)
) has been interrupted by aExecutionControl.stop()
.static class
A 'normal' user exception occurred. -
Method Summary
Modifier and TypeMethodDescriptionInvokes an executable Snippet by calling a method on the specified wrapper class.void
stop()
Interrupts a running remote invoke by manipulating remote variables and sending a stop via JDI.protected VirtualMachine
vm()
Returns the JDIVirtualMachine
instance.Methods declared in class JdiExecutionControl
redefine, referenceType
Modifier and TypeMethodDescriptionvoid
Redefine the specified classes.protected ReferenceType
referenceType
(VirtualMachine vm, String name) Returns the JDIReferenceType
corresponding to the specified class name.Methods declared in class StreamingExecutionControl
addToClasspath, close, extensionCommand, load, varValue
Modifier and TypeMethodDescriptionvoid
addToClasspath
(String path) Adds the path to the execution class path.void
close()
Closes the execution engine.extensionCommand
(String command, Object arg) Run a non-standard command (or a standard command from a newer version).void
load
(ExecutionControl.ClassBytecodes[] cbcs) Attempts to load new classes.Returns the value of a variable.Methods declared in class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Modifier and TypeMethodDescriptionprotected Object
clone()
Creates and returns a copy of this object.boolean
Indicates whether some other object is "equal to" this one.protected void
finalize()
Deprecated, for removal: This API element is subject to removal in a future version.Finalization is deprecated and subject to removal in a future release.final Class
<?> getClass()
Returns the runtime class of thisObject
.int
hashCode()
Returns a hash code value for this object.final void
notify()
Wakes up a single thread that is waiting on this object's monitor.final void
Wakes up all threads that are waiting on this object's monitor.toString()
Returns a string representation of the object.final void
wait()
Causes the current thread to wait until it is awakened, typically by being notified or interrupted.final void
wait
(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.final void
wait
(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
-
Method Details
-
invoke
public String invoke(String classname, String methodname) throws ExecutionControl.RunException, ExecutionControl.EngineTerminationException, ExecutionControl.InternalException 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
- Overrides:
invoke
in classStreamingExecutionControl
- 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.EngineTerminationException
- the execution engine has terminatedExecutionControl.InternalException
- an internal problem occurredExecutionControl.RunException
-
stop
public void stop() throws ExecutionControl.EngineTerminationException, ExecutionControl.InternalExceptionInterrupts a running remote invoke by manipulating remote variables and sending a stop via JDI.- Throws:
ExecutionControl.EngineTerminationException
- the execution engine has terminatedExecutionControl.InternalException
- an internal problem occurred
-
vm
Description copied from class:JdiExecutionControl
Returns the JDIVirtualMachine
instance.- Specified by:
vm
in classJdiExecutionControl
- Returns:
- the virtual machine
- Throws:
ExecutionControl.EngineTerminationException
- if the VM is dead/disconnected
-