javax.script
인터페이스 ScriptEngineFactory

public interface ScriptEngineFactory

ScriptEngineFactory 는,ScriptEngines 의 설명 및 인스턴스화에 사용됩니다.

ScriptEngine 를 구현하는 각 클래스에는, 엔진 클래스를 기술하는 메타데이타를 공개하기 위한 대응하는 팩토리가 존재합니다.

ScriptEngineManager 는,Jar File Specification 에 기술된 서비스 프로바이더 기구를 사용해, 현재의 ClassLoader 로 사용 가능한 모든 ScriptEngineFactories 의 인스턴스를 가져옵니다.

도입된 버젼:

1.6

메소드의 개요

String	getEngineName () ScriptEngine 의 완전한 이름을 돌려줍니다.
String	getEngineVersion () ScriptEngine 의 버젼을 돌려줍니다.
List <String >	getExtensions () 파일명 확장자(extension)의 불변의 리스트를 돌려줍니다.
String	getLanguageName () 이 ScriptEngine 가 지원하는 스크립트 언어의 이름을 돌려줍니다.
String	getLanguageVersion () 이 ScriptEngine 가 지원하는 스크립트 언어의 버젼을 돌려줍니다.
String	getMethodCallSyntax (String obj, String m, String ... args) 지원되는 스크립트 언어의 구문을 사용해 Java 객체의 메소드를 호출하기 위해서(때문에) 사용 가능한 String 를 돌려줍니다.
List <String >	getMimeTypes () 엔진을 실행할 수 있는 스크립트에 관련지을 수 있던, MimeType 의 불변의 리스트를 돌려줍니다.
List <String >	getNames () ScriptEngine 의 짧은 이름의 불변의 리스트를 돌려줍니다.
String	getOutputStatement (String toDisplay) 지원되는 스크립트 언어의 구문을 사용해, 지정된 String 를 표시하기 위한 문으로서 사용 가능한 String 를 돌려줍니다.
Object	getParameter (String key) 속성의 값을 돌려줍니다.
String	getProgram (String ... statements) 지정된 문장을 포함한, 스크립트 언어의 유효한 실행 가능 프로그램을 돌려줍니다.
ScriptEngine	getScriptEngine () 이 ScriptEngineFactory 에 관련지을 수 있었던 ScriptEngine 의 인스턴스를 돌려줍니다.

메소드의 상세

getEngineName

String  getEngineName()

ScriptEngine 의 완전한 이름을 돌려줍니다. 예를 들어, Mozilla Rhino Javascript 엔진에 근거한 구현은 Rhino Mozilla Javascript Engine 를 돌려줍니다.

반환값:

엔진의 구현의 이름.

getEngineVersion

String  getEngineVersion()

ScriptEngine 의 버젼을 돌려줍니다.

반환값:

ScriptEngine 의 구현의 버젼.

getExtensions

List <String > getExtensions()

파일명 확장자(extension)의 불변의 리스트를 돌려줍니다. 일반적으로, 파일명 확장자(extension)는, 이 ScriptEngine 에 의해 지원되는 언어로 기술된 스크립트를 식별합니다. 이 배열은,ScriptEngineManager 가 getEngineByExtension 메소드를 구현하기 위해서 사용합니다.

반환값:

확장자(extension)의 리스트.

getMimeTypes

List <String > getMimeTypes()

엔진을 실행할 수 있는 스크립트에 관련지을 수 있던, MimeType 의 불변의 리스트를 돌려줍니다. 이 리스트는,ScriptEngineManager 클래스가 getEngineByMimetype 메소드를 구현하기 위해서 사용합니다.

반환값:

MIME 타입의 리스트.

getNames

List <String > getNames()

ScriptEngine 의 짧은 이름의 불변의 리스트를 돌려줍니다. 짧은 이름은,ScriptEngineManager 에 의한 ScriptEngine 의 식별로 사용 가능합니다. 예를 들어, Mozilla Rhino Javascript 엔진에 근거한 구현은 {"javascript", "rhino"} 를 포함한 리스트를 돌려줍니다.

getLanguageName

String  getLanguageName()

이 ScriptEngine 가 지원하는 스크립트 언어의 이름을 돌려줍니다.

반환값:

지원되는 언어의 이름.

getLanguageVersion

String  getLanguageVersion()

이 ScriptEngine 가 지원하는 스크립트 언어의 버젼을 돌려줍니다.

반환값:

지원되는 언어의 버젼.

getParameter

Object  getParameter(String  key)

속성의 값을 돌려줍니다. 이 값은 구현에 고유의 의미를 가지는 경우도 있습니다. 값이 모든 구현으로 정의되는 키는 다음과 같습니다.

• ScriptEngine.ENGINE
• ScriptEngine.ENGINE_VERSION
• ScriptEngine.NAME
• ScriptEngine.LANGUAGE
• ScriptEngine.LANGUAGE_VERSION

