javax.script
인터페이스 Invocable

public interface Invocable

이전에 실행된 스크립트내의 수속의 호출을 허가하는 메소드를 가지는 ScriptEngines 에 의해 구현되는 옵션의 인터페이스입니다.

도입된 버젼:

1.6

메소드의 개요

<T> T	getInterface (Class <T> clasz) interpreter로 컴파일 된 함수를 사용해, 인터페이스의 구현을 돌려줍니다.
<T> T	getInterface (Object thiz, Class <T> clasz) interpreter로 컴파일 된 스크립트 객체의 멤버 함수를 사용해, 인터페이스의 구현을 돌려줍니다.
Object	invokeFunction (String name, Object ... args) 스크립트내에서 정의된 톱 레벨의 수속과 함수를 호출하기 위해서(때문에) 사용됩니다.
Object	invokeMethod (Object thiz, String name, Object ... args) ScriptEngine 상태에 보관 유지되고 있는, 이전의 스크립트의 실행중에 컴파일 된 스크립트 객체상의 메소드를 호출합니다.

메소드의 상세

invokeMethod

Object  invokeMethod(Object  thiz,
                    String  name,
                    Object ... args)
                    throws ScriptException ,
                           NoSuchMethodException 

ScriptEngine 상태에 보관 유지되고 있는, 이전의 스크립트의 실행중에 컴파일 된 스크립트 객체상의 메소드를 호출합니다.

파라미터:

name - 불려 가는 수속의 이름

thiz - 수속이 스크립트내에서 정의된 클래스의 멤버이며, thiz 가 이전의 실행 또는 호출해에 의해 반환된 클래스의 인스턴스인 경우는, 그 인스턴스를 사용해 이름 첨부 메소드가 불려 갑니다.

args - 수속에게 건네지는 인수. 인수를 스크립트 변수로 변환하는 규칙은, 구현에 의해 고유의 것입니다.

반환값:

수속에 의해 반환되는 값. 스크립트 메소드에 의해 반환된 스크립트 변수를 Java 객체로 변환하는 규칙은, 구현에 의해 고유의 것입니다.

예외:

ScriptException - 메소드의 호출중에 에러가 발생했을 경우

NoSuchMethodException - 지정된 이름 또는 매칭의 인수형을 가지는 메소드가 발견되지 않는 경우

NullPointerException - 메소드명이 null 의 경우

IllegalArgumentException - 지정된 thiz 가 null 의 경우, 지정된 객체가 스크립트 객체를 나타내지 않은 경우

invokeFunction

Object  invokeFunction(String  name,
                      Object ... args)
                      throws ScriptException ,
                             NoSuchMethodException 

스크립트내에서 정의된 톱 레벨의 수속과 함수를 호출하기 위해서(때문에) 사용됩니다.

파라미터:

args - 수속 또는 함수에게 건네지는 인수

반환값:

수속 또는 함수에 의해 반환되는 값

예외:

ScriptException - 메소드의 호출중에 에러가 발생했을 경우

NoSuchMethodException - 지정된 이름 또는 매칭의 인수형을 가지는 메소드가 발견되지 않는 경우

NullPointerException - method 가 null 의 경우

getInterface

<T> T getInterface(Class <T> clasz)

interpreter로 컴파일 된 함수를 사용해, 인터페이스의 구현을 돌려줍니다. 인터페이스의 메소드는,invokeFunction 메소드를 사용해 구현할 수가 있습니다.

파라미터:

clasz - 돌려주는 인터페이스의 Class 객체

반환값:

요구된 인터페이스의 인스턴스. 요구된 인터페이스를 사용할 수 없는 경우, 즉 ScriptEngine 내에서 컴파일 된 함수가, 요구된 인터페이스내의 함수와의 매칭으로 발견되지 않는 경우는 null

예외:

IllegalArgumentException - 지정된 Class 객체가 null 의 경우, 또는 인터페이스가 아닌 경우

getInterface

<T> T getInterface(Object  thiz,
                   Class <T> clasz)

interpreter로 컴파일 된 스크립트 객체의 멤버 함수를 사용해, 인터페이스의 구현을 돌려줍니다. 인터페이스의 메소드는,invokeMethod 메소드를 사용해 구현할 수가 있습니다.

파라미터:

thiz - 인터페이스의 메소드를 구현하기 위해서 사용되는 멤버 함수를 가지는 스크립트 객체

clasz - 돌려주는 인터페이스의 Class 객체

반환값:

요구된 인터페이스의 인스턴스. 요구된 인터페이스를 사용할 수 없는 경우, 즉 ScriptEngine 내에서 컴파일 된 메소드가, 요구된 인터페이스내의 메소드와의 매칭으로 발견되지 않는 경우는 null

예외:

IllegalArgumentException - 지정된 Class 객체가 null 의 경우, 또는 인터페이스가 아닌 경우, 혹은 지정된 객체가 null 의 경우, 또는 스크립트 객체를 나타내지 않은 경우