ScriptEngine (Java Platform SE 8 )

All Known Implementing Classes:

AbstractScriptEngine
```
public interface ScriptEngine
```
ScriptEngine is the fundamental interface whose methods must be fully functional in every implementation of this specification.

These methods provide basic scripting functionality. Applications written to this simple interface are expected to work with minimal modifications in every implementation. It includes methods that execute scripts, and ones that set and get values.

The values are key/value pairs of two types. The first type of pairs consists of those whose keys are reserved and defined in this specification or by individual implementations. The values in the pairs with reserved keys have specified meanings.

The other type of pairs consists of those that create Java language Bindings, the values are usually represented in scripts by the corresponding keys or by decorated forms of them.

Since:

1.6

Field Summary

Fields
Modifier and Type	Field	Description
`static String`	`ARGV`	Reserved key for a named value that passes an array of positional arguments to a script.
`static String`	`ENGINE`	Reserved key for a named value that is the name of the `ScriptEngine` implementation.
`static String`	`ENGINE_VERSION`	Reserved key for a named value that identifies the version of the `ScriptEngine` implementation.
`static String`	`FILENAME`	Reserved key for a named value that is the name of the file being executed.
`static String`	`LANGUAGE`	Reserved key for a named value that is the full name of Scripting Language supported by the implementation.
`static String`	`LANGUAGE_VERSION`	Reserved key for the named value that identifies the version of the scripting language supported by the implementation.
`static String`	`NAME`	Reserved key for a named value that identifies the short name of the scripting language.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`Bindings`	`createBindings()`	Returns an uninitialized `Bindings`.
`Object`	`eval(Reader reader)`	Same as `eval(String)` except that the source of the script is provided as a `Reader`
`Object`	`eval(Reader reader, Bindings n)`	Same as `eval(String, Bindings)` except that the source of the script is provided as a `Reader`.
`Object`	`eval(Reader reader, ScriptContext context)`	Same as `eval(String, ScriptContext)` where the source of the script is read from a `Reader`.
`Object`	`eval(String script)`	Executes the specified script.
`Object`	`eval(String script, Bindings n)`	Executes the script using the `Bindings` argument as the `ENGINE_SCOPE` `Bindings` of the `ScriptEngine` during the script execution.
`Object`	`eval(String script, ScriptContext context)`	Causes the immediate execution of the script whose source is the String passed as the first argument.
`Object`	`get(String key)`	Retrieves a value set in the state of this engine.
`Bindings`	`getBindings(int scope)`	Returns a scope of named values.
`ScriptContext`	`getContext()`	Returns the default `ScriptContext` of the `ScriptEngine` whose Bindings, Reader and Writers are used for script executions when no `ScriptContext` is specified.
`ScriptEngineFactory`	`getFactory()`	Returns a `ScriptEngineFactory` for the class to which this `ScriptEngine` belongs.
`void`	`put(String key, Object value)`	Sets a key/value pair in the state of the ScriptEngine that may either create a Java Language Binding to be used in the execution of scripts or be used in some other way, depending on whether the key is reserved.
`void`	`setBindings(Bindings bindings, int scope)`	Sets a scope of named values to be used by scripts.
`void`	`setContext(ScriptContext context)`	Sets the default `ScriptContext` of the `ScriptEngine` whose Bindings, Reader and Writers are used for script executions when no `ScriptContext` is specified.

- Field Detail
  - ARGV
```
static final String ARGV
```
    Reserved key for a named value that passes an array of positional arguments to a script.
    
    See Also:
    
    Constant Field Values
  - FILENAME
```
static final String FILENAME
```
    Reserved key for a named value that is the name of the file being executed.
    
    See Also:
    
    Constant Field Values
  - ENGINE
```
static final String ENGINE
```
    Reserved key for a named value that is the name of the ScriptEngine implementation.
    
    See Also:
    
    Constant Field Values
  - ENGINE_VERSION
