개요   패키지    클래스  사용   계층 트리   비추천 API   색인   헬프  
JavaTM Platform
Standard Ed. 6
 전의 클래스    다음의 클래스 프레임 있어    프레임 없음    
개요: 상자  | 필드 | 생성자 | 메소드 상세 : 필드 | 생성자 | 메소드

javax.script
인터페이스 ScriptEngine

기존의 구현 클래스의 일람:
AbstractScriptEngine 
public interface ScriptEngine

ScriptEngine 는, 이 스펙의 모든 구현으로 완전하게 기능하는 것이 필요한 메소드를 가지는 기본 인터페이스입니다.

이러한 메소드는, 기본적인 스크립트 기능을 제공합니다. 이 단순한 인터페이스에 기술된 어플리케이션은, 어느 구현에서도 최소한의 변경으로 동작하는 것이 상정되고 있습니다. 스크립트를 실행하는 메소드, 값을 설정 및 취득하는 메소드가 포함됩니다.

값은, 2 종류의 키와 값의 페어입니다. 최초의 페어는, 키가 예약되어 이 스펙 또는 개별의 구현에 의해 정의되어서로 구성됩니다. 예약 끝난 키를 가지는 페어내의 값은, 지정된 의미를 가집니다.

이제(벌써) 한편의 페어는, Java 언어의 Bindings 를 작성해서로 구성됩니다. 일반적으로, 값은 스크립트내에서, 대응하는 키 또는 그러한 데코레이트 된 형식에 의해 나타내집니다.

도입된 버젼:
1.6

필드의 개요
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 를 설정합니다.
 

필드의 상세

ARGV

static final String  ARGV
위치 인수의 배열을 스크립트에 건네주는 이름 첨부치의 예약이 끝난 키입니다.

관련 항목:
정수 필드치

FILENAME

static final String  FILENAME
실행중의 파일의 이름인 이름 첨부치의 예약이 끝난 키입니다.

관련 항목:
정수 필드치

ENGINE

static final String  ENGINE
ScriptEngine 구현의 이름인 이름 첨부치의 예약이 끝난 키입니다.

관련 항목:
정수 필드치

ENGINE_VERSION

static final String  ENGINE_VERSION
ScriptEngine 구현의 버젼을 식별하는 이름 첨부치의 예약이 끝난 키입니다.

관련 항목:
정수 필드치

NAME

static final String  NAME
스크립트 언어의 짧은 이름을 식별하는 이름 첨부치의 예약이 끝난 키입니다. 이름은,ScriptEngineManager 가, 지정된 이름을 가지는 ScriptEngine 를 getEngineByName 메소드내에서 찾기 위해서(때문에) 사용됩니다.

관련 항목:
정수 필드치

LANGUAGE

static final String  LANGUAGE
구현이 지원하는 스크립트 언어의 완전한 이름인 이름 첨부치의 예약이 끝난 키입니다.

관련 항목:
정수 필드치

LANGUAGE_VERSION

static final String  LANGUAGE_VERSION
구현이 지원하는 스크립트 언어의 버젼을 식별하는 이름 첨부치의 예약이 끝난 키입니다.

관련 항목:
정수 필드치
메소드의 상세

eval

Object  eval(String  script,
            ScriptContext  context)
            throws ScriptException
소스가 1 번째의 인수로서 건네받은 String 인 스크립트를 즉시 실행합니다. 스크립트는, 실행전에 재해석 또는 재컴파일 될 가능성이 있습니다. 변수치 및 컴파일이 끝난 수속을 포함한, 이전의 실행으로 엔진에 남겨진 상태는, 이 실행중에 가시일 가능성이 있습니다.

파라미터:
script - 스크립트 엔진에 의해 실행되는 스크립트.
context - 다른 스코프내의 속성의 ScriptContext 공개 세트. 스코프 ScriptContext.GLOBAL_SCOPE 및 ScriptContext.ENGINE_SCOPE 의 의미는, 스펙으로 정의되고 있다.

ScriptContext 의 ENGINE_SCOPE Bindings 에는, 이 스크립트의 실행중에 사용되는, 어플리케이션 객체에의 스크립트 변수의 바인딩이 포함됩니다.
반환값:
스크립트의 실행에 의해 반환되는 값.
예외:
ScriptException - 스크립트로 에러가 발생했을 경우. 기본이 되는 스크립트의 구현에 의해 throw 된 확인 끝난 예외의 ScriptException 래퍼를, ScriptEngines 가 작성 및 throw 한다.
NullPointerException - 어느 쪽인가의 인수가 null 의 경우.

eval

Object  eval(Reader  reader,
            ScriptContext  context)
            throws ScriptException
스크립트의 소스가 Reader 로부터 읽히는 경우,eval(String, ScriptContext) 와 같습니다.

파라미터:
reader - 스크립트 엔진에 의해 실행되는 스크립트의 소스.
context - 스크립트 엔진에게 건네지는 ScriptContext.
반환값:
스크립트의 실행에 의해 반환되는 값.
예외:
ScriptException - 스크립트로 에러가 발생했을 경우.
NullPointerException - 어느 쪽인가의 인수가 null 의 경우.

eval

Object  eval(String  script)
            throws ScriptException
지정된 스크립트를 실행합니다. ScriptEngine 의 디폴트의 ScriptContext 가 사용됩니다.

파라미터:
script - 실행되는 스크립트 언어 소스.
반환값:
스크립트의 실행에 의해 반환되는 값.
예외:
ScriptException - 스크립트로 에러가 발생했을 경우.
NullPointerException - 인수가 null 의 경우

eval

