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 路径可能有点奇怪,我们在后面将看到如何用 page 对象处理页面请求。
不过,下一篇文章里,还是先让我们看一看文件上传与下载的相关内容吧。