Aurora ???????

以Aurora框架为基础的项目开发中，业务逻辑以及数据校验一般都会写到package里面，最终在数据库中执行.这会增加数据库的负载，增加相应时间.实际应用中，大部分数据校验工作都可以在中间层(应用服务器)完成，甚至一些简单的逻辑也不一定非得写到package。

在此之前，中间层可以通过svc来控制流程，也可以通过已经开发好的标签进行数据加工和一些简单的逻辑校验操作.想要依靠svc完成复杂的操作，则需要开发者开发新的标签。

服务端脚本的引入，可以使中间层能做更多的事，能减小数据库的压力，缩短请求相应时间，充分利用应用服务器的计算能力。

服务端脚本运行于后台服务器，和浏览器没有任何关系。

如果要使用脚本功能，则须保证jdk1.6以上，aurora-plugin.jar请尽量保证最新.同时需要aurora-js.jar包.jar包置于<WEB_HOME>/WEB-INF/lib目录，点此下载

我们实现了几个js对象，用于代理java中的对象，并为它们设计了api，具体的细节如下

CompositeMap和ModelService，可以随便创建.但是不建议创建Session，Cookie，取而代之的是使用他们的唯一引用$session，$cookie，这会在下面介绍。

var map = new CompositeMap('a');
map.key1 = 'value1';
var m = new CompositeMap('c');
map.addChild(m);
m.put('@key', 'value');
println(m['key'])
println(map.get('/c/@key'));
println(map.toXML())

var bm = new ModelService('sys.sys_user');
bm.fetchDescriptor = {
    pagesize: 3,
	pagenum: 2,
	fetchAll:true
};
/**
 * fetchDescriptor 如果没设置，或设置为无效值，则会被重置为FetchDescriptor.fetchAll()
 * fetchDescriptor 有3个有用的属性
 *   pagesize 分页大小，数字或字符类型的数字（10，'10'）
 *   pagenum  页码，数字或字符类型的数字（10，'10'）
 *   fetchAll(fetchall) 默认false，若为true，则pagenum,pagesize无效
 * pagesize，pagenum 用于计算offset，offset不可直接设置
 *
 * var fd = bm.fetchDescriptor 返回的为json对象
 * 此对象包含4个值，除了上面3个，还有offset
 * 修改此对象不会影响bm，如果想要起作用，需要重新赋值：
 * fd.pagenum = 3;
 * bm.fetchDescriptor = fd;
 */

var res = bm.queryAsMap();
var arr = res.getChildren();
for (i = 0;i < arr.length;i++) {
    println(arr[i].user_name);
}

$ctx.parameter.user_id = 21;
bm.option = {
    rootPath: 'rp_user'
};
/**
 * option 可以设置的值有:
 * rootPath
 * autoCount
 * defaultWhereClause
 * queryOrderBy
 * connectionName
 * fieldCase
 * recordName
 * updatePassedFieldOnly
 */

var res = bm.queryAsMap();
copyAttribute(p.createChild('fd'), bm.fetchDescriptor);
p.addChild(res);

bm.query();
println($ctx.get('/model/rp_user/record/@user_name'))

$session.clear();
$session.write('session_id', '/parameter/@session_id');
//上句等价于$session.writeValue('session_id', $ctx.parameter.session_id);
$session.write('lang', '/parameter/@user_language');
$session.write('is_ipad', '/parameter/@is_ipad');
$session.write('user_id', '/model/rp_user/record/@user_id');
println($session.toXML());
//新特性
$session.aaa = 1;//等价于$session.writeValue('aaa', 1);

$cookie.put('IS_NTLM', 'N');

var ns_a = 'aurora.application.action';
var ae = new ActionEntry(ns_a, 'resource-access-check');
ae.run({
    resultPath: '/access-check/@status_code'
});

内建函数主要都是工具函数，它们都是全局函数。

一个完整的小例子。

<?xml version="1.0" encoding="UTF-8"?>
<a:service xmlns:s="aurora.plugin.script" xmlns:a="http://www.aurora-framework.org/application">
    <a:init-procedure>
        <s:server-script><![CDATA[
            var p = $ctx.parameter;
            if (p.a) println('a=' + p.a);
            else println('a is not passed in.');
            p.b = 'sss'
        ]]></s:server-script>
    </a:init-procedure>
    <a:service-output output="/parameter"/>
</a:service>

为了可以使用命名空间aurora.plugin.script中的server-script标签，必须首先确保uncertain.xml中包含相关的内容：

<package-path classPath="aurora_plugin_package/aurora.plugin.script"/>

由这个小例子可以看出script是如何集成到svc(或screen)中的。通过server-script标签，可以直接书写大段的js。

请注意:server-script标签只能写在init-procedure标签下面。server-script标签可以出现多次，但是我们不建议这么做。

