compact1, compact2, compact3

javax.script

Class ScriptEngineManager

java.lang.Object

javax.script.ScriptEngineManager

public class ScriptEngineManager
extends Object

该ScriptEngineManager实现了一个发现和实例化机制ScriptEngine类和还保持存储由所有Manager创建的引擎所共享的状态键/值对的集合。 该类使用service provider机制枚举ScriptEngineFactory的所有ScriptEngineFactory 。

ScriptEngineManager提供了一种返回所有这些工厂的列表的方法以及在语言名称，文件扩展名和MIME类型的基础上查找工厂的实用方法。

该Bindings键/值对的，被称为“全球范围”由管理器维护可用于的所有实例ScriptEngine由创建ScriptEngineManager 。 Bindings中的值通常在所有脚本中公开。

从以下版本开始：

1.6

构造方法摘要

构造方法

Constructor and Description
ScriptEngineManager() 调用此构造方法的效果是一样的呼叫 ScriptEngineManager(Thread.currentThread().getContextClassLoader()) 。
ScriptEngineManager(ClassLoader loader) 这个构造函数加载的实现ScriptEngineFactory可见给定ClassLoader使用service provider机制。 如果装载器为null ， null加载与平台捆绑并位于常规扩展目录（已安装扩展）中的脚本引擎工厂。

方法摘要

Modifier and Type	Method and Description
Object	get(String key) 获取全局范围中指定键的值
Bindings	getBindings() getBindings返回 globalScope字段的值。
ScriptEngine	getEngineByExtension(String 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) 注册一个 ScriptEngineFactory来处理扩展。
void	registerEngineMimeType(String type, ScriptEngineFactory factory) 注册一个 ScriptEngineFactory来处理一个MIME类型。
void	registerEngineName(String name, ScriptEngineFactory factory) 注册一个 ScriptEngineFactory来处理一个语言名称。
void	setBindings(Bindings bindings) setBindings将指定的Bindings Bindings在 globalScope字段中。

Methods inherited from class java.lang.Object

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

构造方法详细信息

ScriptEngineManager

public ScriptEngineManager()

调用此构造方法的效果是一样的呼叫 ScriptEngineManager(Thread.currentThread().getContextClassLoader()) 。

另请参见：

Thread.getContextClassLoader()

ScriptEngineManager

public ScriptEngineManager(ClassLoader loader)

这个构造函数加载的实现ScriptEngineFactory可见给定ClassLoader使用service provider机制。

如果装载程序为null ， null加载与平台捆绑在一起的扩展目录（已安装扩展名）中的脚本引擎工厂。

参数

loader - ClassLoader用于发现脚本引擎工厂。

方法详细信息

setBindings

public void setBindings(Bindings bindings)

setBindings将指定的Bindings Bindings在globalScope字段中。 ScriptEngineManager将此Bindings为全球绑定ScriptEngine由它创建的对象。

参数

bindings - 指定的 Bindings

异常

IllegalArgumentException - 如果绑定为空。

getBindings

public Bindings getBindings()

getBindings返回globalScope字段的值。 ScriptEngineManager将此Bindings为全球绑定ScriptEngine由它创建的对象。

结果

globalScope字段。

put

public void put(String key,
                Object value)

在全局范围中设置指定的键/值对。

参数

key - 钥匙设定

value - 要设置的值。

异常

NullPointerException - 如果键为空。

IllegalArgumentException - 如果键为空字符串。

get

public Object get(String key)

获取全局范围中指定键的值

参数

key - 要返回其值的键。

结果

指定键的值。

getEngineByName

public ScriptEngine getEngineByName(String shortName)

查找并创建一个给定名称的ScriptEngine 。 该算法的第一搜索ScriptEngineFactory已被注册为使用指定名称的处理程序registerEngineName方法。

如果没有找到，则搜索由ScriptEngineFactory函数存储的一组具有指定名称的一组ScriptEngineFactory实例。 如果通过任一方法找到ScriptEngineFactory ，则用于创建ScriptEngine实例。

参数

shortName - ScriptEngine简称。 由getNames方法归还其ScriptEngineFactory 。

结果

A ScriptEngine由工厂创建位于搜索。 如果没有找到这样的工厂，则返回null。 ScriptEngineManager设置自己的globalScope Bindings作为GLOBAL_SCOPE Bindings的新创建的ScriptEngine 。

异常

NullPointerException - 如果shortName为null。

getEngineByExtension

public ScriptEngine getEngineByExtension(String extension)

查找并创建一个ScriptEngine一个给定扩展。 所使用的算法getEngineByName用于不同的是搜索通过寻找一个开始ScriptEngineFactory注册为处理使用给定的扩展registerEngineExtension 。

参数

extension - 给定的扩展名

结果

用这种扩展来处理脚本的引擎。 如果没有找到，返回null 。

异常

NullPointerException - 如果扩展名为null。

getEngineByMimeType

public ScriptEngine getEngineByMimeType(String mimeType)

查找并为给定的MIME类型创建一个ScriptEngine 。 使用getEngineByName使用的getEngineByName ，除了通过寻找一个ScriptEngineFactory注册以处理给定的MIME类型（ registerEngineMimeType 。

参数

mimeType - 给定的MIME类型

结果

用这种mime类型处理脚本的引擎。 如果没有找到则返回null 。

异常

NullPointerException - 如果mimeType为空。

getEngineFactories

public List<ScriptEngineFactory> getEngineFactories()

返回一个列表，其元素是发现机制找到的所有 ScriptEngineFactory类的实例。

结果

所有发现的列表 ScriptEngineFactory s。

registerEngineName

public void registerEngineName(String name,
                               ScriptEngineFactory factory)

注册一个ScriptEngineFactory来处理一个语言名称。 覆盖使用发现机制找到的任何此类关联。

参数

name - 要与 ScriptEngineFactory的名称。

factory - 与给定名称相关 factory的类。

异常

NullPointerException - 如果任何参数为空。

registerEngineMimeType

public void registerEngineMimeType(String type,
                                   ScriptEngineFactory factory)

注册一个ScriptEngineFactory处理一个mime类型。 覆盖使用发现机制找到的任何此类关联。

参数

type - MIME类型来与相关联 ScriptEngineFactory 。

factory - 与给定的MIME类型相关联的类。

异常

NullPointerException - 如果任何参数为空。

registerEngineExtension

public void registerEngineExtension(String extension,
                                    ScriptEngineFactory factory)

注册一个ScriptEngineFactory来处理扩展。 覆盖使用发现机制找到的任何此类关联。

参数

extension -扩展型与相关联 ScriptEngineFactory 。

factory - 与给定扩展名关联的类。

异常

NullPointerException - 如果任何参数为空。