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

All Known Implementing Classes:

[FailOverExecutionControlProvider](../execution/FailOverExecutionControlProvider.html "class in jdk.jshell.execution"), [JdiExecutionControlProvider](../execution/JdiExecutionControlProvider.html "class in jdk.jshell.execution"), [LocalExecutionControlProvider](../execution/LocalExecutionControlProvider.html "class in jdk.jshell.execution")

public interface ExecutionControlProvider

The provider used by JShell to generate the execution engine needed to evaluate Snippets. Alternate execution engines can be created by implementing this interface, then configuring JShell with the provider or the providers name and parameter specifier.

Since:

9

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

• Method Details

  • name

  The unique name of this ExecutionControlProvider. The name must be a sequence of characters from the Basic Multilingual Plane which areCharacter.isJavaIdentifierPart(char).
  Returns:
  the ExecutionControlProvider's name

  • 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).
  Returns:
  the default parameter map

  • generate

  Create and return the ExecutionControl instance.
  Parameters:
  env - the execution environment, provided by JShell
  parameters - the default or modified parameter map.
  Returns:
  the execution engine
  Throws:
  [Throwable](../../../../java.base/java/lang/Throwable.html "class in java.lang") - an exception that occurred attempting to create the execution engine.