ScriptContext (Java Platform SE 8)

既知のすべての実装クラス:

SimpleScriptContext
```
public interface ScriptContext
```
このインタフェースを実装するクラスは、アプリケーションでスクリプト・エンジンと、スコープ設定されたBindingsなどのオブジェクトとを接続するために使用されます。各スコープは、ScriptContextメソッドを使用して設定および取得可能な値を持つ名前付き属性のセットです。また、ScriptContextは、ScriptEngineが入力と出力に使用可能なReaderとWriterを公開します。

導入されたバージョン:

1.6

フィールドのサマリー

フィールド
修飾子と型	フィールド	説明
`static int`	`ENGINE_SCOPE`	EngineScope属性は、単一の`ScriptEngine`の寿命を通じて可視です。また、属性のセットはエンジンごとに保持されます。
`static int`	`GLOBAL_SCOPE`	GlobalScope属性は、同じScriptEngineFactoryによって作成されたすべてのエンジンに対して可視です。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド抽象メソッド
修飾子と型	メソッド	説明
`Object`	`getAttribute(String name)`	スコープ内で、指定された名前を持つ属性の値を検索し、最初に見つかったものを取得します。
`Object`	`getAttribute(String name, int scope)`	指定されたスコープ内の属性の値を取得します。
`int`	`getAttributesScope(String name)`	属性が定義されている最小のスコープを取得します。
`Bindings`	`getBindings(int scope)`	この`ScriptContext`内の指定されたスコープに関連付けられた`Bindings`を取得します。
`Writer`	`getErrorWriter()`	エラー出力を表示するときに使用する`Writer`を返します。
`Reader`	`getReader()`	入力を読み込むためにスクリプトが使用する`Reader`を返します。
`List<Integer>`	`getScopes()`	ScriptContext内のスコープに対する、すべての有効値の不変の`List`を返します。
`Writer`	`getWriter()`	出力を表示するときに使用するスクリプトの`Writer`を返します。
`Object`	`removeAttribute(String name, int scope)`	指定されたスコープ内の属性を削除します。
`void`	`setAttribute(String name, Object value, int scope)`	指定されたスコープ内の属性の値を設定します。
`void`	`setBindings(Bindings bindings, int scope)`	`Bindings`インスタンスを、この`ScriptContext`内の特定のスコープに関連付けます。
`void`	`setErrorWriter(Writer writer)`	エラー出力を表示するときに使用する`Writer`を設定します。
`void`	`setReader(Reader reader)`	入力を読み込むためのスクリプトの`Reader`を設定します。
`void`	`setWriter(Writer writer)`	出力を表示するときに使用するスクリプトの`Writer`を設定します。

- フィールドの詳細
  - 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内の特定のスコープに関連付けます。 getAttributeおよびsetAttributeメソッドの呼出しでは、特定のスコープに関するBindingsのgetおよびputメソッドをマッピングする必要があります。
    
    パラメータ:
    
    bindings - 指定されたスコープに関連付けられるBindings
    
    scope - スコープ
    
    例外:
    
    IllegalArgumentException - この型のScriptContext内で指定されたスコープ値に対してBindingsが定義されていない場合。
    
    NullPointerException - スコープの値がENGINE_SCOPEで、指定されたBindingsがnullの場合。
  - getBindings
```
Bindings getBindings(int scope)
```
    このScriptContext内の指定されたスコープに関連付けられたBindingsを取得します。
    
    パラメータ:
    
    scope - スコープ
    
    戻り値:
    
    関連付けられたBindings。設定されていない場合はnull。
    
    例外:
    
    IllegalArgumentException - この型のScriptContext内で指定されたスコープ値に対してBindingsが定義されていない場合。
  - setAttribute
```
void setAttribute(String name,
                  Object value,
                  int scope)
```
    指定されたスコープ内の属性の値を設定します。
    
    パラメータ:
    
    name - 設定する属性の名前
    
    value - 属性の値
    
    scope - 属性を設定するスコープ
    
    例外:
    
    IllegalArgumentException - nameが空の場合、またはスコープが無効の場合。
    
    NullPointerException - 名前がnullの場合。
  - getAttribute
```
Object getAttribute(String name,
                    int scope)
```
    指定されたスコープ内の属性の値を取得します。
    
    パラメータ:
    
    name - 取得する属性の名前。
    
    scope - 属性を取得するスコープ。
    
    戻り値:
    
    属性の値。指定されたスコープ内に名前が存在しない場合はnull。
    
    例外:
    
    IllegalArgumentException - nameが空の場合、またはスコープの値が無効の場合。
    
    NullPointerException - 名前がnullの場合。
  - removeAttribute
```
Object removeAttribute(String name,
                       int scope)
```
    指定されたスコープ内の属性を削除します。
    
    パラメータ:
    
    name - 削除する属性の名前
    
    scope - 属性を削除するスコープ
    
    戻り値:
    
    削除された値。
    
    例外:
    
    IllegalArgumentException - nameが空の場合、またはスコープが無効の場合。
    
    NullPointerException - 名前がnullの場合。
  - getAttribute
```
Object getAttribute(String name)
```
    スコープ内で、指定された名前を持つ属性の値を検索し、最初に見つかったものを取得します。検索の順序は、スコープ・パラメータの数値によって決まります(最小のスコープ値が先)。
    
    パラメータ:
    
    name - 取得する属性の名前。
    
    戻り値:
    
    指定された名前を持つ属性が定義されている最小のスコープ内の属性値。指定された名前を持つ属性がどのスコープにも存在しない場合はnull。
    
    例外:
    
    NullPointerException - 名前がnullの場合。
    
    IllegalArgumentException - 名前が空の場合。
  - getAttributesScope
```
int getAttributesScope(String name)
```
    属性が定義されている最小のスコープを取得します。
    
    パラメータ:
    
    name - 属性の名前。
    
    戻り値:
    
    最小のスコープ。指定された名前を持つ属性がどのスコープでも定義されていない場合は -1。
    
    例外:
    
    NullPointerException - nameがnullの場合。
    
    IllegalArgumentException - nameが空の場合。
  - 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 - Writer。
  - getReader
```
Reader getReader()
```
    入力を読み込むためにスクリプトが使用するReaderを返します。
    
    戻り値:
    
    Reader。
  - setReader
```
void setReader(Reader reader)
```
    入力を読み込むためのスクリプトのReaderを設定します。
    
    パラメータ:
    
    reader - 新しいReader。
  - getScopes
```
List<Integer> getScopes()
```
    ScriptContext内のスコープに対する、すべての有効値の不変のListを返します。
    
    戻り値:
    
    スコープ値のリスト

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

インタフェースScriptContext

フィールドのサマリー

メソッドのサマリー

フィールドの詳細

ENGINE_SCOPE

GLOBAL_SCOPE

メソッドの詳細

setBindings

getBindings

setAttribute

getAttribute

removeAttribute

getAttribute

getAttributesScope

getWriter

getErrorWriter

setWriter

setErrorWriter

getReader

setReader

getScopes