ScriptEngine (Java Platform SE 8 )

所有已知实现类：

AbstractScriptEngine
```
public interface ScriptEngine
```
ScriptEngine是基本接口的方法必须在本规范每一个实现全功能。

这些方法提供了基本的脚本功能。写入这个简单的接口的应用程序，预计在每一个实现最小的修改工作。它包括执行脚本的方法，以及设置和获取值的方法。

值的键/值对的两种类型。第一种类型的对由那些在本规范或个别实现中保留和定义的键组成。保留键的对中的值具有指定的意义。

对其他类型包括那些创建java语言绑定的值通常表示在脚本按相应的键，或通过装饰形式的他们。

从以下版本开始：

一点六

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`ARGV` 将一个位置参数数组传递给脚本的命名值的保留键。
`static String`	`ENGINE` 保留关键为命名的值， `ScriptEngine`为名实施的。
`static String`	`ENGINE_VERSION` 保留关键为命名的值表示的 `ScriptEngine`实现的版本。
`static String`	`FILENAME` 为正在执行的文件的名称保留的一个命名值的密钥。
`static String`	`LANGUAGE` 为一个命名的值保留键，该值是由执行支持的脚本语言的全称。
`static String`	`LANGUAGE_VERSION` 标识值的保留键，该值标识由执行支持的脚本语言版本的版本。
`static String`	`NAME` 用于标识脚本语言的短名称的命名值的保留键。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`Bindings`	`createBindings()` 返回一个未初始化的 `Bindings`。
`Object`	`eval(Reader reader)` 同 `eval(String)`除了脚本的源设置为 `Reader`
`Object`	`eval(Reader reader, Bindings n)` 同 `eval(String, Bindings)`除了脚本的源设置为 `Reader`。
`Object`	`eval(Reader reader, ScriptContext context)` 同 `eval(String, ScriptContext)`在脚本的来源是一个 `Reader`读。
`Object`	`eval(String script)` 执行指定的脚本。
`Object`	`eval(String script, Bindings n)` 在脚本执行期间使用 `Bindings`争论的 `ScriptEngine`的 `ENGINE_SCOPE` `Bindings`执行脚本。
`Object`	`eval(String script, ScriptContext context)` 使直接执行脚本的源代码是第一个参数的字符串的直接执行。
`Object`	`get(String key)` 检索该引擎状态中的值集。
`Bindings`	`getBindings(int scope)` 返回指定值的范围。
`ScriptContext`	`getContext()` 返回的 `ScriptEngine`其绑定的默认 `ScriptContext`，读者和作者是用于脚本执行时没有 `ScriptContext`指定。
`ScriptEngineFactory`	`getFactory()` 返回一个类，这 `ScriptEngine` `ScriptEngineFactory`属。
`void`	`put(String key, Object value)` 设置一个键/值对的脚本引擎，可以创建一个java语言结合可用于脚本的执行或被用在一些其他的方式，国家对，取决于关键是保留。
`void`	`setBindings(Bindings bindings, int scope)` 设置脚本使用的命名值的范围。
`void`	`setContext(ScriptContext context)` 套的 `ScriptEngine`其绑定的默认 `ScriptContext`，读者和作者是用于脚本执行时没有 `ScriptContext`指定。

- Field Detail
  - ARGV
```
static final String ARGV
```
    将一个位置参数数组传递给脚本的命名值的保留键。
    
    另请参见：
    
    Constant Field Values
  - FILENAME
```
static final String FILENAME
```
    为正在执行的文件的名称保留的一个命名值的密钥。
    
    另请参见：
    
    Constant Field Values
  - ENGINE
```
static final String ENGINE
```
    保留关键为命名的值， ScriptEngine为名实施的。
    
    另请参见：
    
    Constant Field Values
  - ENGINE_VERSION
```
static final String ENGINE_VERSION
```
    保留关键为命名的值表示的 ScriptEngine实现的版本。
    
    另请参见：
    
    Constant Field Values
  - NAME
```
static final String NAME
```
    用于标识脚本语言的短名称的命名值的保留键。这个名字是由 ScriptEngineManager用于定位 ScriptEngine具有给定名称的 getEngineByName方法。
    
    另请参见：
    
    Constant Field Values
  - LANGUAGE