Object  eval(Reader  reader)
            throws ScriptException
스크립트의 소스가 Reader 로서 제공되는 것을 제외해,eval(String) 와 같습니다.

파라미터:
reader - 스크립트의 소스.
반환값:
스크립트에 의해 반환되는 값.
예외:
ScriptException - 스크립트로 에러가 발생했을 경우.
NullPointerException - 인수가 null 의 경우.

eval

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 의 경우.

eval

Object  eval(Reader  reader,
            Bindings  n)
            throws ScriptException
스크립트의 소스가 Reader 로서 제공되는 것을 제외해,eval(String, Bindings) 와 같습니다.

파라미터:
reader - 스크립트의 소스.
n - 속성의 Bindings.
반환값:
스크립트에 의해 반환되는 값.
예외:
ScriptException - 에러가 발생했을 경우.
NullPointerException - 어느 쪽인가의 인수가 null 의 경우.

put

void put(String  key,
         Object  value)
ScriptEngine 상태에 키와 값의 페어를 설정합니다. 키가 예약되고 있는지 어떤지에 근거해, 스크립트의 실행시, 또는 다른 방법으로 사용되는 Java 언어 바인딩이 설정됩니다. getBindings(ScriptContext.ENGINE_SCOPE). put 와 같은 효과를 가지고 있을 필요가 있습니다.

파라미터:
key - 추가하는 이름 첨부치의 이름
value - 추가하는 이름 첨부치의 값.
예외:
NullPointerException - key 가 null 의 경우.
IllegalArgumentException - key 가 빈 상태(empty)의 경우.

get

Object  get(String  key)
이 엔진 상태의 값세트를 가져옵니다. 값은, 구현에 근거해,setValue 를 사용해 설정된 값인가,ScriptEngine 상태외의 값이 될 가능성이 있습니다. getBindings(ScriptContext.ENGINE_SCOPE). get 와 같은 효과를 가지고 있을 필요가 있습니다.

파라미터:
key - 치가 반환되는 키
반환값:
지정된 키의 값
예외:
NullPointerException - key 가 null 의 경우.
IllegalArgumentException - key 가 빈 상태(empty)의 경우.

getBindings

Bindings  getBindings(int scope)
이름 첨부치의 스코프를 돌려줍니다. 유효한 스코프는 다음과 같습니다.



반환되는 Bindings 인스턴스는,ScriptEngine 의 디폴트의 ScriptContext 상에서 대응하는 인수를 지정해 불려 간 ScriptContext 의 getBindings 메소드에 의해 반환되는 인스턴스와 같게 됩니다.

파라미터:
scope - 반환되는 Bindings 를 지정하는 ScriptContext.ENGINE_SCOPE 또는 ScriptContext.GLOBAL_SCOPE 의 언젠가. ScriptContext 의 구현에서는, 추가의 스코프를 정의할 수 있다. ScriptEngine 의 디폴트의 ScriptContext 가 추가의 스코프를 정의하는 경우, 그러한 어느쪽이든을 건네주어, 대응하는 Bindings 를 취득 가능.
반환값:
지정된 스코프를 가지는 Bindings.
예외:
IllegalArgumentException - 지정된 스코프가 무효인 경우

setBindings

void setBindings(Bindings  bindings,
                 int scope)
스크립트에 의해 사용되는 이름 첨부치의 스코프를 설정합니다. 유효한 스코프는 다음과 같습니다.



이 메소드는,ScriptEngine 의 디폴트의 ScriptContext 상에서 scope 의 대응하는 값을 지정해 ScriptContext 의 getBindings 메소드를 호출했을 경우와 같은 효과를 가지고 있을 필요가 있습니다.

파라미터:
bindings - 지정된 스코프의 Bindings.
scope - 지정된 스코프. ScriptContext.ENGINE_SCOPE,ScriptContext.GLOBAL_SCOPE, 또는 그 외의 스코프의 유효치의 언젠가.
예외:
IllegalArgumentException - 스코프가 무효인 경우
NullPointerException - bindings 가 null 로, 스코프가 ScriptContext.ENGINE_SCOPE 인 경우

createBindings

Bindings  createBindings()
초기화되어 있지 않은 Bindings 를 돌려줍니다.

반환값:
이 ScriptEngine 상태를 치환하기 위해서 사용 가능한 Bindings.

getContext

ScriptContext  getContext()
ScriptContext 가 지정되어 있지 않은 경우에 스크립트의 실행에 사용되는 Bindings, Reader, 및 Writer 를 가지는 ScriptEngine 의 디폴트의 ScriptContext 를 돌려줍니다.

반환값:
ScriptEngine 의 디폴트의 ScriptContext.

setContext

void setContext(ScriptContext  context)
ScriptContext 가 지정되어 있지 않은 경우에 스크립트의 실행에 사용되는 Bindings, Reader, 및 Writer 를 가지는 ScriptEngine 의 디폴트의 ScriptContext 를 설정합니다.

파라미터:
context - ScriptEngine 의 디폴트의 ScriptContext 를 치환하는 ScriptContext.
예외:
NullPointerException - context 가 null 의 경우.

getFactory

ScriptEngineFactory  getFactory()
이 ScriptEngine 이 속하는 ScriptEngineFactory 를 돌려줍니다.

반환값:
ScriptEngineFactory
개요   패키지    클래스  사용   계층 트리   비추천 API   색인   헬프  
JavaTM Platform
Standard Ed. 6
 전의 클래스    다음의 클래스 프레임 있어    프레임 없음    
개요: 상자  | 필드 | 생성자 | 메소드 상세 : 필드 | 생성자 | 메소드
버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.