Pure JS (4.2)： Web 应用中服务器端 JS 调用 MongoDB 的简单示例

[align=center][size=medium][b]Pure JS (4.2)： Web 应用中服务器端 JS 调用 MongoDB 的简单示例[/b][/size][/align]
　　接着上一篇文章，本文将通过一个简单的示例说明如何通过服务器端 JS 调用 MogoDB，以及客户端 JS 向服务器端发起请求的方式。
　　首先我们可以先运行示例程序，然后我将介绍整体流程，最后我们再具体看看客户端 JS 和服务器端 JS 是如何编写的。
　　我们将看到通过使用 JavaScript Object 贯穿整个数据流程的模式是如何简化我们的开发的。

[align=center][size=medium][b]运行示例[/b][/size][/align]
　　下载附件，并将工程添加到 eclipse 中，配置 Java 7 JDK ，在命令行中运行 mongod；
　　打开文件 main/purejs/core/JSServer.java，鼠标右键 -> Run As -> Java Application 。
　　在浏览器中输入 [url]http://localhost:8080[/url] 进行访问，将看到如下界面：

[align=center][img]http://dl.iteye.com/upload/picture/pic/92014/4402a1f0-5403-316f-bc6a-342896c42bfc.png[/img][/align]
　　这个例子非常简单，只包括一个 users 列表，对每条数据可以执行两个操作：
　　1. 修改 description，并点击 Save 进行保存
　　2. 点击 Delete 删除对应的 user

　　最后一行用于增加 user ，可以执行两个操作：
　　1. 输入 name 和 description，并点击 Add 增加记录
　　2. 点击 Clear ，清空 name 和 description ，重新输入


　　每次操作完成后，users 列表将重新排序。

[align=center][size=medium][b]整体流程[/b][/size][/align]

　　我们可以直接以 JavaScript 对象作为 MongoDB 数据操作的参数，因此直接从客户端传递一个对象到服务器端是较好的方式。
[quote]　　虽然实际上也可以从客户端传递一段代码 （Function.toString()）到服务器端，但这么做具有安全隐患，因为客户端也可能传递一段具有破坏性的代码。
　　另外出于安全性的考虑，实际上经常需要对用户的身份和接收到的参数进行验证，这里简单起见，都省略了。
[/quote]
　　具体的步骤包括：
　　1.客户端 JS 处理界面事件，在 request 中指定执行操作的 controller 和 action，并将请求封装为 request.params 对象
　　2.服务器端接收到 request 对象后，调用所指定的 controller 的 action 函数，并将 request.params 作为参数传入
　　3.controller 中，通常需要从 MongoDB 获取 collection ，然后对这个 conllection 进行相应的操作。

　　我们可以用一张草图表示这个流程：

[align=center][img]http://dl.iteye.com/upload/picture/pic/92012/5824befc-a30a-32ed-a3d8-5fb222ca6c52.png[/img][/align]

　　接下来让我们结合例子进行说明。


[align=center][size=medium][b]客户端 JS[/b][/size][/align]
　　客户端 js 位于 webapp/js/index.js ，处理界面操作，并向服务器端发起请求。
　　除去一些界面操作的代码，客户端向服务器端发起请求的地方有三处：

　　[b]获取 users 列表[/b]
[code]
pure.post('users.list', function(data) {
users = data;
render();
});
[/code]
　　第一个参数指定了处理请求的 controller “users” 和需要执行的操作 “list”，
　　第二个参数表示请求成功时执行的函数，这里将 data 赋值给闭包中的变量 users ，并渲染页面。

　　[b]保存 user[/b]
[code]
pure.post({ action: 'users.save', params: user });
[/code]
　　第一个参数采用了 request 对象的方式，包含 action 和 params 两个属性。
　　　　【action: 'users.save'】：指定了 controller “users” 和操作 “save”
　　　　【params: user】：直接将 user 作为请求参数发送到服务器端进行保存。

