Class JdiExecutionControl
java.lang.Object
jdk.jshell.execution.StreamingExecutionControl
jdk.jshell.execution.JdiExecutionControl
- All Implemented Interfaces:
AutoCloseable, ExecutionControl
- Direct Known Subclasses:
JdiDefaultExecutionControl
public abstract class JdiExecutionControl
extends StreamingExecutionControl
implements ExecutionControl
Abstract JDI implementation of
ExecutionControl
.- Since:
- 9
-
Nested Class Summary
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. -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotected
JdiExecutionControl
(ObjectOutput out, ObjectInput in) Create an instance. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Redefine the specified classes.protected ReferenceType
referenceType
(VirtualMachine vm, String name) Returns the JDIReferenceType
corresponding to the specified class name.protected abstract VirtualMachine
vm()
Returns the JDIVirtualMachine
instance.Methods declared in class StreamingExecutionControl
addToClasspath, close, extensionCommand, invoke, load, stop, 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).Invokes an executable Snippet by calling a method on the specified wrapper class.void
load
(ExecutionControl.ClassBytecodes[] cbcs) Attempts to load new classes.void
stop()
Interrupts a running invoke.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.
-
Constructor Details
-
JdiExecutionControl
Create an instance.- Parameters:
out
- the output from the remote agentin
- the input to the remote agent
-
-
Method Details
-
vm
Returns the JDIVirtualMachine
instance.- Returns:
- the virtual machine
- Throws:
ExecutionControl.EngineTerminationException
- if the VM is dead/disconnected
-
redefine
public void redefine(ExecutionControl.ClassBytecodes[] cbcs) throws ExecutionControl.ClassInstallException, ExecutionControl.EngineTerminationException Redefine the specified classes. Where 'redefine' is, as in JDI and JVMTI, an in-place replacement of the classes (preserving class identity) -- that is, existing references to the class do not need to be recompiled. This implementation uses JDIVirtualMachine.redefineClasses(java.util.Map)
. It will be unsuccessful if the signature of the class has changed (see the JDI spec). The JShell-core is designed to adapt to unsuccessful redefine.- 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.EngineTerminationException
- the execution engine has terminated
-
referenceType
Returns the JDIReferenceType
corresponding to the specified class name.- Parameters:
vm
- the current JDIVirtualMachine
as returned byvm()
name
- the class name to look-up- Returns:
- the corresponding
ReferenceType
-