```
static final String LANGUAGE
```
    为一个命名的值保留键，该值是由执行支持的脚本语言的全称。
    
    另请参见：
    
    Constant Field Values
  - LANGUAGE_VERSION
```
static final String LANGUAGE_VERSION
```
    标识值的保留键，该值标识由执行支持的脚本语言版本的版本。
    
    另请参见：
    
    Constant Field Values
- 方法详细信息
  - eval
```
Object eval(String script,
            ScriptContext context)
     throws ScriptException
```
    使直接执行脚本的源代码是第一个参数的字符串的直接执行。脚本可以解析或重新编译后执行。从以前的执行的引擎中留下的状态，包括变量值和编译过程可能在执行过程中可见。
    
    参数
    
    script -脚本被执行的脚本引擎。
    
    context - ScriptContext暴露在不同范围的属性集。的范围 ScriptContext.GLOBAL_SCOPE的含义，并 ScriptContext.ENGINE_SCOPE规范中定义了。
    
    的 ScriptContext的 ENGINE_SCOPE Bindings包含脚本变量的应用对象是这个脚本执行期间使用的绑定。
    
    结果
    
    从脚本的执行返回的值。
    
    异常
    
    ScriptException -如果在脚本发生错误。scriptengines应该创建并抛出 ScriptException包装检查异常的抛出的基本的脚本实现。
    
    NullPointerException -如果任一参数为null。
  - eval
```
Object eval(Reader reader,
            ScriptContext context)
     throws ScriptException
```
    同 eval(String, ScriptContext)在脚本的来源是一个 Reader读。
    
    参数
    
    reader脚本的可执行的脚本引擎的源。
    
    context - ScriptContext传递给脚本引擎。
    
    结果
    
    从脚本的执行返回的值。
    
    异常
    
    ScriptException -如果在脚本发生错误。
    
    NullPointerException -如果任一参数为null。
  - eval
```
Object eval(String script)
     throws ScriptException
```
    执行指定的脚本。为 ScriptEngine默认使用 ScriptContext。
    
    参数
    
    script -脚本语言源执行。
    
    结果
    
    从脚本的执行返回的值。
    
    异常
    
    ScriptException如果错误发生在脚本。
    
    NullPointerException -如果参数为空。
  - eval
```
Object eval(Reader reader)
     throws ScriptException
```
    同 eval(String)除了脚本的源设置为 Reader
    
    参数
    
    reader脚本的源。
    
    结果
    
    脚本返回的值。
    
    异常
    
    ScriptException -如果在脚本发生错误。
    
    NullPointerException -如果参数为空。
  - eval
```
Object eval(String script,
            Bindings n)
     throws ScriptException
```
    在脚本执行期间使用 Bindings争论的 ScriptEngine的 ENGINE_SCOPE Bindings执行脚本。的 Reader， Writer和非 ENGINE_SCOPE Bindings默认使用的 ScriptContext。该 ScriptEngine的 ENGINE_SCOPE Bindings不改变，及其映射不变的脚本执行。
    
    参数
    
    script -剧本来源。
    
    n -属性可用于脚本执行的 Bindings。
    
    结果
    
    脚本返回的值。
    
    异常
    
    ScriptException -如果在脚本发生错误。
    
    NullPointerException -如果任一参数为null。
  - eval
```
Object eval(Reader reader,
            Bindings n)
     throws ScriptException
```
    同 eval(String, Bindings)除了脚本的源设置为 Reader。
    
    参数
    
    reader脚本的源。
    
    n -属性 Bindings。
    
    结果
    
    脚本返回的值。
    
    异常
    
    ScriptException -如果出现错误。
    
    NullPointerException -如果任一参数为null。
  - put
```
void put(String key,
         Object value)
```
    设置一个键/值对的脚本引擎，可以创建一个java语言结合可用于脚本的执行或被用在一些其他的方式，国家对，取决于关键是保留。必须为 getBindings(ScriptContext.ENGINE_SCOPE).put有相同的效果。
    
    参数
    
    key -命名值添加名称
    
    value -命名的价值增加值。
    
    异常
    
    NullPointerException如果关键是空的。
    
    IllegalArgumentException如果关键是空的。
  - get
