d2js 的接口单独看有点像小手工业者,每个人摆弄着自己的小功能,但是在 update 的一声号令下,它们也可以组合起来,发挥出整体的功效,变为流水线上的工人——这一切是自然而隐蔽的进行的,小手工业者不需要为进工厂而改变自己。

这是怎么做到的呢?

d2js 的接口可以通过浏览器地址栏调用。

以下面的接口为例:

d2js.exports.test = d2js.test = function(params){
    return {result : params.a + params.b}
}

在浏览器地址栏输入:

http://localhost:8080/d2js/test.d2js?_m=test&params={%22a%22:1,%22b%22:2}

除了以json方式提供params,还可以分散在query string提供。

http://localhost:8080/d2js/test.d2js?_m=test&a=1&b=2

以该方式提供参数会视被为字符串:

需要在接口中做参数转换:

d2js.exports.test = d2js.test = function(params){
   
    $V(this, params, {a: [T.int], b: [T.int]})
   
    return {result : params.a + params.b}
}

d2js 接口加以导出即可通过浏览器直接访问,使用浏览器地址栏就可以随意注入参数进行测试,这为后端开发提供了很大便利。

作为普通函数,d2js 可以在其它函数中调用,如:

d2js.test2 = function(params){
    var a = params.a, b = params.b
    return this.test({a: a * a, b: b * b})
}

可以在另一个d2js中调用:

d2js.test2 = function(params){
    var a = params.a, b = params.b
    return this.callD2js('test.d2js', 'test', [{a: a * a, b: b * b}]);
}

可以使用表单调用:

<form method="post" action="test.d2js?_m=test">
    a: <input type="number" name="a">
    b: <input type="number" name="b">
    <input type="submit">
</form>

也可以使用 ajax 调用:

$.get('test.d2js', {_m : 'test', params: JSON.stringify({a:2, b:3})},

function(s){
        console.log(s)
    }

);

用表单方式得到的是一个奇怪的 JSON 页面,不过这没有关系,通过一个简单的 wrapper 即可满足表单使用场景:

d2js.exports.formEntry =
d2js.formEntry = function(params){
    var result = this[params._entry](params);
    this.request.setAttribute('result', result)
    this.request.servletContext
        .getRequestDispatcher('/test.jssp')
        .forward(this.request, this.response);
    this.out.print('')    //阻止输出{success:true}
}

用法:

<form method="post" action="test.d2js?_m=formEntry">
    <input type="hidden" name="_entry" value="test">
    a: <input type="number" name="a">
    b: <input type="number" name="b">
    <input type="submit">
</form>

test.jssp:

<html>
[%
    var result = request.getAttribute('result')
%]
<body>
    <h1>[%= result.result %]</h1>
</body>
<html>

如需完全满足表单式应用场景, formEntry 函数还需要进一步完善,如实现跳转词典等等。

d2js 接口支持 POST,PUT,GET,DELETE 语义,分别对应 modify, create, fetch, destroy 四个接口,也就是说,在上述配对情形中使用,可以不提供 _m 参数。

一个典型的 d2js 文件具有 crud 四接口:

d2js.fetch = function(){

sql{.

select .. from …

.}

return this.query(sql, params);

}

d2js.create = function(rcd){

this.insertRow('table', rcd)

}

d2js.modify = function(rcd){

this.updateRow('table', rcd)

}
d2js.destroy = function(rcd){

this.deleteRow('table', rcd)
}

这四个接口都可以像上面一样独立使用。

不仅如此,create, modify, destroy 三接口还可以被前端聚合!

d2js 框架前端是一个主要为 DataTable 形态的数据结构。DataTable 可以改动多行,一起提交:

table.rows[0]._set('name', 'Jack')
table.rows[1]._set('name', 'Mike')
table.rows[2].remove();
table.addRow({name:'Mary'});
table.submit();

