javax.script
클래스 ScriptEngineManager

java.lang.Object 
  javax.script.ScriptEngineManager

public class ScriptEngineManager
extends Object 

ScriptEngineManager 는,ScriptEngine 클래스의 검출 및 인스턴스화 기구를 구현합니다. 또, Manager 가 작성한 모든 엔진으로 공유되는 상태를 포함하는 키와 값의 페어의 컬렉션을 유지합니다. 이 클래스는,서비스 프로바이더 기구를 사용해,ScriptEngineFactory 의 모든 구현을 열거합니다.

ScriptEngineManager 는, 언어명, 파일 확장자(extension), 및 MIME 타입에 근거해 팩토리를 검색하는 유틸리티 메소드와 이것들 모든 팩토리의 배열을 돌려주는 메소드를 제공합니다.

매니저에 의해 유지되어"Global Scope" 로서 참조되는 키와 값의 페어의 Bindings 는,ScriptEngineManager 가 작성한 ScriptEngine 의 모든 인스턴스로 이용 가능합니다. 일반적으로,Bindings 의 값은, 모든 스크립트로 공개됩니다.

도입된 버젼:

1.6

생성자 의 개요

ScriptEngineManager ()
thread 문맥 ClassLoader 에 호출해 옆으로부터 액세스 할 수 있는 경우, 이 생성자 의 호출의 효과는 ScriptEngineManager(Thread.currentThread(). getContextClassLoader()) 를 호출했을 경우와 같습니다.

ScriptEngineManager (ClassLoader loader)
이 생성자 은,서비스 프로바이더 기구를 사용해, 지정된 ClassLoader 에 가시의 ScriptEngineFactory 의 구현을 로드합니다.

메소드의 개요

Object	get (String key) 글로벌 스코프내의 지정된 키에 대한 값을 가져옵니다.
Bindings	getBindings () getBindings 은,globalScope 필드의 값을 돌려줍니다.
ScriptEngine	getEngineByExtension (String extension) 지정된 확장자(extension)의 ScriptEngine 을 검색 및 작성합니다.
ScriptEngine	getEngineByMimeType (String mimeType) 지정된 MIME 타입의 ScriptEngine 를 검색 및 작성합니다.
ScriptEngine	getEngineByName (String shortName) 지정된 이름의 ScriptEngine 를 검색 및 작성합니다.
List <ScriptEngineFactory >	getEngineFactories () 검색 기구에 의해 발견된 모든 ScriptEngineFactory 클래스의 인스턴스가 요소인 배열을 돌려줍니다.
void	put (String key, Object value) 글로벌 스코프에, 지정된 키와 값의 페어를 설정합니다.
void	registerEngineExtension (String extension, ScriptEngineFactory factory) 확장자(extension)를 처리하기 위한 ScriptEngineFactory 를 등록합니다.
void	registerEngineMimeType (String type, ScriptEngineFactory factory) MIME 타입을 처리하기 위한 ScriptEngineFactory 를 등록합니다.
void	registerEngineName (String name, ScriptEngineFactory factory) 언어명을 처리하기 위한 ScriptEngineFactory 를 등록합니다.
void	setBindings (Bindings bindings) setBindings 은,globalScope 필드내로 지정된 Bindings 를 포함합니다.

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자 의 상세

ScriptEngineManager

public ScriptEngineManager()

thread 문맥 ClassLoader 에 호출해 옆으로부터 액세스 할 수 있는 경우, 이 생성자 의 호출의 효과는 ScriptEngineManager(Thread.currentThread(). getContextClassLoader()) 를 호출했을 경우와 같습니다. 그렇지 않은 경우, 효과는 ScriptEngineManager(null) 를 호출했을 경우와 같습니다.

관련 항목:

Thread.getContextClassLoader()

ScriptEngineManager

public ScriptEngineManager(ClassLoader  loader)

이 생성자 은,서비스 프로바이더 기구를 사용해, 지정된 ClassLoader 에 가시의 ScriptEngineFactory 의 구현을 로드합니다.

loader 가 null 의 경우, 플랫폼에 번들 되어 일반적으로의 확장 디렉토리 (인스톨형 확장 기능)에 존재하는 스크립트 엔진 팩토리가 로드 됩니다.

파라미터:

loader - 스크립트 엔진 팩토리의 검출에 사용하는 ClassLoader.

메소드의 상세

setBindings

public void setBindings(Bindings  bindings)

setBindings 은,globalScope 필드내로 지정된 Bindings 를 포함합니다. ScriptEngineManager 는, 이 Bindings 를, 생성한 ScriptEngine 객체의 글로벌 바인딩으로서 설정합니다.

파라미터:

bindings - 지정된 Bindings

예외:

IllegalArgumentException - bindings 가 null 의 경우.

getBindings

public Bindings  getBindings()

getBindings 은,globalScope 필드의 값을 돌려줍니다. ScriptEngineManager 는, 이 Bindings 를, 생성한 ScriptEngine 객체의 글로벌 바인딩으로서 설정합니다.

반환값:

globalScope 필드.

