通过express快速搭建一个node服务

时间:2024-08-04 19:34:26

Node.js 是一个基于Chrome JavaScript 运行时建立的一个平台。可以理解为是运行在服务端的 JavaScript。如果你是一个前端程序员,不太擅长像PHP、Python或Ruby等动态编程语言,想创建自己的服务,那么Node.js是一个非常好的选择。本文将通过几个简要步骤,运用express框架,搭建一个node服务。

一、安装、搭建环境

1、新建一个文件夹,这里暂时叫做“node-service”。

2、进入文件夹,cmd执行npm init,可根据自己需要填写一些信息,不需要定制的话,前面一路回车即可,只需要在最后,即下图中红色圈起部分输入yes或者y。此时在文件夹内会生成一个package.json文件。红色划线部分是我示例填写,不是必需。

通过express快速搭建一个node服务

3、安装express

命令:cnpm install express --save

此时文件夹中会生成node-modules文件夹,以上命令会将express框架安装在node-modules目录中。以下几个重要模块,是可以与express一起安装的,大家根据自己需要进行安装即可。

body-parser - node.js 中间件,用于处理 JSON, Raw, Text 和 URL 编码的数据。

cookie-parser - 一个解析Cookie的工具。通过req.cookies可以取到传过来的cookie,并把它们转成对象。

multer - node.js 中间件,用于处理 enctype="multipart/form-data"(设置表单的MIME编码)的表单数据。

二、创建一个简单实例

在我们创建 Node.js 第一个 "Hello, World!" 应用前,让我们先了解下 Node.js 应用是由哪几部分组成的:

引入 required 模块:我们可以使用 require 指令来载入 Node.js 模块。

创建服务器:服务器可以监听客户端的请求,类似于 Apache 、Nginx 等 HTTP 服务器。

接收请求与响应请求 服务器很容易创建,客户端可以使用浏览器或终端发送 HTTP 请求,服务器接收请求后返回响应数据。

此时我们求创建一个服务:在客户端发起请求时,响应"hello world"字符串。

2.1、创建app.js文件,示例代码如下:

var express = require('express');
var app = express(); app.get('/', function(req, res){
res.send('hello world');
}); let port = 8082;
app.listen(port, () => {
console.log(`Server listening on http://localhost::${port}, Ctrl+C to stop`)
});

2.2、启动服务:根目录下执行命令 node app.js

2.3、在浏览器中访问http://localhost:8082/ 或http://127.0.0.1:8082/,效果如下:

通过express快速搭建一个node服务

此时有文本输出,说明服务搭建成功。

三、路由匹配

上文我们是在客户端发起请求时,直接响应一段指定文本。但有时需要根据不同请求路径或请求方式,返回不同数据。所以我们新建一个文件app1.js,代码如下:

var express = require('express');
var app = express(); // 默认请求,输出 "Hello World"
app.get('/', function (req, res) {
res.send('Hello GET');
})
// 用户删除接口
app.get('/user_del', function (req, res) {
res.send('用户删除接口');
})
// 用户信息查询接口 GET 请求
app.get('/user_list_query', function (req, res) {
res.send('用户列表数据');
}) let port = 8082;
app.listen(port, () => {
console.log(`Server listening on http://localhost::${port}, Ctrl+C to stop`)
});

文件中通过三个不同路径暴露了三个接口,接下来我们可以访问不同路径,看验证是否返回不同信息。

通过express快速搭建一个node服务

可以看到,我们已经拿到了不同返回体。但也许有人会问,如果此时我有很多请求,难道都堆在app1.js里嘛,能不能把请求归类一下,让app1.js整洁一些,只作为入口呢?当然可以。

假定现有两类接口,每类各有三个接口
一、用户管理
1、用户列表查询:user/user_list_query
2、用户信息删除:user/user_del
3、用户信息修改:user/user_update
二、部门管理
1、部门列表查询:dept/dept_list_query
2、部门删除:dept/dept_del
3、部门修改:dept/dept_update

此时我们在app1.js同级建立api文件夹,文件夹下新建文件user.js和dept.js。

// dept.js
let express = require('express');
let router = express.Router(); // 部门修改接口
router.get('/dept_update', function (req, res) {
res.send('部门修改接口');
}); // 部门删除接口
router.get('/dept_del', function (req, res) {
res.send('部门删除接口');
}); // 部门信息查询接口
router.get('/dept_list_query', function (req, res) {
res.send('部门列表数据');
}); module.exports = router;

user.js 与此类似,不再赘述。文件中通过使用express.Router()注册接口,通过module.exports抛出整个模块,然后在app1.js中引入并使用该模块:

//app1.js
var express = require('express');
var app = express();
let dept = require('./api/dept'); // 匹配请求,以dept开头的映射到dept文件中去
app.use('/dept', dept); let port = 8082;
app.listen(port, () => {
console.log(`Server listening on http://localhost::${port}, Ctrl+C to stop`)
});

