java engine_Induction

#Induction

利用java的javascript引擎来工作。

目的

1.更容易的处理数据

2.更容易调试

问题

不同版本的js引擎略有不同。需要考虑兼容性，目前已知的有：Nashorn引擎更贴近与java本身，直接引用java对象比较容易，但操作的方式更类似于java，不能用apply和call来调用java对象的方法，js对象没有问题。

1.6的js引擎没有JSON对象。同时，1.6的JS引擎有可能会有些类库不支持，比如momentJS。

建议在1.7上运行本系统

工作原理

核心

我们认定某一个JS是入口，该JS有一个execute方法。系统会为这个入口分配一个独立的JS引擎，这么做是处于健壮性的考虑，把JS引擎和任务绑定在一起，如果某一次任务失败了，导致引擎挂掉，那么不会影响其他的任务进行。而这个任务本身也很容易重新启动。其实它本质上就是为web而设计的，特别是RESTful的服务。每一次的请求其实都在一个独立的JS引擎中处理。但是引擎中的java元素是公用的，比如spring的jdbcTemplate对象，或者其他的java对象。系统其实会缓存这些JS引擎，这样不会每次请求都去加载引擎以及引擎相关的JS。目前其实还没有设计一个好的恢复机制，假如某个任务的JS引擎挂掉了，目前是不可能恢复的。需要注意的是这个execute方法，必须返回一个js的对象，否则系统会报错。。。

加载JS

JS对于java来说其实是当作配置文件被加载的。根据约定，我们把这些JS放到类路径下的js文件夹中。系统首先会加载Base.js以及一些全局的lib文件。Base.js是非常重要的，其中定义了命名空间，以及一些全局变量，依赖这些全局变量，js得以和java进行交互。目前js和java仅仅通过对象调用以及JSON字符串进行交互。被加载的js文件是不会被不断的加载的，系统会判断它的修改时间，只有最新的js会被重新的加载。

模块化

JS变得有用，一个很大的原因就是其能够模块化。当然，JS本身是没有这个功能的，至少目前还没有。我们采用模拟命名空间+闭包的方式来实现模块化。模块之间的依赖关系，通过依赖注入来实现，这种方式有些类似Angularjs。在处理依赖的时候，处理了两种异常，一种是对自身的依赖，一种是循环依赖。

效能

引擎的效能不是我们主要考虑的问题，其实和java本身的执行效率相差不大。框架在处理数据的时候会对数据做JSON的转换，这个可能是比较消耗性能的。但是我虽然没有对比试验过，但是体验上面，似乎不会比JPA这样的技术慢(JAP也会做转换，将结果转换成对应的模型)。

对数据的变换替代各种O

Java在做类似事情的时候，需要至少两种O：一种是实例PO和数据库的表中的行所对应。一种是TO这个和生成的JSON数据相关。可能还有VO，这个是对数据的验证。JS是通过underscoreJS这样的类库通过filter、map等这样函数化的处理来完成这一过程的。我认为，后者是好的，更灵活，更符合人类的逻辑能力。

如何使用

induction由两部分组成，一部分是java写的，用来加载JS以及用JDK自带的JS引擎来运行这些JS，同时会返回一个String类型的结果。

另一部分是JS写的，用来处理逻辑，以及一些基本的操作，比如日志。Base.java和Base.js都是必须的。使用的时候，这两部分都要和工作的代码合并。Base.java不适合在jar包中工作，因为它需要加载很多JS文件，而这些js文件是不能打入jar包的，主要是从维护性上来考虑的。所以工作的时候你需要直接把源码拷贝到你的工作目录来。当然也可以通过IDE搞一个项目的依赖。

Java部分

com.skycloud.induction.Base.java

这是java部分的基类，主要封装的JS的加载，模块化的实现，以及JS引擎的调用。

其中有一些常量是可以配置的：

private static final String BASE_JS_PATH = "/js";

private static final String EXECUTE_JS_PATH = "/execute";

private static final String[] libs = {"underscore-min.js", "json2.js", "moment.min.js"};

BASE_JS_PATH指的是你的JS在类路径的根目录名称。

EXECUTE_JS_PATH你写的JS的执行目录是什么。

libs你需要加载的类库有哪些。

建议不要改动，但是如果你有自己新的类库需要加载的话，可以改动这个代码。但是需要注意的是，这些类库都是作为全局变量加载的。 这个机制是暂时的，后续可能会改动

此外还需要注意的是Base中的一个内部静态类tool：

/**

* 这个类是为了给JS提供一些处理Java结果的工具。

* 其中的方法会在JS中使用。因此编译器可能会报unused的警告，可以乎略。

*/

public static class Tool {

/**

* 这个工具是为了jdbcTemplate的查询结果，需要被转换成JSON字符串，以便JS处理。

*

* @param result 某个java对象。这里应该是jdbcTemplate的查询结果，是一个java的map对象。

* @return JSON string

*/

@SuppressWarnings("unused")

public String toJSON(Object result) {

ObjectMapper mapper = new ObjectMapper();

StringWriter writer = new StringWriter();

try {

mapper.writeValue(writer, result);

} catch (IOException e) {

e.printStackTrace();

}

return writer.toString();

}

}

这个类可以在JS中使用：_$tool来调用。如果你有什么特殊的方法可以放在这里，让JS调用到，但是需要注意参数尽可能是字符串。( 这个机制是暂时的 )

真正在工作中需要自己实现一个Base.java的子类，比如项目中的Executor类。

public class Executor extends Base {

@Override

public Object setParametersAndCall(String key, String parameters) {

putObjectToJS("_$test","test ");

return executeMethod(key, "execute(" + parameters + ")");

}

public static void main(String[] args) {

Executor executor = new Executor();

Object rs = executor.execute("main", "");

System.out.println("rs = " + rs);

}}

注意putObjectToJS("_$test","test ");这句，这句的意思是向JS中注入一个java的对象。这个对象在JS中可以使用_$test这个变量名称访问。注意，这是一个全局变量，所以我们给了一个特殊的开头，以便标记。