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


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

    一、安装、搭建环境

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

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

    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/,效果如下:

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

    三、路由匹配

    上文我们是在客户端发起请求时,直接响应一段指定文本。但有时需要根据不同请求路径或请求方式,返回不同数据。所以我们新建一个文件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`) 
    });

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

    可以看到,我们已经拿到了不同返回体。但也许有人会问,如果此时我有很多请求,难道都堆在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,可以成功拿到返回体。

    上面通过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文件和一张图片。

    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"。此时我们尝试输入文件路径去读静态文件。

    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 启动服务,不用输入文件路径,直接就可以看到图片。

    此时代码与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只是示例 

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

  • 相关阅读:
    对象进行比较
    java中length,length(),size()区别
    引用数据类型、自定义类
    java方法
    学员信息管理系统案例
    商品库存管理查看增减
    引用数据类型Scanner,Random
    Cantor表巧妙的做法
    UVA 11292 The dragon of Loowater勇士斗恶龙 11729 突击战 Commando War
    期末,祝不挂
  • 原文地址:https://www.cnblogs.com/lemoncool/p/13877525.html
Copyright © 2020-2023  润新知