Module jdk.jshell

Package jdk.jshell.execution

Class Util

java.lang.Object

jdk.jshell.execution.Util

public class Util
extends Object

Miscellaneous utility methods for setting-up implementations of ExecutionControl. Particularly implementations with remote execution.

Method Summary

Modifier and Type	Method and Description
static void	detectJDIExitEvent(com.sun.jdi.VirtualMachine vm, Consumer<String> unbiddenExitHandler) Monitor the JDI event stream for VMDeathEvent and VMDisconnectEvent.
static ExecutionControl.Generator	failOverExecutionControlGenerator(ExecutionControl.Generator gec0, ExecutionControl.Generator... gecs) Create a composite ExecutionControl.Generator instance that, when generating, will try each specified generator until successfully creating an ExecutionControl instance, or, if all fail, will re-throw the first exception.
static void	forwardExecutionControl(ExecutionControl ec, ObjectInput in, ObjectOutput out) Forward commands from the input to the specified ExecutionControl instance, then responses back on the output.
static void	forwardExecutionControlAndIO(ExecutionControl ec, InputStream inStream, OutputStream outStream, Map<String,Consumer<OutputStream>> streamMap) Forward commands from the input to the specified ExecutionControl instance, then responses back on the output.
static void	forwardInputToRemote(InputStream inputStream, OutputStream outStream, Consumer<Exception> handler) Creates a Thread that will ship all input to the remote agent.
static ObjectInput	remoteInput(InputStream input, Map<String,OutputStream> streamMap) Reads from an InputStream which has been packetized and write its contents to the out and err OutputStreams; Copies the command stream.

Methods inherited from class java.lang.Object

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

Method Detail

failOverExecutionControlGenerator

public static ExecutionControl.Generator failOverExecutionControlGenerator(ExecutionControl.Generator gec0,
                                                                           ExecutionControl.Generator... gecs)

Create a composite ExecutionControl.Generator instance that, when generating, will try each specified generator until successfully creating an ExecutionControl instance, or, if all fail, will re-throw the first exception.

Parameters:

gec0 - the first instance to try

gecs - the second through Nth instance to try

Returns:

the fail-over generator

forwardExecutionControl

public static void forwardExecutionControl(ExecutionControl ec,
                                           ObjectInput in,
                                           ObjectOutput out)

Forward commands from the input to the specified ExecutionControl instance, then responses back on the output.

Parameters:

ec - the direct instance of ExecutionControl to process commands

in - the command input

out - the command response output

forwardExecutionControlAndIO

public static void forwardExecutionControlAndIO(ExecutionControl ec,
                                                InputStream inStream,
                                                OutputStream outStream,
                                                Map<String,Consumer<OutputStream>> streamMap)
                                         throws IOException

Forward commands from the input to the specified ExecutionControl instance, then responses back on the output.

Parameters:

ec - the direct instance of ExecutionControl to process commands

inStream - the stream from which to create the command input

outStream - the stream that will carry System.out, System.err, any specified auxiliary channels, and the command response output.

streamMap - a map between names of additional streams to carry and setters for the stream

Throws:

IOException - if there are errors using the passed streams

remoteInput

public static ObjectInput remoteInput(InputStream input,
                                      Map<String,OutputStream> streamMap)
                               throws IOException

Reads from an InputStream which has been packetized and write its contents to the out and err OutputStreams; Copies the command stream.

Parameters:

input - the packetized input stream

streamMap - a map between stream names and the output streams to forward

Returns:

the command stream

Throws:

IOException - if setting up the streams raised an exception

detectJDIExitEvent

public static void detectJDIExitEvent(com.sun.jdi.VirtualMachine vm,
                                      Consumer<String> unbiddenExitHandler)

Monitor the JDI event stream for VMDeathEvent and VMDisconnectEvent. If encountered, invokes unbiddenExitHandler.

Parameters:

vm - the virtual machine to check

unbiddenExitHandler - the handler, which will accept the exit information

forwardInputToRemote

public static void forwardInputToRemote(InputStream inputStream,
                                        OutputStream outStream,
                                        Consumer<Exception> handler)

Creates a Thread that will ship all input to the remote agent.

Parameters:

inputStream - the user input

outStream - the input to the remote agent

handler - a failure handler