```
Object get(String key)
```
    检索该引擎状态中的值集。这个值可能是一个集使用 setValue或其他价值的 ScriptEngine状态，根据实施。必须为 getBindings(ScriptContext.ENGINE_SCOPE).get有相同的效果
    
    参数
    
    key -关键的值被返回
    
    结果
    
    给定键的值
    
    异常
    
    NullPointerException如果关键是空的。
    
    IllegalArgumentException如果关键是空的。
  - getBindings
```
Bindings getBindings(int scope)
```
    返回指定值的范围。可能的范围是：
    - ScriptContext.GLOBAL_SCOPE -命名的值代表全球范围设定。如果这ScriptEngine由ScriptEngineManager创建，然后经理建立了全球范围的绑定。这可能是null如果没有全球范围这ScriptEngine相关
    - ScriptContext.ENGINE_SCOPE -命名的值代表该ScriptEngine状态集。在使用相关的键作为变量名的脚本中，这些值通常是可见的。
    - 任何其他值的范围在ScriptEngine默认ScriptContext定义。
    ，返回 Bindings实例必须是那些通过 ScriptContext称在 ScriptEngine默认 ScriptContext相应参数的 getBindings方法返回相同。
    参数
    
    scope - ScriptContext.ENGINE_SCOPE或 ScriptContext.GLOBAL_SCOPE指定返回 Bindings。实现 ScriptContext可以定义额外的范围。如果该 ScriptEngine默认 ScriptContext定义额外的范围，任何人都可以通过获得相应的 Bindings。
    
    结果
    
    用指定的范围 Bindings。
    
    异常
    
    IllegalArgumentException -如果指定范围无效
  - setBindings
```
void setBindings(Bindings bindings,
                 int scope)
```
    设置脚本使用的命名值的范围。可能的范围是：
    - ScriptContext.ENGINE_SCOPE -指定Bindings取代的ScriptEngine发动机范围。
    - ScriptContext.GLOBAL_SCOPE -指定Bindings必须是可见的GLOBAL_SCOPE。
    - 任何其他值的范围在ScriptEngine默认ScriptContext定义。
    方法必须与 scope对 ScriptEngine默认 ScriptContext对应的值调用 ScriptContext的 setBindings方法有相同的效果。
    参数
    
    bindings为指定范围的 Bindings。
    
    scope -指定范围。无论是 ScriptContext.ENGINE_SCOPE， ScriptContext.GLOBAL_SCOPE，或任何其他有效值范围。
    
    异常
    
    IllegalArgumentException如果范围无效
    
    NullPointerException如果绑定无效的范围 ScriptContext.ENGINE_SCOPE
  - createBindings
```
Bindings createBindings()
```
    返回一个未初始化的 Bindings。
    
    结果
    
    一个 Bindings可以用来代替这个 ScriptEngine状态。
  - getContext
```
ScriptContext getContext()
```
    返回的 ScriptEngine其绑定的默认 ScriptContext，读者和作者是用于脚本执行时没有 ScriptContext指定。
    
    结果
    
    该 ScriptEngine默认 ScriptContext。
  - setContext
```
void setContext(ScriptContext context)
```
    套的 ScriptEngine其绑定的默认 ScriptContext，读者和作者是用于脚本执行时没有 ScriptContext指定。
    
    参数
    
    context - ScriptContext将在 ScriptEngine替换默认的 ScriptContext。
    
    异常
    
    NullPointerException如果背景是空的。
  - getFactory
```
ScriptEngineFactory getFactory()
```
    返回一个类，这 ScriptEngine ScriptEngineFactory属。
    
    结果
    
    的 ScriptEngineFactory

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface ScriptEngine

Field Summary

方法摘要

Field Detail

ARGV

FILENAME

ENGINE

ENGINE_VERSION

NAME

LANGUAGE

LANGUAGE_VERSION

方法详细信息

eval

eval

eval

eval

eval

eval

put

get

getBindings

setBindings

createBindings

getContext

setContext

getFactory