inshua / d2js

d2js - 前后端web数据框架; jssp - Javascript Server Page;
MIT License
19 stars 10 forks source link

d2js, jssp 及 molecule 框架

d2js

Quick Start

后端为 SSH 框架杀手,前端为 angular 杀手

d2js 框架学习成本低,可以利用可视化SQL设计器,一般1天就可以上手。

d2js.fetch = function(params){
    this.checkPrivilege("uac.sys_role.query");

    params.node = params.node || this.session.user.node.id;

    sql{.
        select t.id,t.node,t.name,t.code,t.node_scope,t.role_level,t.state,t.remarks,nd.name node_name from uac.sys_role t, 
        uac.node nd 
        where t.node = nd.id and (nd.id = :node or nd.path @> array[:node])

        sql{.?(params.name)
                and strpos(t.name, :name) > 0
        .}
        sql{.?(params.state)
                and t.state = :state
        .}
        and t.role_level >= :role_level
    .}

    params.role_level = this.session.user.role.role_level; 

    sql = this.orderBy(sql, params._sorts, {name: 'asc'});

    return this.query(sql, params, params._page);
};

d2js.create = function(rcd){
    this.checkPrivilege("uac.sys_role.add");
    $V(this,rcd, {id : [],  
        node : [V.notNull],  
        name : [V.longest(100),V.uniqueInNode('uac.sys_role')],
        code : [V.longest(100),V.uniqueInNode('uac.sys_role')],  
        role_level : [V.longest(5)],        
        state : [V.longest(1),V.inside(["N","P"])]  

    }); 

    this.doTransaction(function(){
        rcd.id = this.nextId("uac.SEQ_ENTITY");
        this.actas('uac.sys_role.add', 'uac.sys_role', rcd.id, rcd);
        this.insertRow('uac.sys_role', rcd, ["id","node","name","code","node_scope","role_level","state","remarks"]);
        this.updateDispatchedFunctions(rcd.dispatched_functions, rcd.id);
    });

};

jssp

Quick Start

大致可以取代 php

尽管 d2js 前端(html + ajax) + d2js 后端 可以满足大部分应用场景,还是有很多场景需要页面在服务器端就绪后输出,不宜使用纯 ajax 技术。

jssp 是 JavaScript Server Page 的简称,是建构于 d2js 后端技术上的一种服务器端页面技术,运行于 jdk1.8以上 + servlet3.0 容器,采用 js 作为服务器端编程语言,并可以使用所有 d2js 后端技术,如 query, queryRow, travel, doTransaction等便利快捷的 d2js 函数。


上面的题目粗看有点哗众取宠,一旦实际使用会发现,去事实不远。需要澄清的是,这几个框架并不是为了扮演对应的那些框架的颠覆者而搞出来的。

d2js 原型早在 2007 年即已实现并实用了多年,当时原理是前端的 ado.net,后端的 ado dataadapter,已经包括了 render-collect等机制(区别于灵敏绑定),后台使用 DSL->Java 带有契约式编程风格,当时取代的是 struts2 框架,限于为原公司成果,此处不多介绍。

d2js jssp 及 molecule 框架之间具有可分可合既互相扶持又能独立作战的生态,并不是为了与市面上的各个框架竞争而发明的,也没有受过它们任何思想启发。

指南中的例子请按下述“研究与参与开发的过程”搭建环境后使用。

参考手册

按下述研究与参与开发 d2js 项目的过程初始化环境后,在项目 jsdoc 中有使用 jsdoc 生成的手册。

初始化环境

研究与参与开发 d2js 项目

  1. 安装 jdk8
  2. 安装 postgres9.4 以上版本数据库
  3. 在 postgres 中建立数据库,名为bookstore, 从 WebContent/bookstore/bookstore.backup 恢复该数据库。
  4. 下载解压eclipse wtp
  5. 下载解压tomcat7 或以上版本
  6. 在 eclipse 中导入 git 项目 https://github.com/inshua/d2js.git,这是一个 web 项目
  7. 设置 tomcat server.xmlconnectorURIEncoding=”utf-8”
  8. WebContent/WEB-INF/config/database.js中修改数据库连接。

启动网站后,打开 http://localhost:8080/d2js/ 即可看到功能展示页面。

使用 ANT 脚本创建使用 d2js 框架的新项目

  1. 按前面步骤下载本项目后,在项目根目录下找到 build.xml
  2. 运行该 ant 脚本的 crate-d2js-project 任务
  3. 在弹出的提示框依次输入项目名称、workspace 路径、数据库连接等信息,项目即创建成功
  4. 使用 eclipse 的导入现存项目功能导入 eclipse

该 ant 脚本可根据提供的信息自动创建项目,以后也可以改变项目名称或其它设定:

  1. WebContent/WEB-INF/config/database.js中修改数据库连接。
  2. 修改 WebContent/jslib/molecule.js,将 Molecule.ModulesPath 中的网站名称修改为你的项目名称,或自己用其它方式在其它地方设置Molecule.ModulesPath
  3. 该站其它自定义特性可在 application.d2js.js, application.jssp.js 中单独编写(如 productName 等)

在现有 web 项目中使用 d2js 技术

本框架可以和大部分 java web 框架并存。

  1. 获取 d2js 代码
  2. WebContent/jslibWebContent/WEB-INF/jslib, WebContent/WEB-INF/lib 复制到你的项目中
  3. 打开 WEB-INF/web.xml,增加 <web-fragment>d2js-fragment</web-fragment>
  4. 仿照WebContent/WEB-INF/config/database.js,设置好数据库路径

d2js 和你的 java 项目使用的是同一个容器,可以顺利访问容器提供的 session,也支持从 springmvc、mybatis 等框架获取 DataSource。

更新 d2js 代码

当 d2js 框架本身提交了新改动后,如何更新使用了 d2js 框架的工程呢?

项目的 build.xml 中有一个名为 update-d2js 的任务,通常只需运行该任务,d2js 相关的源文件即会自动更新到最新版本。

重要资源

  1. UAC 实体权限框架。采用 d2js 技术编写的权限框架,可作为不少项目的基础。已应用于多个商业项目。https://github.com/inshua/uac
  2. 在 d2js 中使用 activiti。d2js + activiti 备忘 - Inshua - 博客园
  3. 在 d2js 使用多种数据源。 在 d2js 使用多种数据源如spring数据源 - Inshua - 博客园
  4. tomcat 集群共享session。d2js 中实现 memcached 共享 session 的过程 - Inshua - 博客园