为了增加灵活性，我们允许开发人员可以编写一些通用的函数，放到一个或多个js文件中，然后在多个地方调用。

对于很长的js片段，我们也建议单独编写，然后简单的需要的地方引用。

标准js库路径为：<WEB_HOME>/WEB-INF/server-script/

导入的js文件必须位于WEB-INF目录下，建议都放在server-script目录中，目录层次可根据需要自行划分。

假设<WEB_HOME>/WEB-INF/server-script/a.js的内容如下

function sayHello(){
    println('hello');
}

那么我们可以这么用

<s:server-script import='a.js'><![CDATA[
    sayHello();
]]></s:server-script>

通过server-script标签的import属性，开发者可以导入外部的js库(其本质是提前执行一下)。

可以同时导入多个，用';'分割。import = 'a.js;b.js'。

外部js文件之间如果存在依赖关系，import的时候需要同时引入，且保证先后顺序。

这是我们用js改造的登录过程，login.svc

<?xml version="1.0" encoding="UTF-8"?>
<a:service xmlns:s="aurora.plugin.script" xmlns:a="http://www.aurora-framework.org/application">
    <a:init-procedure>
        <s:server-script import='tool.js'><![CDATA[
            var p = $ctx.parameter
            // 首先判断是否已经具备必要的登录信息
            if (!p.user_name) raise_app_error('Please Input UserName');
            if (!p.user_password) raise_app_error('SYS_PASSWORD_NULL');
            // 根据parameter中的user_name 查询用户
            bm = $bm('sys.login.sys_login', {
                rootPath: 'rp_user'
            });
            bm.query();
            user = $ctx.get('/model/rp_user/record');
            // 如果没查到任何用户，则创建一个虚拟的来代替，以便下面的逻辑一致
            if (!user) user = new CompositeMap();
            // 将用户输入的密码进行md5加密，以便与数据库中的比对
            p.md5_user_password = md5(p.user_password);
            // 将用户选择的语言环境标识写入session
            $session.write('lang', '/parameter/@user_language');
            // 进行各种校验...
            if (!user.user_id) raise_app_error('SYS_USER_NULL');
            if ('Y' == user.frozen_flag) raise_app_error('SYS_FROZEN_FAILURE');
            if (!user.nls_language) raise_app_error('SYS_LANGUAGE_NULL');
            if (p.md5_user_password != user.encrypted_user_password) raise_app_error('SYS_PASSWORD_FAILURE');
            if (!user.start_date) raise_app_error('SYS_USER_FAILURE');
            // 校验通过，允许登录，开始更新用户登录信息
            p.user_id = $session.user_id = user.user_id;
            $bm('sys.login.sys_user_login').update();
            p.encrypted_session_id = 'temp';
            p.client_ip_address = $ctx.get('/request/@address');
            // 向数据库中插入session记录，将返回的session_id加密，再更新回去
            $bm('sys.login.sys_session').insert();
            p.encrypted_session_id = des_encrypt(p.session_id);
            bm = $bm('sys.login.sys_session', {
                updatePassedFieldOnly: true
            });
            bm.update();
            // 将必要的信息写入session
            $session.clear();
            $session.write('session_id', '/parameter/@session_id');
            $session.write('lang', '/parameter/@user_language');
            $session.write('is_ipad', '/parameter/@is_ipad');
            $session.write('user_id', '/model/rp_user/record/@user_id');
            $cookie.put('JSID', p.encrypted_session_id);
            $cookie.put('IS_NTLM', 'N');
        ]]></s:server-script>
    </a:init-procedure>
    <a:service-output output="/parameter"/>
</a:service>

这是一个高级的主题。

我们的引擎允许直接在javascript中使用java的类，使用java类来创建对象，并且可以使用类中的方法。

作为开发者，我们建议，javascript最好是去调用java对象中写好的方法，而应该尽量避免直接编写大量的复杂的代码。也就是说，javascript充当了一个代理的角色。

这可以很好的避免性能问题，也可以曾加代码的重复利用率。

怎么样在javascript中准确的使用java的各种特性是一个复杂的话题，我们在此不做深入讨论。下面只介绍简单的模式：得到一个对象，调用他的方法

importPackage(Packages.com.hand.api);//效果等价于java中的import com.hand.api.*;不会自动导入子包
var apiInstance = new SomeAPI();//server-script中定义变量一律使用var,这点不同于java
var returnedValue = apiInstance.execute("param1",2,true);//调用方法,传参
println(returnedValue);//查看返回的值

returnedValue = SomeAPI2.getSomeValue(1,2,3);//静态调用也是可以的

//使用importPackage批量导入类的时候,可能会因为和其他包里面的类重名 而出现一些问题
//这时候也可以单独import一个类,如下
importClass(Packages.com.hand.api.SomeAPI);//仅导入SomeAPI,其他类不可用
//也可以不用import, 使用完整类名限定,如下
apiInstance = new Packages.com.hand.api.SomeAPI();

