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

阅读更多
Pure JS (4.2): Web 应用中服务器端 JS 调用 MongoDB 的简单示例

  接着上一篇文章,本文将通过一个简单的示例说明如何通过服务器端 JS 调用 MogoDB,以及客户端 JS 向服务器端发起请求的方式。
  首先我们可以先运行示例程序,然后我将介绍整体流程,最后我们再具体看看客户端 JS 和服务器端 JS 是如何编写的。
  我们将看到通过使用 JavaScript Object 贯穿整个数据流程的模式是如何简化我们的开发的。

运行示例

  下载附件,并将工程添加到 eclipse 中,配置 Java 7 JDK ,在命令行中运行 mongod;
  打开文件 main/purejs/core/JSServer.java,鼠标右键 -> Run As -> Java Application 。
  在浏览器中输入 http://localhost:8080 进行访问,将看到如下界面:

Pure JS (4.2): Web 应用中服务器端 JS 调用 MongoDB 的简单示例_第1张图片

  这个例子非常简单,只包括一个 users 列表,对每条数据可以执行两个操作:
  1. 修改 description,并点击 Save 进行保存
  2. 点击 Delete 删除对应的 user

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


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

整体流程


  我们可以直接以 JavaScript 对象作为 MongoDB 数据操作的参数,因此直接从客户端传递一个对象到服务器端是较好的方式。
引用
  虽然实际上也可以从客户端传递一段代码 (Function.toString())到服务器端,但这么做具有安全隐患,因为客户端也可能传递一段具有破坏性的代码。
  另外出于安全性的考虑,实际上经常需要对用户的身份和接收到的参数进行验证,这里简单起见,都省略了。

  具体的步骤包括:
  1.客户端 JS 处理界面事件,在 request 中指定执行操作的 controller 和 action,并将请求封装为 request.params 对象
  2.服务器端接收到 request 对象后,调用所指定的 controller 的 action 函数,并将 request.params 作为参数传入
  3.controller 中,通常需要从 MongoDB 获取 collection ,然后对这个 conllection 进行相应的操作。

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

Pure JS (4.2): Web 应用中服务器端 JS 调用 MongoDB 的简单示例_第2张图片


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


客户端 JS

  客户端 js 位于 webapp/js/index.js ,处理界面操作,并向服务器端发起请求。
  除去一些界面操作的代码,客户端向服务器端发起请求的地方有三处:

   获取 users 列表
pure.post('users.list', function(data) {
	users = data;
	render();
});

  第一个参数指定了处理请求的 controller “users” 和需要执行的操作 “list”,
  第二个参数表示请求成功时执行的函数,这里将 data 赋值给闭包中的变量 users ,并渲染页面。

   保存 user
pure.post({ action: 'users.save', params: user });

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

   删除 user
pure.post({ action: 'users.remove', params: name });

  【action: 'users.remove'】:指定了 controller “users” 和操作 “remove”
  【params: name】:将 user 的名称作为请求参数发送到服务器端作为删除的查询条件。

   pure.post 参数说明

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

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



服务器端 JS

  服务器端 js 位于 scripts/app/api.users.js,根据获得的参数,对 MongoDB 的 conllection 进行操作 。

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

  实现如下:
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 });
		}
	}
}();

  首先通过 pure.db.get('users') 获取名为 “users” 的 collection,然后利用这个 collection 实现对应的操作。
  数据初始化的代码后面还会继续探讨,这里就先省略了。

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

   users.count()
  表示统计 users 的数量。

   users.$list()

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


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

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


  接下来我们看看数据初始化的部分:
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' });
});

  我们使用 eval 进行数据的初始化,pure.db.eval 可以接受 String 或 Function 类型的参数,Function 实际上也是转为 String 执行的。

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

总结

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

  下一篇文章将介绍 pure.db.js 是如何对 MongoDB 的数据操作进行封装的,以及一些与 MogoDB Driver 有关的内容。
  • PureJS.rar (1.2 MB)
  • 下载次数: 23

你可能感兴趣的:(应用服务器,MongoDB,Web,浏览器,JavaScript)