submit 函数调用时,上面代码中表的四行变动汇总为一个表变动信息,合并提交至 D2JS.prototype.update 函数,D2JS.prototype.update 函数根据行状态(edit,remove,new),调用相应的函数(modify, destroy, create)。该函数内为一个循环,处在一个事务中,一旦出错全体回滚。

此外,前端还支持表间关联,提交父表时,可连带提交子表。

提交多行的例子可参见 https://github.com/inshua/d2js 提供的示例。

下面是例子中提交的JSON数据:


   "_m":"update",
   "table":{ 
      "name":"author",
      "src":"/d2js/d2js-test/author.d2js",
      "columns":[ 
         ...
      ],
      "rows":[ 
         { 
            "id":1,
            "name":"曹雪芹",
            "email":"caoxueqin@gmail.com",
            "tel":"111222333",
            "remarks":"曹雪芹先生是伟大的作家",
            "gender":"M",
            "info":{ 
               "linkin":"123456aabb"
            },
            "_state":"edit",
            "_idx":0,
            "_origin":{ 
               "id":1,
               "name":"曹雪芹",
               "email":"caoxueqin@gmail.com",
               "tel":"111222333",
               "remarks":"曹雪芹先生是伟大的作家",
               "gender":"M",
               "info":{ 
                  "linkin":"123456aa"
               }
            },
            "_children":[ 
               { 
                  "name":"book",
                  "src":"/d2js/d2js-test/book.d2js",
                  "columns":[ 
                     ...
                  ],
                  "rows":[ 
                     { 
                        "id":7,
                        "title":"红楼梦2",
                        "kind":"f",
                        "publish_date":"1977-02-03T00:00:00.000Z",
                        "isbn":"2323121",
                        "remarks":null,
                        "author":1,
                        "author_name":"曹雪芹",
                        "_state":"edit",
                        "_idx":0,
                        "_origin":{ 
                           "id":7,
                           "title":"红楼梦",
                           "kind":"f",
                           "publish_date":"1977-02-03T00:00:00.000Z",
                           "isbn":"2323121",
                           "remarks":null,
                           "author":1,
                           "author_name":"曹雪芹"
                        }
                     }
                  ]
               }
            ]
         }
      ]
   }
}

根据数据提到的 src,和行状态,D2JS.prototype.update 函数会为为执行相应入库动作。

可见,d2js 接口解耦程度极高,可聚可分,可联合作战,可独立作战,可用于 ajax 方式,表单方式、DataTable  方式,适合与各种前端模型混搭——当然,搭配 d2js 前端使用更珠联璧合。

这套架构可以称为邦联式架构,每个接口都是独立的能行驶职能的政权,但也可以随时结合为一个更大的政权结构。

