模块  java.scripting
软件包  javax.script

Interface ScriptContext

  • 所有已知实现类：
    SimpleScriptContext 
    public interface ScriptContext
    实现类的接口用于在托管应用程序中将脚本引擎与对象（如作用域绑定）连接起来。 每个范围都是一组命名属性，可以使用ScriptContext方法设置和检索其值。 ScriptContexts还公开了ScriptEngines可用于输入和输出的读者和写者。
    从以下版本开始：
    1.6

    • 字段详细信息

      • ENGINE_SCOPE

        static final int ENGINE_SCOPE
        EngineScope属性在单个 ScriptEngine的生命周期内可见，并为每个引擎维护一组属性。
        另请参见：
        常数字段值

      • GLOBAL_SCOPE

        static final int GLOBAL_SCOPE
        GlobalScope属性对同一ScriptEngineFactory创建的所有引擎都可见。
        另请参见：
        常数字段值

    • 方法详细信息

      • setBindings

        void setBindings​(Bindings bindings,
                 int scope)
        将Bindings实例与此ScriptContext的特定范围ScriptContext 。 对getAttribute和setAttribute方法的调用必须映射到指定范围的Bindings的get和put方法。
        参数
        bindings - 与给定范围关联的 Bindings
        scope - 范围
        异常
        IllegalArgumentException - 如果没有为此类型的ScriptContexts中的指定范围值定义 Bindings 。
        NullPointerException - 如果范围的值为 ENGINE_SCOPE且指定的 Bindings为空。

      • getBindings

        Bindings getBindings​(int scope)
        获取与此 Bindings中的给定范围关联的 ScriptContext 。
        参数
        scope - 范围
        结果
        相关联的Bindings 。 如果尚未设置，则返回null 。
        异常
        IllegalArgumentException -如果没有 Bindings被用于在指定的范围值定义 ScriptContext这种类型。

      • setAttribute

        void setAttribute​(String name,
                  Object value,
                  int scope)
        设置给定范围中属性的值。 如果范围是GLOBAL_SCOPE并且没有为GLOBAL_SCOPE设置GLOBAL_SCOPE ，则setAttribute调用是无操作。
        参数
        name - 要设置的属性的名称
        value - 属性的值
        scope - 设置属性的范围
        异常
        IllegalArgumentException - 如果名称为空或范围无效。
        NullPointerException - 如果名称为null。

      • getAttribute

        Object getAttribute​(String name,
                    int scope)
        获取给定范围内的属性的值。
        参数
        name - 要检索的属性的名称。
        scope - 检索属性的范围。
        结果
        属性的值。 返回null是给定范围中不存在的名称。
        异常
        IllegalArgumentException - 如果名称为空或作用域的值无效。
        NullPointerException - 如果名称为null。

      • removeAttribute

        Object removeAttribute​(String name,
                       int scope)
        删除给定范围中的属性。
        参数
        name - 要删除的属性的名称
        scope - 删除属性的范围
        结果
        删除的值。
        异常
        IllegalArgumentException - 如果名称为空或范围无效。
        NullPointerException - 如果名称为null。

      • getAttribute

        Object getAttribute​(String name)
        检索在搜索顺序中最早发生的范围内具有给定名称的属性的值。 顺序由范围参数的数值确定（首先是最低范围值。）
        参数
        name - 要检索的属性的名称。
        结果
        定义具有给定名称的属性的最低范围中的属性的值。 如果任何范围中都不存在具有该名称的属性，则返回null。
        异常
        NullPointerException - 如果名称为null。
        IllegalArgumentException - 如果名称为空。

      • getAttributesScope

        int getAttributesScope​(String name)
        获取定义属性的最低范围。
        参数
        name - 属性的名称。
        结果
        最低范围。 如果在任何范围内未定义具有给定名称的属性，则返回-1。
        异常
        NullPointerException - 如果name为null。
        IllegalArgumentException - 如果名称为空。

      • getWriter

        Writer getWriter()
        返回显示输出时要使用的脚本的 Writer 。
        结果
        Writer 。

      • getErrorWriter

        Writer getErrorWriter()
        返回用于显示错误输出的 Writer 。
        结果
        Writer

      • setWriter

        void setWriter​(Writer writer)
        为显示输出时要使用的脚本设置 Writer 。
        参数
        writer - 新的 Writer 。

      • setErrorWriter

        void setErrorWriter​(Writer writer)
        设置用于显示错误输出的 Writer 。
        参数
        writer - The Writer 。

      • getReader

        Reader getReader()
        返回脚本用于读取输入的 Reader 。
        结果
        Reader 。

      • setReader

        void setReader​(Reader reader)
        为脚本设置 Reader以读取输入。
        参数
        reader - 新的 Reader 。

      • getScopes

        List<Integer> getScopes()
        返回ScriptContext中范围的所有有效值的不可变 List 。
        结果
        范围值列表