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 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

JdiExecutionControl(ObjectOutput out, ObjectInput in)
Modifier Constructor Description
protected
Create an instance.

Method Summary

Modifier and Type Method Description
void redefine(ExecutionControl.ClassBytecodes[] cbcs)
Redefine the specified classes.
protected ReferenceType referenceType(VirtualMachine vm, String name)
Returns the JDI ReferenceType corresponding to the specified class name.
protected abstract VirtualMachine vm()
Returns the JDI VirtualMachine instance.

Methods declared in class jdk.jshell.execution.StreamingExecutionControl

addToClasspath, close, extensionCommand, invoke, load, stop, varValue

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods declared in interface jdk.jshell.spi.ExecutionControl

addToClasspath, close, extensionCommand, invoke, load, stop, varValue

Constructor Details

JdiExecutionControl

protected JdiExecutionControl(ObjectOutput out, ObjectInput in)
Create an instance.
Parameters:
out - the output from the remote agent
in - the input to the remote agent

Method Details

vm

protected abstract VirtualMachine vm() throws ExecutionControl.EngineTerminationException
Returns the JDI VirtualMachine 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 JDI VirtualMachine.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 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.EngineTerminationException - the execution engine has terminated

referenceType

protected ReferenceType referenceType(VirtualMachine vm, String name)
Returns the JDI ReferenceType corresponding to the specified class name.
Parameters:
vm - the current JDI VirtualMachine as returned by vm()
name - the class name to look-up
Returns:
the corresponding ReferenceType

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/jdk.jshell/jdk/jshell/execution/JdiExecutionControl.html