简介
Hapi.js 是一个 Node.js 的 Web 框架，它提供了一系列的工具和插件，可以快速地构建 RESTful API。
本文将介绍如何使用 Hapi.js 实现一个完整的 RESTful API，并包含示例代码。
准备工作
在开始之前，你需要安装以下软件：
- Node.js
- npm
安装完成后，你可以通过以下命令来检查是否安装成功：
node -v npm -v
如果显示版本号，则表示安装成功。
创建项目
首先，我们需要创建一个项目并安装必要的依赖。在命令行中执行以下命令：
mkdir hapi-restful-api cd hapi-restful-api npm init -y npm install hapi joi boom --save
其中，hapi 是 Hapi.js 的核心库，joi 是一个数据校验库，boom 是一个 HTTP 错误处理库。这些库都是我们在构建 RESTful API 时必须的。
实现 API
在项目根目录下创建一个名为 index.js 的文件，并输入以下代码：
// javascriptcn.com 代码示例
const Hapi = require('hapi');
const Joi = require('joi');
const Boom = require('boom');
const server = new Hapi.Server({
host: 'localhost',
port: 3000
});
const todos = [
{ id: 1, text: 'Learn Node.js', completed: true },
{ id: 2, text: 'Learn Hapi.js', completed: false }
];
server.route({
method: 'GET',
path: '/todos',
handler: (request, h) => {
return todos;
}
});
server.route({
method: 'POST',
path: '/todos',
handler: (request, h) => {
const todo = {
id: todos.length + 1,
text: request.payload.text,
completed: false
};
todos.push(todo);
return todo;
},
options: {
validate: {
payload: Joi.object({
text: Joi.string().required()
})
}
}
});
server.route({
method: 'PUT',
path: '/todos/{id}',
handler: (request, h) => {
const id = parseInt(request.params.id);
const todo = todos.find(todo => todo.id === id);
if (!todo) {
throw Boom.notFound(`Todo with id ${id} not found`);
}
todo.text = request.payload.text || todo.text;
todo.completed = request.payload.completed || todo.completed;
return todo;
},
options: {
validate: {
params: Joi.object({
id: Joi.number().integer().min(1).required()
}),
payload: Joi.object({
text: Joi.string(),
completed: Joi.boolean()
}).min(1)
}
}
});
server.route({
method: 'DELETE',
path: '/todos/{id}',
handler: (request, h) => {
const id = parseInt(request.params.id);
const index = todos.findIndex(todo => todo.id === id);
if (index === -1) {
throw Boom.notFound(`Todo with id ${id} not found`);
}
todos.splice(index, 1);
return h.response().code(204);
},
options: {
validate: {
params: Joi.object({
id: Joi.number().integer().min(1).required()
})
}
}
});
async function start() {
try {
await server.start();
console.log(`Server running at: ${server.info.uri}`);
} catch (err) {
console.log(err);
process.exit(1);
}
}
start();上面的代码实现了一个简单的 Todo List RESTful API，包括以下功能：
- 获取所有 Todo：GET /todos
- 创建一个 Todo：POST /todos
- 更新一个 Todo：PUT /todos/{id}
- 删除一个 Todo：DELETE /todos/{id}
其中，/todos 是资源路径，{id} 是 URL 参数。
我们可以通过以下命令启动服务：
node index.js
然后在浏览器中访问 http://localhost:3000/todos，即可看到所有的 Todo。
总结
本文介绍了如何使用 Hapi.js 实现一个完整的 RESTful API，并包含示例代码。在实际开发中，我们可以根据需要添加更多的路由和中间件，以满足不同的需求。
来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/655b15c2d2f5e1655d541d34