重新启动8082服务。浏览器直接访问http://localhost:8082/dept/dept_update,可以成功拿到返回体。

通过express快速搭建一个node服务

上面通过2种方式,实现了匹配接口路径,给出不同返回体。做的更全一点,就可以模拟接口增删改查逻辑了。提到逻辑处理,就会和请求参数挂钩,所以我们向下看。

四、请求和响应处理

function中的req和res,分别是 request 和 response 对象。

request 对象 - 表示 HTTP 请求,包含了请求查询字符串,参数,内容,HTTP 头部等属性。

response 对象 - 表示 HTTP 响应,即在接收到请求时向客户端发送的 HTTP 响应数据。

这两个对象的常见属性简单列举如下,可根据自己需要进行调用。

req.app:当callback为外部文件时,用req.app访问express的实例
req.baseUrl:获取路由当前安装的URL路径
req.body / req.cookies:获得「请求主体」/ Cookies
req.fresh / req.stale:判断请求是否还「新鲜」
req.hostname / req.ip:获取主机名和IP地址
req.originalUrl:获取原始请求URL
req.params:获取路由的parameters
req.path:获取请求路径
req.protocol:获取协议类型
req.query:获取URL的查询参数串
req.route:获取当前匹配的路由
req.subdomains:获取子域名
req.accepts():检查可接受的请求的文档类型
req.acceptsCharsets / req.acceptsEncodings / req.acceptsLanguages:返回指定字符集的第一个可接受字符编码
req.get():获取指定的HTTP请求头
req.is():判断请求头Content-Type的MIME类型
res.app:同req.app一样
res.append():追加指定HTTP头
res.set()在res.append()后将重置之前设置的头
res.cookie(name,value [,option]):设置Cookie
opition: domain / expires / httpOnly / maxAge / path / secure / signed
res.clearCookie():清除Cookie
res.download():传送指定路径的文件
res.get():返回指定的HTTP头
res.json():传送JSON响应
res.jsonp():传送JSONP响应
res.location():只设置响应的Location HTTP头,不设置状态码或者close response
res.redirect():设置响应的Location HTTP头,并且设置状态码302
res.render(view,[locals],callback):渲染一个view,同时向callback传递渲染后的字符串,如果在渲染过程中有错误发生next(err)将会被自动调用。callback将会被传入一个可能发生的错误以及渲染后的页面,这样就不会自动输出了。
res.send():传送HTTP响应
res.sendFile(path [,options] [,fn]):传送指定路径的文件 -会自动根据文件extension设定Content-Type
res.set():设置HTTP头,传入object可以一次设置多个头
res.status():设置HTTP状态码
res.type():设置Content-Type的MIME类型

五、静态文件服务器

有时,我们的一些静态文件,例如图片、CSS文件、js文件等,想放在一个服务器上,此时node可以作为静态文件服务器。

express 提供了内置的中间件 express.static 来设置静态文件路径。

app.use('/public', express.static('public'));

我们在app.js同级,新建一个public目录,存放静态文件。向里面放一个css文件和一张图片。

通过express快速搭建一个node服务

5.1、按路径读取文件:

新建app2.js文件:

var express = require('express');
var app = express(); app.use('/public', express.static('public')); app.get('/', function(req, res){
res.send('hello world');
});
let port = 8082;
app.listen(port, () => {
console.log(`Server listening on http://localhost::${port}, Ctrl+C to stop`)
});

将之前占用8082端口的服务停掉,通过node app2.js 启动服务。可以看到默认输出"hello world"。此时我们尝试输入文件路径去读静态文件。

通过express快速搭建一个node服务

通过express快速搭建一个node服务

5.2、接口返回静态文件

上面示例是需要自己输入文件路径拿到文件,有人说输路径太麻烦了,能不能通过一个接口返回指定静态文件呢?res.sendFile来了,新建app3.js :

var express = require('express');
var app = express(); app.use('/public', express.static('public')); app.get('/', function(req, res){
console.log(__dirname); // 打印结果:/node-service
res.sendFile(__dirname+'/public/avatar.jpg');
}); let port = 8082;
app.listen(port, () => {
console.log(`Server listening on http://localhost::${port}, Ctrl+C to stop`)
});

此时执行node app3.js 启动服务,不用输入文件路径,直接就可以看到图片。

通过express快速搭建一个node服务

此时代码与5.1基本相同,差异是用了res.sendFile。

__dirname 是当前模块的目录名。 相当于 __filename 的 path.dirname()

console.log(__dirname);
// 打印: /node-service
console.log(path.dirname(__filename));
// 打印: /node-service,前提是引入了path模块,没有引入的话,打印会报错

Tips:

    1、app.js文件,每次改动都要重新启动服务才能生效。 

    2、如果两个js文件用了同一个端口,同时启动会报端口占用,可每次只起一个,或者用两个端口。

    3、启动命令是node js 文件名,app.js只是示例 

如果有需要,点击此处链接获取文章实例源码(点我!点我!),或者关注公众号可更早获取文章~