```
static final String ENGINE_VERSION
```
    Reserved key for a named value that identifies the version of the ScriptEngine implementation.
    
    See Also:
    
    Constant Field Values
  - NAME
```
static final String NAME
```
    Reserved key for a named value that identifies the short name of the scripting language. The name is used by the ScriptEngineManager to locate a ScriptEngine with a given name in the getEngineByName method.
    
    See Also:
    
    Constant Field Values
  - LANGUAGE
```
static final String LANGUAGE
```
    Reserved key for a named value that is the full name of Scripting Language supported by the implementation.
    
    See Also:
    
    Constant Field Values
  - LANGUAGE_VERSION
```
static final String LANGUAGE_VERSION
```
    Reserved key for the named value that identifies the version of the scripting language supported by the implementation.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - eval
```
Object eval(String script,
            ScriptContext context)
     throws ScriptException
```
    Causes the immediate execution of the script whose source is the String passed as the first argument. The script may be reparsed or recompiled before execution. State left in the engine from previous executions, including variable values and compiled procedures may be visible during this execution.
    
    Parameters:
    
    script - The script to be executed by the script engine.
    
    context - A ScriptContext exposing sets of attributes in different scopes. The meanings of the scopes ScriptContext.GLOBAL_SCOPE, and ScriptContext.ENGINE_SCOPE are defined in the specification.
    
    The ENGINE_SCOPE Bindings of the ScriptContext contains the bindings of scripting variables to application objects to be used during this script execution.
    
    Returns:
    
    The value returned from the execution of the script.
    
    Throws:
    
    ScriptException - if an error occurs in script. ScriptEngines should create and throw ScriptException wrappers for checked Exceptions thrown by underlying scripting implementations.
    
    NullPointerException - if either argument is null.
  - eval
```
Object eval(Reader reader,
            ScriptContext context)
     throws ScriptException
```
    Same as eval(String, ScriptContext) where the source of the script is read from a Reader.
    
    Parameters:
    
    reader - The source of the script to be executed by the script engine.
    
    context - The ScriptContext passed to the script engine.
    
    Returns:
    
    The value returned from the execution of the script.
    
    Throws:
    
    ScriptException - if an error occurs in script.
    
    NullPointerException - if either argument is null.
  - eval
```
Object eval(String script)
     throws ScriptException
```
    Executes the specified script. The default ScriptContext for the ScriptEngine is used.
    
    Parameters:
    
    script - The script language source to be executed.
    
    Returns:
    
    The value returned from the execution of the script.
    
    Throws:
    
    ScriptException - if error occurs in script.
    
    NullPointerException - if the argument is null.
  - eval
```
Object eval(Reader reader)
     throws ScriptException
```
    Same as eval(String) except that the source of the script is provided as a Reader
    
    Parameters:
    
    reader - The source of the script.
    
    Returns:
    
    The value returned by the script.
    
    Throws:
    
    ScriptException - if an error occurs in script.
    
    NullPointerException - if the argument is null.
  - eval
```
Object eval(String script,
            Bindings n)
     throws ScriptException
```
    Executes the script using the Bindings argument as the ENGINE_SCOPE Bindings of the ScriptEngine during the script execution. The Reader, Writer and non-ENGINE_SCOPE Bindings of the default ScriptContext are used. The ENGINE_SCOPE Bindings of the ScriptEngine is not changed, and its mappings are unaltered by the script execution.
    
    Parameters:
    
    script - The source for the script.
    
    n - The Bindings of attributes to be used for script execution.
    
    Returns:
    
    The value returned by the script.
    
    Throws:
    
    ScriptException - if an error occurs in script.
    
    NullPointerException - if either argument is null.
  - eval
```
Object eval(Reader reader,
            Bindings n)
     throws 
```

Interface ScriptEngine

Field Summary

Method Summary

Field Detail

ARGV

FILENAME

ENGINE

ENGINE_VERSION

NAME

LANGUAGE

LANGUAGE_VERSION

Method Detail

eval

eval

eval

eval

eval

eval