数据库版本控制
hsweb使用nashorn来定义模块的初始化，更新脚本(hsweb-starter.js)。在模块首次引入,或者发生版本更新时，会执行对应的代码，利用此功能，可以实现对数据库的版本控制。
在模块的 resources下创建hsweb-starter.js. 内容如下:
//组件信息var info = {groupId: "org.hswebframework",artifactId: "hsweb-payment-pay",version: "1.0.2", //当前版本website: "http://payment.hsweb.io",author: "zhouhao",comment: "支付模块"};//版本更新信息var versions = [{version: "1.0.1",//版本升级到1.0.1时执行upgrade: function (context) {var database = context.database;//增加渠道供应商database.createOrAlter("pay_order").addColumn().name("channel_provider").varchar(128).notNull().comment("渠道供应商").commit().addColumn().name("channel_provider_name").notNull().varchar(128).comment("渠道供应商名称").commit().comment("支付订单表").commit();}},{version: "1.0.2", //版本升级到1.0.2时执行upgrade: function (context) {var database = context.database;database.createOrAlter("pay_order").addColumn().name("comment").varchar(2048).comment("说明").commit().comment("支付订单表").commit();}}];var JDBCType = java.sql.JDBCType;//首次启动此模块的时候执行function install(context) {var database = context.database;database.createOrAlter("pay_order").addColumn().name("id").varchar(32).notNull().primaryKey().comment("ID").commit().addColumn().name("order_id").varchar(128).notNull().comment("商户订单号").commit().addColumn().name("merchant_id").varchar(128).notNull().comment("商户ID").commit()//.....省略了更多字段设置.addColumn().name("status").varchar(16).notNull().comment("订单状态").commit().index().name("idx_order_id").column("order_id").unique().commit()//订单号唯一索引.index().name("idx_order_merchant_id").column("merchant_id").commit().comment("支付订单表").commit();}function initialize(){//首次使用此模块，在全部依赖安装完成后执行}//以下为固定的代码,无需修改dependency.setup(info).onInstall(install).onUpgrade(function (context) { //更新时执行var upgrader = context.upgrader;upgrader.filter(versions).upgrade(function (newVer) {newVer.upgrade(context);});}).onUninstall(function (context) { //卸载时执行}).onInitialize(initialize); //初始化
在应用启动完成后,会获取所有的hsweb-starter.js文件。
执行js并获取到模块信息。
根据模块信息判断模块是否安装或者更新。
执行对应的安装或者更新操作。
如果模块是首次执行，将会在全部模块安装完成后执行初始化操作。