D2js 的邦联式架构的更多相关文章

  1. C#实现插件式架构的方法

    插件式架构,一种全新的.开放性的.高扩展性的架构体系.插件式架构设计近年来非常流行,基于插件的设计好处很多,把扩展功能从框架中剥离出来,降低了框架的复杂度,让框架更容易实现.扩展功能与框架以一种很松的 ...

  2. 转发-基于ASP.NET MVC 4/5 Razor的模块化/插件式架构实现

    基于ASP.NET MVC 4/5 Razor的模块化/插件式架构实现   概述 在日常开发中, 我们经常谈起模块化/插件化架构,这样可既可以提高开效率,又可以实现良好的扩展性,尤其对于产品化的系统有 ...

  3. client-server model peer-to-peer architecture 主从式架构

    w https://zh.wikipedia.org/wiki/主从式架构 主从式架构 (Client–server model) 或客户端-服务器(Client/Server)结构简称C/S结构,是 ...

  4. 基于ASP.NET MVC 4/5 Razor的模块化/插件式架构实现

    概述 在日常开发中, 我们经常谈起模块化/插件化架构,这样可既可以提高开效率,又可以实现良好的扩展性,尤其对于产品化的系统有更好的实用性. 架构 我们采用的是MVC5(本文中介绍的方法对于MVC4也是 ...

  5. Distributed--分布式架构

    如果我们期望实现一套严格满足ACID特性的分布式事务,很可能出现的情况就是在系统的可用性和严格一致性之间出现冲突. 在可用性和一致性之间,永远无法存在一个两全其美的方案. 从集中式到分布式 集中式系统 ...

  6. MySQL-19-分布式架构MyCat

    MyCAT基础架构图(实验环境) MyCAT实验环境准备 1 环境准备 两台虚拟机: db01(10.0.0.51) db02(10.0.0.52) 每台创建四个mysql实例:3307 3308 3 ...

  7. 响应式架构:消息模式Actor实现与Scala、Akka应用集成

    这是一本最近很流行的书. 有时间就去看看

  8. ASP.NET MVC:模块化/插件式架构实现(转载)

    I’ve recently spent quite a lot of time researching and prototyping different ways to create a plugi ...

  9. HDFS 架构解析

    本文以 Hadoop 提供的分布式文件系统(HDFS)为例来进一步展开解析分布式存储服务架构设计的要点. 架构目标 任何一种软件框架或服务都是为了解决特定问题而产生的.还记得我们在 <分布式存储 ...

随机推荐

  1. VPN 部署方案

    VPN 对比: OpenVPN: 客户端连接太麻烦,放弃 PPTP VPN:版本较高的苹果手机没有 PPTP VPN 的连接方式,放弃 L2TP VPN:支持所有平台,客户端连接容易,最终选择部署 L ...

  2. Lua面线对象学习

    --[[ ]] local userdata = {} local Register = {} function Register:del(key) userdata[self.namespace][ ...

  3. codevs 1388 砍树

    时间限制: 1 s  空间限制: 256000 KB  题目等级 : 黄金 Gold 题目描述 Description 伐木工人米尔科需要砍倒M米长的木材.这是一个对米尔科来说很容易的工作,因为他有一 ...

  4. 《中国文明史》系列—外柔 VS 内厉

    读启良的<中国文明史>,里面有谈到外柔而内厉——中国政府自古以来奉行的准则.大致意思是说,我华夏民族对待周边民族,历来是很友好的,即所谓的“柔”,而对待自己人,向来是“刚”或曰“厉”的. ...

  5. [LeetCode] Two Sum II - Input array is sorted 两数之和之二 - 输入数组有序

    Given an array of integers that is already sorted in ascending order, find two numbers such that the ...

  6. FineUI(专业版)v3.1发布(ASP.NET控件库)!

    FineUI(专业版)v3.1 正式发布,60多项更新,官网示例多达 690 个,新增 30 个页面加载动画! 自 2008 年 4 月发布第一个版本,我们持续更新了 126 个版本,拥有 16000 ...

  7. Android中关于cpu/cpuset/schedtune的应用

    Android中关于cpu/cpuset/schedtune的应用都是基于进程优先级的,根据不同优先级划分进程类型.AMS(ActivityManagerService)和PMS(PackageMan ...

  8. css:子元素div 上下左右居中方法总结

    最近在面试,不停地收到了知识冲击,尤其是对于一些基础的css.html.js问题居多,所以自我也在做反思,今天就css问题,如何让一个子元素div块元素上下左右居中 (以下总结方法,都已得到验证). ...

  9. 递推 HDU 2569

    考虑n-2 n-1 n z[n] 代表n个块 可行方案 1  n-2 和n-1 同 3*z[n-2] 2  n-2和n-1不同 2*(z[n-1]-z[n-2]); 减一减 然后可能是其中一种 *2 ...

  10. 菜鸟git学习

    基础知识: 安装github之后,所有的命令在git shell 中输入. E:\文档\GitHub [master +2 ~0 -0 !]> cd [ToDoList]E:\文档\GitHub ...