[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 有关的内容。
接着上一篇文章,本文将通过一个简单的示例说明如何通过服务器端 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 有关的内容。