|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 |
public interface ScriptEngine
ScriptEngine
는, 이 스펙의 모든 구현으로 완전하게 기능하는 것이 필요한 메소드를 가지는 기본 인터페이스입니다.
이러한 메소드는, 기본적인 스크립트 기능을 제공합니다. 이 단순한 인터페이스에 기술된 어플리케이션은, 어느 구현에서도 최소한의 변경으로 동작하는 것이 상정되고 있습니다. 스크립트를 실행하는 메소드, 값을 설정 및 취득하는 메소드가 포함됩니다.
값은, 2 종류의 키와 값의 페어입니다. 최초의 페어는, 키가 예약되어 이 스펙 또는 개별의 구현에 의해 정의되어서로 구성됩니다. 예약 끝난 키를 가지는 페어내의 값은, 지정된 의미를 가집니다.
이제(벌써) 한편의 페어는, Java 언어의 Bindings 를 작성해서로 구성됩니다. 일반적으로, 값은 스크립트내에서, 대응하는 키 또는 그러한 데코레이트 된 형식에 의해 나타내집니다.
필드의 개요 | |
---|---|
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
스크립트 언어의 짧은 이름을 식별하는 이름 첨부치의 예약이 끝난 키입니다. |
메소드의 개요 | |
---|---|
Bindings |
createBindings ()
초기화되어 있지 않은 Bindings 를 돌려줍니다. |
Object |
eval (Reader reader)
스크립트의 소스가 Reader 로서 제공되는 것을 제외해,eval(String) 와 같습니다. |
Object |
eval (Reader reader,
Bindings n)
스크립트의 소스가 Reader 로서 제공되는 것을 제외해,eval(String, Bindings) 와 같습니다. |
Object |
eval (Reader reader,
ScriptContext context)
스크립트의 소스가 Reader 로부터 읽히는 경우,eval(String, ScriptContext) 와 같습니다. |
Object |
eval (String script)
지정된 스크립트를 실행합니다. |
Object |
eval (String script,
Bindings n)
스크립트의 실행중에, Bindings 인수를 ScriptEngine 의 ENGINE_SCOPE Bindings 로서 사용합니다. |
Object |
eval (String script,
ScriptContext context)
소스가 1 번째의 인수로서 건네받은 String 인 스크립트를 즉시 실행합니다. |
Object |
get (String key)
이 엔진 상태의 값세트를 가져옵니다. |
Bindings |
getBindings (int scope)
이름 첨부치의 스코프를 돌려줍니다. |
ScriptContext |
getContext ()
ScriptContext 가 지정되어 있지 않은 경우에 스크립트의 실행에 사용되는 Bindings, Reader, 및 Writer 를 가지는 ScriptEngine 의 디폴트의 ScriptContext 를 돌려줍니다. |
ScriptEngineFactory |
getFactory ()
이 ScriptEngine 이 속하는 ScriptEngineFactory 를 돌려줍니다. |
void |
put (String key,
Object value)
ScriptEngine 상태에 키와 값의 페어를 설정합니다. |
void |
setBindings (Bindings bindings,
int scope)
스크립트에 의해 사용되는 이름 첨부치의 스코프를 설정합니다. |
void |
setContext (ScriptContext context)
ScriptContext 가 지정되어 있지 않은 경우에 스크립트의 실행에 사용되는 Bindings, Reader, 및 Writer 를 가지는 ScriptEngine 의 디폴트의 ScriptContext 를 설정합니다. |
필드의 상세 |
---|
static final String ARGV
static final String FILENAME
static final String ENGINE
ScriptEngine
구현의 이름인 이름 첨부치의 예약이 끝난 키입니다.
static final String ENGINE_VERSION
ScriptEngine
구현의 버젼을 식별하는 이름 첨부치의 예약이 끝난 키입니다.
static final String NAME
ScriptEngineManager
가, 지정된 이름을 가지는 ScriptEngine
를 getEngineByName
메소드내에서 찾기 위해서(때문에) 사용됩니다.
static final String LANGUAGE
static final String LANGUAGE_VERSION
메소드의 상세 |
---|
Object eval(String script, ScriptContext context) throws ScriptException
script
- 스크립트 엔진에 의해 실행되는 스크립트. context
- 다른 스코프내의 속성의 ScriptContext
공개 세트. 스코프 ScriptContext.GLOBAL_SCOPE
및 ScriptContext.ENGINE_SCOPE
의 의미는, 스펙으로 정의되고 있다.
ScriptContext
의 ENGINE_SCOPE
Bindings
에는, 이 스크립트의 실행중에 사용되는, 어플리케이션 객체에의 스크립트 변수의 바인딩이 포함됩니다.
ScriptException
- 스크립트로 에러가 발생했을 경우. 기본이 되는 스크립트의 구현에 의해 throw 된 확인 끝난 예외의 ScriptException
래퍼를, ScriptEngines 가 작성 및 throw 한다.
NullPointerException
- 어느 쪽인가의 인수가 null 의 경우. Object eval(Reader reader, ScriptContext context) throws ScriptException
Reader
로부터 읽히는 경우,eval(String, ScriptContext)
와 같습니다.
reader
- 스크립트 엔진에 의해 실행되는 스크립트의 소스. context
- 스크립트 엔진에게 건네지는 ScriptContext
.
ScriptException
- 스크립트로 에러가 발생했을 경우.
NullPointerException
- 어느 쪽인가의 인수가 null 의 경우. Object eval(String script) throws ScriptException
ScriptEngine
의 디폴트의 ScriptContext
가 사용됩니다.
script
- 실행되는 스크립트 언어 소스.
ScriptException
- 스크립트로 에러가 발생했을 경우.
NullPointerException
- 인수가 null 의 경우Object eval(Reader reader) throws ScriptException
Reader
로서 제공되는 것을 제외해,eval(String)
와 같습니다.
reader
- 스크립트의 소스.
ScriptException
- 스크립트로 에러가 발생했을 경우.
NullPointerException
- 인수가 null 의 경우. Object eval(String script, Bindings n) throws ScriptException
Bindings
인수를 ScriptEngine
의 ENGINE_SCOPE
Bindings
로서 사용합니다. 디폴트의 ScriptContext
의 Reader
,Writer
, 및 ENGINE_SCOPE
이외의 Bindings
가 사용됩니다. ScriptEngine
의 ENGINE_SCOPE
Bindings
는 변경되지 않고, 그 매핑도 스크립트의 실행에 의해 변경되지 않습니다.
script
- 스크립트의 소스. n
- 스크립트의 실행에 사용되는 속성의 Bindings
.
ScriptException
- 스크립트로 에러가 발생했을 경우.
NullPointerException
- 어느 쪽인가의 인수가 null 의 경우. Object eval(Reader reader, Bindings n) throws ScriptException
Reader
로서 제공되는 것을 제외해,eval(String, Bindings)
와 같습니다.
reader
- 스크립트의 소스. n
- 속성의 Bindings
.
ScriptException
- 에러가 발생했을 경우.
NullPointerException
- 어느 쪽인가의 인수가 null 의 경우. void put(String key, Object value)
getBindings(ScriptContext.ENGINE_SCOPE). put
와 같은 효과를 가지고 있을 필요가 있습니다.
key
- 추가하는 이름 첨부치의 이름value
- 추가하는 이름 첨부치의 값.
NullPointerException
- key 가 null 의 경우.
IllegalArgumentException
- key 가 빈 상태(empty)의 경우. Object get(String key)
setValue
를 사용해 설정된 값인가,ScriptEngine
상태외의 값이 될 가능성이 있습니다. getBindings(ScriptContext.ENGINE_SCOPE). get
와 같은 효과를 가지고 있을 필요가 있습니다.
key
- 치가 반환되는 키
NullPointerException
- key 가 null 의 경우.
IllegalArgumentException
- key 가 빈 상태(empty)의 경우. Bindings getBindings(int scope)
ScriptContext.GLOBAL_SCOPE
- 글로벌 스코프를 나타내는 이름 첨부치세트. 이 ScriptEngine
이 ScriptEngineManager
에 의해 작성되는 경우, 매니저는 글로벌 스코프 바인딩을 설정합니다. 이 ScriptEngine
에 관련지을 수 있었던 글로벌 스코프가 존재하지 않는 경우는 null
입니다. ScriptContext.ENGINE_SCOPE
- 이 ScriptEngine
상태를 나타내는 이름 첨부치세트. 일반적으로, 값은 관련지을 수 있었던 키를 변수명으로서 사용하는 스크립트로 가시입니다. ScriptEngine
의 디폴트의 ScriptContext
내에서 정의되고 있는 스코프의 값.
Bindings
인스턴스는,ScriptEngine
의 디폴트의 ScriptContext
상에서 대응하는 인수를 지정해 불려 간 ScriptContext
의 getBindings
메소드에 의해 반환되는 인스턴스와 같게 됩니다.
scope
- 반환되는 Bindings
를 지정하는 ScriptContext.ENGINE_SCOPE
또는 ScriptContext.GLOBAL_SCOPE
의 언젠가. ScriptContext
의 구현에서는, 추가의 스코프를 정의할 수 있다. ScriptEngine
의 디폴트의 ScriptContext
가 추가의 스코프를 정의하는 경우, 그러한 어느쪽이든을 건네주어, 대응하는 Bindings
를 취득 가능.
Bindings
.
IllegalArgumentException
- 지정된 스코프가 무효인 경우void setBindings(Bindings bindings, int scope)
ScriptContext.ENGINE_SCOPE
- 지정된 Bindings
가 ScriptEngine
의 엔진 스코프를 치환합니다.
ScriptContext.GLOBAL_SCOPE
- 지정된 Bindings
는 GLOBAL_SCOPE
로서 가시입니다.
ScriptEngine
의 디폴트의 ScriptContext
내에서 정의되고 있는 스코프의 값.
ScriptEngine
의 디폴트의 ScriptContext
상에서 scope
의 대응하는 값을 지정해 ScriptContext
의 getBindings
메소드를 호출했을 경우와 같은 효과를 가지고 있을 필요가 있습니다.
bindings
- 지정된 스코프의 Bindings
. scope
- 지정된 스코프. ScriptContext.ENGINE_SCOPE
,ScriptContext.GLOBAL_SCOPE
, 또는 그 외의 스코프의 유효치의 언젠가.
IllegalArgumentException
- 스코프가 무효인 경우
NullPointerException
- bindings 가 null 로, 스코프가 ScriptContext.ENGINE_SCOPE
인 경우Bindings createBindings()
Bindings
를 돌려줍니다.
ScriptEngine
상태를 치환하기 위해서 사용 가능한 Bindings
. ScriptContext getContext()
ScriptContext
가 지정되어 있지 않은 경우에 스크립트의 실행에 사용되는 Bindings, Reader, 및 Writer 를 가지는 ScriptEngine
의 디폴트의 ScriptContext
를 돌려줍니다.
ScriptEngine
의 디폴트의 ScriptContext
. void setContext(ScriptContext context)
ScriptContext
가 지정되어 있지 않은 경우에 스크립트의 실행에 사용되는 Bindings, Reader, 및 Writer 를 가지는 ScriptEngine
의 디폴트의 ScriptContext
를 설정합니다.
context
- ScriptEngine
의 디폴트의 ScriptContext
를 치환하는 ScriptContext
.
NullPointerException
- context 가 null 의 경우. ScriptEngineFactory getFactory()
ScriptEngine
이 속하는 ScriptEngineFactory
를 돌려줍니다.
ScriptEngineFactory
|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.