com.ajaxjs.jsonparser

类 JsEngineWrapper

java.lang.Object

com.ajaxjs.jsonparser.JsEngineWrapper

public class JsEngineWrapper
extends Object

JS 引擎的包装器

作者:

sp42 frank@ajaxjs.com

构造器概要

构造器

构造器和说明
JsEngineWrapper() 创建一个 JS 引擎的包装器
JsEngineWrapper(ScriptEngine engine) 必须依赖一个原生 engine 对象

方法概要

限定符和类型	方法和说明
<T> T	call(String method, Class<T> clazz, Object binding, Object... args) 调用脚本的方法
static ScriptEngine	engineFactory() 创建 js 引擎工厂，支持 java 6/7 的 rhino 和 java 8 的 nashorn
Object	eval(String code) 执行 js 代码，不作类型转换（返回 Object）
<T> T	eval(String code, Class<T> clazz) 执行 js 代码
Object	get(String... namespace) 获取 js 的对象，如果最后一个不是对象，返回 Object，之前的为 NativeObject
ScriptEngine	getEngine() 返回 js 引擎
JsEngineWrapper	load(Class<?> clazz, String fileName) 加载某个类下面的 js 文件，可以链式调用这个方法加载多个 js 文件
JsEngineWrapper	load(String path) 加载 js 文件，可以链式调用这个方法加载多个 js 文件
void	put(String varName, Object obj) 在 Java 中向脚本引擎 (Script Engine) 传递变量，即脚本语言中可以得到来自 java 的变量。
void	setEngine(ScriptEngine engine) 保存 js 引擎

从类继承的方法 java.lang.Object

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

构造器详细资料

JsEngineWrapper

public JsEngineWrapper()

创建一个 JS 引擎的包装器

JsEngineWrapper

public JsEngineWrapper(ScriptEngine engine)

必须依赖一个原生 engine 对象

参数:

engine - JVM 脚本引擎

方法详细资料

getEngine

public ScriptEngine getEngine()

返回 js 引擎

返回:

js 引擎

setEngine

public void setEngine(ScriptEngine engine)

保存 js 引擎

参数:

engine - js 引擎

engineFactory

public static ScriptEngine engineFactory()

创建 js 引擎工厂，支持 java 6/7 的 rhino 和 java 8 的 nashorn

返回:

js 引擎

load

public JsEngineWrapper load(String path)

加载 js 文件，可以链式调用这个方法加载多个 js 文件

参数:

path - js 文件完整路徑

返回:

当前实例，可以链式调用这个方法加载多个 js 文件

load

public JsEngineWrapper load(Class<?> clazz,
                            String fileName)

加载某个类下面的 js 文件，可以链式调用这个方法加载多个 js 文件

参数:

clazz - 该类目录下面必须有目标 js 文件

fileName - js 文件名

返回:

当前实例，可以链式调用这个方法加载多个 js 文件

call

public <T> T call(String method,
                  Class<T> clazz,
                  Object binding,
                  Object... args)

调用脚本的方法

类型参数:

T - 目标

参数:

method - js 脚本代码

clazz - 目标类型

binding - 可以为 null，则表示调用全局方法

args - 参数列表

返回:

JS 运算后的返回值，也可能是 null 没有返回

put

public void put(String varName,
                Object obj)

在 Java 中向脚本引擎 (Script Engine) 传递变量，即脚本语言中可以得到来自 java 的变量。 当然，使用 eval() 也可达到同样之效果。另外亦可以直接传递 Java 对象。

参数:

varName - 变量名

obj - 变量值

get

public Object get(String... namespace)

获取 js 的对象，如果最后一个不是对象，返回 Object，之前的为 NativeObject

参数:

namespace - JS 对象的 key

返回:

NativeObject 或 Object

eval

public <T> T eval(String code,
                  Class<T> clazz)

执行 js 代码

类型参数:

T - 目标

参数:

code - 任意 js 代码

clazz - 返回的类型。当 clazz ＝ null 时永远返回 null，表示只是执行，不要求返回结果。可理解为 return void。如果想有返回值，至少有个 clazz = Object.class

返回:

执行结果

eval

public Object eval(String code)

执行 js 代码，不作类型转换（返回 Object）

参数:

code - 任意 js 代码

返回:

执行结果，null 可能表示返回 null，又或者可能没有返回（即 void）