　　[b]删除 user[/b]
[code]
pure.post({ action: 'users.remove', params: name });
[/code]
　　【action: 'users.remove'】：指定了 controller “users” 和操作 “remove”
　　【params: name】：将 user 的名称作为请求参数发送到服务器端作为删除的查询条件。

　　[b]pure.post 参数说明[/b]

　　第一个参数：request 对象，也可以接收 String 类型，将知道转为 { action: ... } 的形式。
　　requset 对象又可以包括两个属性：
　　　　【action】：形如 "contoller.action" 的字符串，标志处理请求的 controller ，和需要执行的操作
　　　　【params】：执行操作所需的参数，可以是 object 或基本类型。

　　第二个参数：请求成功时执行的函数，这个函数可以以参数形式接收返回的数据 ( result.data )
　　第三个参数：请求失败时执行的函数，这个函数可以以参数形式接收错误信息 ( result.error )


[align=center][size=medium][b]服务器端 JS[/b][/size][/align]
　　服务器端 js 位于 scripts/app/api.users.js，根据获得的参数，对 MongoDB 的 conllection 进行操作 。

　　服务器端的 api.users 对象实现了三个方法：
　　1. list ：获取 users 列表；当 users 为空时，进行数据初始化
　　2. save ：保存 user，以 name 作为查询条件，创建或更新 user
　　3. remove ： 删除 user，以 name 作为查询条件移除特定的 user

　　实现如下：
[code]
var api = api || {};

api.users = function(){
var users = pure.db.get('users');
return {
list: function() {
if (!users.count()) {
// Initialize ...
}

return users.$list();
},
save: function(params) {
var q = { name: params.name };
users.update(q, params, true, false);
},
remove: function(params) {
users.remove({ name: params });
}
}
}();
[/code]
　　首先通过 pure.db.get('users') 获取名为 “users” 的 collection，然后利用这个 collection 实现对应的操作。
　　数据初始化的代码后面还会继续探讨，这里就先省略了。

　　这段代码中涉及了几个 users 的方法：

　　[b]users.count()[/b]
　　表示统计 users 的数量。

　　[b]users.$list()[/b]

　　表示获取 users 列表， “$”表示将 DBCursor 转换为 JavaScript 数组。
　　这个例子是在客户端进行排序的，如果需要在服务器端进行排序，可以使用如下代码：
[code]
return user.list.$sort({ name: 1 });
[/code]

　　[b]users.update(q, params, true, false)[/b]
　　根据查询条件 q 获取对象，对象存在则更新，否则创建新的对象。

　　[b]users.remove({ name: params })[/b]
　　根据查询条件获取对象并删除。


　　接下来我们看看数据初始化的部分：
[code]
pure.db.eval(function(){
var users = db.users;
users.drop();
users.ensureIndex({ name: 1 });

users.insert({ name: 'user1', desc: 'desc1' });
users.insert({ name: 'user2', desc: 'desc2' });
users.insert({ name: 'user3', desc: 'desc3' });
});
[/code]
　　我们使用 eval 进行数据的初始化，pure.db.eval 可以接受 String 或 Function 类型的参数，Function 实际上也是转为 String 执行的。

　　初始化的操作包括：
　　1.通过 users.drop() 删除 collection
　　2.在 name 上建立索引，并且排序方式为升序
　　3.插入三个 users 对象

[align=center][size=medium][b]总结[/b][/size][/align]
　　客户端和服务器端都使用 JavaScript 进行编程，MongoDB 也有支持 JavaScript 的API，因此我们可以以一个 JavaScript 对象作为参数贯穿整个流程；
　　这将大大简化我们的开发，并且理解上也十分直观，这也正是“ Pure JS ”想要达到的效果。

　　下一篇文章将介绍 pure.db.js 是如何对 MongoDB 的数据操作进行封装的，以及一些与 MogoDB Driver 有关的内容。