日期:2014-05-16  浏览次数:20505 次

PandaJS 使用说明 (1.2): Hello, World!
PandaJS 使用说明 (1.2): Hello, World!


  PandaJS 中服务器端处理的请求有两类,一类是 API 请求,另一类是页面请求。本文将介绍如何从客户端调用服务器端的 API ,并编写一个简单的 Hello, World! 示例。

  
准备工作

  利用上一篇文章中介绍的方法,建立新项目 HelloPanada,删除以下目录中的内容,因为我们将从零开始建立示例程序:

  1. scripts/app,scripts/test/app 和 scripts/test/both 目录中的文件
  2. webapp 目录中的 html 文件
  3. webapp/js 和 webapp/js/both 中的 js 文件,保留 webapp/lib 中的文件

   现在我们可以在 src/com/pandajs/Luncher.java 上点击鼠标右键,选择 Run As -> Java Application,Web 应用可以正常启动(虽然现在没有与数据库相关的操作,但还是请先启动 mongod),并输出日志。
  由于我们还没有编写处理请求的 JS 代码,因此现在还无法访问任何页面。

  PandaJS 支持热部署,通常不需要重启应用。
  那么接下来就让我们一边编写代码,一边看看效果吧。

  
HTML 页面

  首先,我们需要建立一个 HTML 页面,来显示服务器端 API 返回的结果,并引入必要的客户端 JS 文件。
  我们可以在 webapp 目录下创建文件 hello.html:
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
	<link href="css/hello.css" rel="stylesheet" type="text/css" />
</head>
<body>
	<div id="message" /></div>

	<script src="js/lib/jquery.js"></script>
	<script src="js/lib/jquery.tmpl.js"></script>
	<script src="js/lib/json.js"></script>
	<script src="js/lib/panda.js"></script>
	<script src="js/hello.js"></script>
</body>
</html>


  这个页面实际只包含了一个 id 为 message 的 div。我们会将服务器端 API 返回的结果放在这个 div 里。

  我们将使用 jQuery Template 渲染页面,因此我们引入了 jQuery 和 jQuery Template;
  同时 webapp/lib/panda.js 中包含了一些可以在客户端使用的便捷的函数。

  
Hello, World!

  接下来我们就要正式地为我们伟大的 Hello, World! 应用编写代码了。
  首先,我们需要在客户端 js 中向服务器端发起请求,并将结果显示在 ID 为 message 的 div 中。
  webapp/js/hello.js  
$(function(){
	// 构造 request 对象
	// 调用服务器端名称为 "hello.say" 的 API
	var request = {
		action: "hello.say"
	};

	// 发送请求
	// 并将结果显示在 ID 为 message 的 div 中
	panda.post(request, function(data) {
		$("#message").html(data);
	});
});


  相应地,在服务器端需要编写 hello.say 的处理程序。

  首先,需要在 scripts/app 目录下创建子目录 api 和 proxy。
  这个时候,如果 web 应用正在运行,将会自动创建全局对象 api 和 proxy;
  否则,将会在下次启动时创建。
引用
创建文件夹时自动创建全局对象,这是 0.0.2 版本新增的功能

  我们暂时还不会在 proxy 目录下创建 js 文件,但需要在 api 目录下创建hello.js,
  api.hello 是一个对象,实现了用于响应的客户端请求的方法:
  scripts/app/api/hello.js 
api.hello = {
	say: function() {
		return "Hello, World!";
	}
};

  
  在浏览器中输入http://localhost/hello.html,就可以在左上角看到 Hello, World! 了。
引用
proxy 对象用于实现日志、权限控制、数据校验等需要拦截方法调用的功能

  
Hello, Panda!

  光是让服务器端返回固定的结果,实在太单调了。
  接下来,就让我们向服务器端传递一些参数吧。

  首先,我们需要在构造  request 对象时增加参数:
$(function(){
	// 在 request 对象中增加了参数 params
	// 这个参数也可以是一个更复杂的 js 对象
	var request = {
		action: "hello.say",
		params: { name: "Panda" }
	};

	panda.post(request, function(data) {
		$("#message").html(data);
	});
});


  接着,我们需要修改服务器端 js,增加对参数的处理:
api.hello = {
	// 增加参数 params
	// 获取 params.name 并处理后返回
	say: function(params) {
		return "Hello, " + params.name + "!";
	}
};


  刷新页面,就可以在左上角看到 Hello, Panda! 了。


  到此为止,一个简单的 hello, World! (以及 Hello, Panda!)应用就算完成了。
  当然,直接在浏览器中输入 html 路径可能有点奇怪,我们在后面将看到如何用 pag