PandaJS 使用说明 (1.2)： Hello, World!
程序员文章站
2022-04-26 14:17:55
...
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 对象处理页面请求。
不过，下一篇文章里，还是先让我们看一看文件上传与下载的相关内容吧。
上一篇： Pure JS (7)：小结