이러한 키는, 각각 getEngineName,getEngineVersion,getName,getLanguageName, 및 getLanguageVersion 에 의해 반환되는 String 입니다.

예약이 끝난 키 THREADING 도 정의되고 있습니다. 이 키의 값은, 스크립트의 병행 실행과 상태의 관리에 관한 엔진의 동작을 기술합니다. THREADING 키의 값은 다음과 같습니다.

null - 엔진의 구현은 thread에 대해서 안전하지 않고, 복수의 thread로 병행해 스크립트 실행하기 위해서 사용할 수 없습니다.

"MULTITHREADED" - 엔진의 구현은 내부적으로 thread에 대해서 안전합니다. 어느 thread로 스크립트를 실행했을 경우의 효과가 다른 thread상의 스크립트에 가시인 경우도 있습니다만, 스크립트를 병행에 실행할 수 있습니다.

"THREAD-ISOLATED" - 구현은 "MULTITHREADED" 의 요건을 채웁니다. 또, 엔진은 다른 thread로 실행중의 스크립트의 심볼에 관해서 독립한 값을 보관 유지합니다.

"STATELESS" - 구현은 "THREAD-ISOLATED" 의 요건을 채웁니다. 또, 스크립트의 실행에 의해,ScriptEngine 의 엔진 스코프인 Bindings 내의 매핑이 변경될 것은 없습니다. 특히,Bindings 내의 키 및 관련지을 수 있었던 값은, 스크립트의 실행 전후로 같습니다.

구현으로, 구현에 고유의 키가 정의되는 일이 있습니다.

파라미터:

key - 파라미터의 이름

반환값:

지정된 파라미터의 값. 키에 할당할 수 있고 있는 값이 없는 경우는 null.

getMethodCallSyntax

String  getMethodCallSyntax(String  obj,
                           String  m,
                           String ... args)

지원되는 스크립트 언어의 구문을 사용해 Java 객체의 메소드를 호출하기 위해서(때문에) 사용 가능한 String 를 돌려줍니다. 예를 들어, Javascript 엔진의 구현에서는 다음과 같이 됩니다.

 public String getMethodCallSyntax(String obj,
                                   String m, String... args) {
      String ret = obj;
      ret += ". " + m + "(";
      for (int i = 0; i < args.length; i++) {
          ret += args[i];
          if (i == args.length - 1) {
              ret += ")";
          } else {
              ret += ",";
          }
      }
      return ret;
 }

파라미터:

obj - 불려 가는 메소드를 가지는 객체를 나타내는 이름. 이것은,ScriptEngine 의 put 메소드,ENGINE_SCOPE Bindings 의 put 메소드, 또는 ScriptContext 의 setAttribute 메소드를 사용해 바인딩을 작성하기 위해서 사용하는 이름. 스크립트로 사용되는 식별자는, 지정된 식별자의 데코레이트 된 형식으로 할 수도 있습니다.

m - 불려 가는 메소드의 이름.

args - 메소드의 호출로 지정되는 인수의 이름.

반환값:

스크립트 언어의 구문으로 메소드의 호출에 사용되는 String.

getOutputStatement

String  getOutputStatement(String  toDisplay)

지원되는 스크립트 언어의 구문을 사용해, 지정된 String 를 표시하기 위한 문으로서 사용 가능한 String 를 돌려줍니다. 예를 들어, Perl 엔진의 구현에서는 다음과 같이 됩니다.

 public String getOutputStatement(String toDisplay) {
      return "print(" + toDisplay + ")";
 }
 

파라미터:

toDisplay - 반환되는 문장에 의해 표시되는 String.

반환값:

스크립트 언어의 구문으로 String 의 표시에 사용되는 캐릭터 라인.

getProgram

String  getProgram(String ... statements)

지정된 문장을 포함한, 스크립트 언어의 유효한 실행 가능 프로그램을 돌려줍니다. 예를 들어, PHP 엔진의 구현에서는 다음과 같이 됩니다.

 public String getProgram(String... statements) {
      $retval = "<? \n";
      int len = statements.length;
      for (int i = 0; i < len; i++) {
          $retval += statements[i] + ";\n";
      }
      $retval += "? >";

 }
 

파라미터:

statements - 실행되는 문장. getMethodCallSyntax 및 getOutputStatement 메소드의 호출의 반환값이 될 가능성이 있습니다.

반환값:

프로그램

getScriptEngine

ScriptEngine  getScriptEngine()

이 ScriptEngineFactory 에 관련지을 수 있었던 ScriptEngine 의 인스턴스를 돌려줍니다. 일반적으로, 새로운 ScriptEngine 가 돌려주어집니다만, 구현은 엔진을 풀, 공유, 또는 재사용할 가능성이 있습니다.

반환값:

새로운 ScriptEngine 인스턴스.