创建一个提供数据 API 的 Node.js 网站

8870188

创建站点目录
　　首先，创建一个文件夹用来保存你的站点文件，使用 mkdir 就可以了



PS C:\> mkdir mysite
　　然后，进入到这个文件夹进行下一步的操作。

创建包说明
　　使用记事本或者你喜欢的任何纯文本编辑器创建 package.json 文件，文件名是一个约定必须是这个名字。
　　创建本网站自身的说明，说明依赖的其它包。



{
"name": "express-api",
"version": "0.0.1",
"dependencies": {
"express": "2.5.9",
"ejs": "0.4.2"
}
}
安装需要的包
　　然后，执行 npm install 安装所依赖的包。npm 会自动寻找当前目录下的 package.json 文件的。
　　安装之后，目录中多了一个文件夹 node_modules.


创建程序
　　使用任何你喜欢的纯文本编辑器开始写你的 node.js 代码，如果你有 Visual Studio 当然更好了。
　　先让我们的服务器运行起来。创建名为 server.js 的代码文件，写入下面的内容就可以创建一个 web 服务器了。



var express = require("express");
var app = express.createServer();
console.log("Web Server listening ......");
app.listen(3000);
　　在命令行执行下面的命令 node server ，启动我们的站点。你会看到网站服务器已经在运行了。



PS C:\mysite> node server
Web Server listening ......
　　但是，访问一下，你会发现无法找到网页，当然了，我们现在一个网页也没有呀！

创建视图
　　你可以注意到了，我们的站点依赖于一个名为 ejs 的模块，这个模块提供了视图支持，我们可以使用类似于 ASP.NET MVC 中的视图来创建页面。
　　在站点的根目录下创建一个名为 views 的文件夹，保存我们的视图。
　　创建我们的欢迎页面 index.ejs，注意扩展名，这是 ejs 的约定。



<h1>Data API</h1>
<p>Welcome!</p>
　　把我们的代码修改一下，当访问 / 的时候，返回这个视图。



var express = require("express");
var app = express.createServer();
app.set("view engine", "ejs");
app.set("views", __dirname + "/views");
app.set("view options", { layout: false });
app.get("/", function (request, response) {
response.render("index");
});
console.log("Web Server listening ......");
app.listen(3000);
　　增加的几个 set 用来说明我们的视图引擎要使用 ejs 引擎，我们的视图文件保存在当前目录下的 views 文件夹中，现在还没有使用布局。
增加的 get 则说明当接收到一个 get 请求访问 / 的时候，我们需要使用名为 index 的视图来呈现返回结果。
　　现在访问 http://127.0.0.1:3000 就会收到这样的回应了。

创建数据
　　我们希望提供数据的 API ，数据保存在哪里呢？
　　我们先保存一个 json 文件中，这个文件包含用户的信息，名为 data.json。



{
"1": {
"name":"tom",
"email":"tom@nodejs.org"
},
"2": {
"name":"red",
"email":"red@nodejs.org"
}
}
　　然后，我们希望通过用户的标识来获取用户的信息。
在我们的代码中添加下面的一段。



app.get("/user/:id", function (request, response) {
var id = request.params.id;
console.log(id);
response.json(data[id]);
});
　　:id 表示这是一个参数，在处理函数中可以通过 request.params.id 来获取到。
　　新增加的第一行用来加载我们的数据文件 data.json ，不要忘了前面的 ./ , 否则 node 会到 node_modules 中去找这个模块的。
现在我们的代码变成了这样。



var data = require("./data");
var express = require("express");
var app = express.createServer();
app.set("view engine", "ejs");
app.set("views", __dirname + "/views");
app.set("view options", { layout: false });
app.get("/", function (request, response) {
response.render("index");
});
app.get("/user/:id", function (request, response) {
var id = request.params.id;
console.log(id);
response.json(data[id]);
});
console.log("Web Server listening ......");
app.listen(3000);
　　现在，在地址栏中输入 /user/1 ，你就会收到一个 json 的返回结果，其中是 1 号用户的信息了。

　　数一数，你用了几行就实现了一个简单的 API 服务？
　　包括空行也只有 20 行而已。