put

public void put(String  key,
                Object  value)

글로벌 스코프에, 지정된 키와 값의 페어를 설정합니다.

파라미터:

key - 설정하는 키

value - 설정하는 값

예외:

NullPointerException - key 가 null 의 경우.

IllegalArgumentException - key 가 빈 상태(empty)의 캐릭터 라인인 경우.

get

public Object  get(String  key)

글로벌 스코프내의 지정된 키에 대한 값을 가져옵니다.

파라미터:

key - 치가 반환되는 키.

반환값:

지정된 키의 값.

getEngineByName

public ScriptEngine  getEngineByName(String  shortName)

지정된 이름의 ScriptEngine 를 검색 및 작성합니다. 이 알고리즘은 최초로,registerEngineName 메소드를 사용해, 지정된 이름의 핸들러로서 등록되어 있는 ScriptEngineFactory 를 검색합니다.

발견되지 않는 경우는, 지정된 이름의 핸들러의 생성자 에 의해 포함된 ScriptEngineFactory 인스턴스의 배열을 검색합니다. 몇개의 메소드에 의해 ScriptEngineFactory 가 발견되었을 경우,ScriptEngine 의 인스턴스를 작성하기 위해서 사용됩니다.

파라미터:

shortName - ScriptEngineFactory 의 getNames 메소드에 의해 반환되는 ScriptEngine 의 구현의 짧은 이름.

반환값:

검색으로 발견된 팩토리에 의해 작성된 ScriptEngine. 이러한 팩토리가 발견되지 않았던 경우는 null. ScriptEngineManager 는, 독자적인 globalScope Bindings 를, 새롭게 작성된 ScriptEngine 의 GLOBAL_SCOPE Bindings 로서 설정한다.

예외:

NullPointerException - shortName 가 null 의 경우.

getEngineByExtension

public ScriptEngine  getEngineByExtension(String  extension)

지정된 확장자(extension)의 ScriptEngine 를 검색 및 작성합니다. registerEngineExtension 를 사용해, 지정된 확장자(extension)를 처리하기 위해서 등록된 ScriptEngineFactory 를 최초로 검색하는 것 이외는,getEngineByName 가 사용하는 알고리즘이 사용됩니다.

파라미터:

extension - 지정된 확장자(extension)

반환값:

이 확장자(extension)를 가지는 스크립트를 처리하는 엔진. 발견되지 않는 경우는 null.

예외:

NullPointerException - extension 가 null 의 경우.

getEngineByMimeType

public ScriptEngine  getEngineByMimeType(String  mimeType)

지정된 MIME 타입의 ScriptEngine 를 검색 및 작성합니다. registerEngineMimeType 를 사용해, 지정된 MIME 타입을 처리하기 위해서 등록된 ScriptEngineFactory 를 최초로 검색하는 것 이외는,getEngineByName 가 사용하는 알고리즘이 사용됩니다.

파라미터:

mimeType - 지정된 MIME 타입

반환값:

이 MIME 타입을 가지는 스크립트를 처리하는 엔진. 발견되지 않는 경우는 null.

예외:

NullPointerException - mimeType 가 null 의 경우.

getEngineFactories

public List <ScriptEngineFactory > getEngineFactories()

검색 기구에 의해 발견된 모든 ScriptEngineFactory 클래스의 인스턴스가 요소인 배열을 돌려줍니다.

반환값:

검출된 모든 ScriptEngineFactory 의 리스트.

registerEngineName

public void registerEngineName(String  name,
                               ScriptEngineFactory  factory)

언어명을 처리하기 위한 ScriptEngineFactory 를 등록합니다. 검출 기구를 사용해 발견된 모든 관련짓고를 오버라이드(override) 합니다.

파라미터:

name - ScriptEngineFactory 에 관련지을 수 있는 이름.

factory - 지정된 이름에 관련짓는 클래스.

예외:

NullPointerException - 파라미터중 한쪽이 null 의 경우.

registerEngineMimeType

public void registerEngineMimeType(String  type,
                                   ScriptEngineFactory  factory)

MIME 타입을 처리하기 위한 ScriptEngineFactory 를 등록합니다. 검출 기구를 사용해 발견된 모든 관련짓고를 오버라이드(override) 합니다.

파라미터:

type - ScriptEngineFactory 에 관련지을 수 있는 MIME 타입.

factory - 지정된 MIME 타입에 관련짓는 클래스.

예외:

NullPointerException - 파라미터중 한쪽이 null 의 경우.

registerEngineExtension

public void registerEngineExtension(String  extension,
                                    ScriptEngineFactory  factory)

확장자(extension)를 처리하기 위한 ScriptEngineFactory 를 등록합니다. 검출 기구를 사용해 발견된 모든 관련짓고를 오버라이드(override) 합니다.

파라미터:

extension - ScriptEngineFactory 에 관련지을 수 있는 확장자(extension) 타입.

factory - 지정된 확장자(extension)에 관련짓는 클래스.

예외:

NullPointerException - 파라미터중 한쪽이 null 의 경우.