JdiExecutionControlProvider (Java SE 19 & JDK 19) (original) (raw)

All Implemented Interfaces:

[ExecutionControlProvider](../spi/ExecutionControlProvider.html "interface in jdk.jshell.spi")

A provider of remote JDI-controlled execution engines.

Since:

9

• Field Summary

Fields
The local hostname to connect to.
Should JDI-controlled launching be used?
The remote agent to launch.
Milliseconds before connect timeout.

• Constructor Summary

Constructors

• Method Summary

Create and return the default parameter map for thisExecutionControlProvider.
Create and return the ExecutionControl instance.
[name](#name%28%29)()
The unique name of this ExecutionControlProvider.

Methods declared in class java.lang.Object

[clone](../../../../java.base/java/lang/Object.html#clone%28%29), [equals](../../../../java.base/java/lang/Object.html#equals%28java.lang.Object%29), [finalize](../../../../java.base/java/lang/Object.html#finalize%28%29), [getClass](../../../../java.base/java/lang/Object.html#getClass%28%29), [hashCode](../../../../java.base/java/lang/Object.html#hashCode%28%29), [notify](../../../../java.base/java/lang/Object.html#notify%28%29), [notifyAll](../../../../java.base/java/lang/Object.html#notifyAll%28%29), [toString](../../../../java.base/java/lang/Object.html#toString%28%29), [wait](../../../../java.base/java/lang/Object.html#wait%28%29), [wait](../../../../java.base/java/lang/Object.html#wait%28long%29), [wait](../../../../java.base/java/lang/Object.html#wait%28long,int%29)

• Field Details

  • PARAM_REMOTE_AGENT

  public static final String PARAM_REMOTE_AGENT
  The remote agent to launch.
  See Also:
  * Constant Field Values

  • PARAM_TIMEOUT

  public static final String PARAM_TIMEOUT
  Milliseconds before connect timeout.
  See Also:
  * Constant Field Values

  • PARAM_HOST_NAME

  public static final String PARAM_HOST_NAME
  The local hostname to connect to.
  See Also:
  * Constant Field Values

  • PARAM_LAUNCH

  public static final String PARAM_LAUNCH
  Should JDI-controlled launching be used?
  See Also:
  * Constant Field Values

• Constructor Details

  • JdiExecutionControlProvider

  public JdiExecutionControlProvider()
  Create an instance. An instance can be used togenerate an ExecutionControl instance that uses the Java Debug Interface as part of the control of a remote process.

• Method Details

  • name

  The unique name of this ExecutionControlProvider.
  Specified by:
  [name](../spi/ExecutionControlProvider.html#name%28%29) in interface [ExecutionControlProvider](../spi/ExecutionControlProvider.html "interface in jdk.jshell.spi")
  Returns:
  "jdi"

  • defaultParameters

  Create and return the default parameter map for thisExecutionControlProvider. The map can optionally be modified; Modified or unmodified it can be passed togenerate(jdk.jshell.spi.ExecutionEnv, java.util.Map).
  Parameters

  Parameter	Description	Constant Field
  remoteAgent	the remote agent to launch	PARAM_REMOTE_AGENT
  timeout	milliseconds before connect timeout	PARAM_TIMEOUT
  launch	"true" for JDI controlled launch	PARAM_LAUNCH
  hostname	connect to the named of the local host ("" for discovered)	PARAM_HOST_NAME
  Specified by:
  [defaultParameters](../spi/ExecutionControlProvider.html#defaultParameters%28%29) in interface [ExecutionControlProvider](../spi/ExecutionControlProvider.html "interface in jdk.jshell.spi")
  Returns:
  the default parameter map

  • generate

  Create and return the ExecutionControl instance.
  Specified by:
  [generate](../spi/ExecutionControlProvider.html#generate%28jdk.jshell.spi.ExecutionEnv,java.util.Map%29) in interface [ExecutionControlProvider](../spi/ExecutionControlProvider.html "interface in jdk.jshell.spi")
  Parameters:
  env - the execution environment, provided by JShell
  parameters - the default or modified parameter map.
  Returns:
  the execution engine
  Throws:
  [IOException](../../../../java.base/java/io/IOException.html "class in java.io")