//1.定义一个java类型数组
var byteArray =  java.lang.reflect.Array.newInstance(java.lang.Byte.TYPE,4);
//以上代码创建了一个java类型的byte数组,长度是4
//2.实现一个接口
var runnable = new java.lang.Runnable({
	run : function(){
		println("run");
	}
});

var messageProvider = $instance('aurora.i18n.IMessageProvider');//取得IMessageProvider实例
var msg_code = 'SYS_PASSWORD_FAILURE';
var msg = messageProvider.getMessage('ZHS'，msg_code);//取出对应中文消息
$ctx.parameter.msg = String(msg)
//可以在返回的parameter中看到转换后的消息

var cache = $cache('DataCache');
var key = 'cache.test.key';
var value = cache.getValue(key);
if(value == null){
    println('no data found in cache, set it.');
    cache.setValue('cache.test.key','abcdefg');
}else {
    println('found it in cache.' + value)
}

var cache = $cache('DataCache');
var key = 'cache.test.users';
var value = cache.getValue(key);
if(value == null){
    println('no data found in cache ,query');
    var bm = $bm('sys.sys_user');
    var users = bm.queryAsMap();
    cache.setValue(key,users.getData());//取得对应java CompositeMap(可序列化)
}else{
    var users = new CompositeMap(value);//重新构造一个js CompositeMap
    println(users.getChildren().length);//打印记录数
}

var config = $config(); //取到config对象
var btn = CompositeUtil.findChild(config， 'button', 'id', 'btn_1'); //查找登录按钮
btn.put('text', 'new text'); //将登录按钮文本改为new text
var m = new CompositeMap('div').getData();//创建一个java CompositeMap
m.setText(new Date().toString());//设置文本
btn.getParent().getParent().addChild(m);//插入节点

var config = $config(); // 取到config对象
try {
    $bm("test.test").execute();// 会发生错误的代码
} catch (e) {
    var javaException = e.javaException;
    // 如果javaException无效，则表示此异常不是由java中抛出的异常，它应该是script语法错误之类的错误
    if (javaException) {
        // 拿到rootCause
        while (javaException && javaException.getCause
                && javaException.getCause()) {
            javaException = javaException.getCause();
        }
        var msg = javaException.getMessage();
        var view = CompositeUtil.findChid(config, "view");
        view.getChildsNotNull().clear();// 移除所有其他节点
        view.createChild("pre").setText(msg);// 添加新节点展示错误信息
    }
}

//这个函数可以处理所有类型的异常
function parseErrorMessage(e) {
    if (e.javaException)
        e = e.javaException;
    else
        return e.message;
    while (e && e.getCause && e.getCause())
        e = e.getCause();
    var serviceContext = Packages.aurora.service.ServiceContext
            .createServiceContext($ctx.getData());
    var ed = $instance('aurora.service.exception.IExceptionDescriptor')
    var map = new CompositeMap(ed.process(serviceContext, e));
    return map.message;
}

bm中的脚本是以feature的形式提供的。它可以在bm执行之前，动态的修改bm中的各种属性。目前bm中除了feature,exception-descriptor-config节点不能动态修改以外，其他内容基本上都可以修改。

<?xml version="1.0" encoding="UTF-8"?>
<bm:model xmlns:e="aurora.service.exception" xmlns:s="aurora.plugin.script" xmlns:bm="http://www.aurora-framework.org/schema/bm" xmlns:f="aurora.database.features">
    <bm:fields/>
    <bm:features>
        <f:standard-who/>
        <s:bm-script><![CDATA[
            $this.setBaseTable("sys_user");
            var f = Packages.aurora.bm.Field.createField('user_name');
            f.setDatabaseType('VARCHAR2');
            f.setDataType('java.lang.String');
            $this.addField(f);
            f = Packages.aurora.bm.Field.createField('user_id');
            f.setDatabaseType('NUMBER');
            f.setDataType('java.lang.Long');
            $this.addField(f);
            f = Packages.aurora.bm.Field.createField('encrypted_foundation_password');
            f.setDatabaseType('VARCHAR2');
            f.setDataType('java.lang.String');
            $this.addField(f);
            f = Packages.aurora.bm.Field.createField('encrypted_user_password');
            f.setDatabaseType('VARCHAR2');
            f.setDataType('java.lang.String');
            $this.addField(f);
            f = Packages.aurora.bm.Field.createField('start_date');
            f.setDatabaseType('DATE');
            f.setDataType('java.util.Date');
            $this.addField(f);
            var model = $this.getObjectContext();
            println(model.toXML());
        ]]></s:bm-script>
    </bm:features>
</bm:model>