javax.script
인터페이스 ScriptContext

기존의 구현 클래스의 일람:

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 를 가져옵니다.

반환값:

관련지을 수 있고 있는 Bindings. 설정되어 있지 않은 경우는 null.

예외:

IllegalArgumentException - 이 형태의 ScriptContext 내에서 지정된 스코프치에 대해서 Bindings 가 정의되어 있지 않은 경우.

setAttribute

void setAttribute(String  name,
                  Object  value,
                  int scope)

지정된 스코프내의 속성의 값을 설정합니다.

파라미터:

name - 설정하는 속성의 이름

value - 속성의 값

scope - 속성을 설정하는 스코프

예외:

IllegalArgumentException - name 가 빈 상태(empty)의 경우, 또는 스코프가 무효의 경우.

NullPointerException - 이름이 null 의 경우.

getAttribute

Object  getAttribute(String  name,
                    int scope)

지정된 스코프내의 속성의 값을 가져옵니다.

파라미터:

name - 취득하는 속성의 이름.

scope - 속성을 취득하는 스코프.

반환값:

속성의 값. 지정된 스코프내에 이름이 존재하지 않는 경우는 null.

예외:

IllegalArgumentException - name 가 빈 상태(empty)의 경우, 또는 스코프의 값이 무효의 경우.

NullPointerException - 이름이 null 의 경우.

removeAttribute

Object  removeAttribute(String  name,
                       int scope)

지정된 스코프내의 속성을 삭제합니다.

파라미터:

name - 삭제하는 속성의 이름

scope - 속성을 삭제하는 스코프

반환값:

삭제된 값.

예외:

IllegalArgumentException - name 가 빈 상태(empty)의 경우, 또는 스코프가 무효의 경우.

NullPointerException - 이름이 null 의 경우.

getAttribute

Object  getAttribute(String  name)

스코프내에서, 지정된 이름을 가지는 속성의 값을 검색해, 최초로 발견된 것을 가져옵니다. 검색의 순서는, 스코프 파라미터의 수치에 의해 정해집니다 (최소의 스코프치가 앞).

파라미터:

name - 취득하는 속성의 이름.

반환값:

지정된 이름을 가지는 속성이 정의되고 있는 최소의 스코프내의 속성치. 지정된 이름을 가지는 속성이 어느 스코프에도 존재하지 않는 경우는 null.

예외:

NullPointerException - 이름이 null 의 경우.

IllegalArgumentException - 이름이 빈 상태(empty)의 경우.

getAttributesScope

int getAttributesScope(String  name)

속성이 정의되고 있는 최소의 스코프를 가져옵니다.

파라미터:

name - 속성의 이름 .

반환값:

최소의 스코프. 지정된 이름을 가지는 속성이 어느 스코프에서도 정의되어 있지 않은 경우는 -1.

예외:

NullPointerException - name 가 null 의 경우.

IllegalArgumentException - name 가 빈 상태(empty)의 경우.

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 를 돌려줍니다.

반환값:

스코프치의 리스트