使用 Node.js + Express 开发服务端

作者: sprint | 来源:发表于2016-07-06 20:44 被阅读26874次

    随着 Node.js 的发展,现在已经被很多人熟知, Node.js 已经成为了前端开发人员必备的技能。本文不会对 Node.js 过多介绍 如果你感兴趣可以访问 Node.js 官网, 维基百科

    本文是利用 Node.js + Express开发一个服务器程序,Express 是一种保持最低程度规模的灵活 Node.js Web 应用程序框架,为 Web 和移动应用程序提供一组强大的功能。详见:官网

    一 准备工作


    首先你需要安装 Node.js 环境 这里不再做介绍,
    1.安装Express

      npm install express -g
      npm install express-generator -g
    

    2.初始化项目

      cd /Users/SPRINT/Desktop 进入桌面
      express 项目名称
    

    项目名称我们指定为APIServer,从项目名称可以看出 我们是模拟服务器API
    在这里我们将提供一个获取用户详情接口 并输出JSON数据。

    初始化项目

    在终端最后位置 看到输出两个命令

    install dependencies:
       $ cd APIServer && npm install //告诉我们进入项目根目录 执行npm install安装依赖模块
    
    run the app:
       $ DEBUG=APIServer:* npm start //告诉我们启动服务器
    

    执行如下命令:

    1.cd APIServer //进入项目根目录
    2.npm install  //安装依赖
    

    我们回到桌面 你将看到一个APIServer目录 我在这里使用Sublime Text打开

    APIServer

    /bin:用来启动应用(服务器)
    /public: 存放静态资源目录
    /routes:路由用于确定应用程序如何响应对特定端点的客户机请求,包含一个 URI(或路径)和一个特定的 HTTP 请求方法(GET、POST 等)。每个路由可以具有一个或多个处理程序函数,这些函数在路由匹配时执行。
    /views: 模板文件所在目录 文件格式为.jade
    目录app.js程序main文件 这个是服务器启动的入口

    二 启动服务器


    首先启动服务器

    npm start   //启动服务器
    
    服务器启动

    启动完成后终端将输出 node ./bin/www
    在浏览器中访问 http://localhost:3000/

    浏览器输出

    三 基本使用


    打开app.js 这里介绍下主要代码

      var express = require('express');
      var path = require('path');
      var favicon = require('serve-favicon');
      var logger = require('morgan');
      var cookieParser = require('cookie-parser');
      var bodyParser = require('body-parser');
    
      var app = express();
    
    
    ///=======路由信息 (接口地址)开始 存放在./routes目录下===========//
      var routes = require('./routes/index');//home page接口
      var users = require('./routes/users'); //用户接口
    
      app.use('/', routes); //在app中注册routes该接口 
      app.use('/users', users);//在app中注册users接口
    ///=======路由信息 (接口地址 介绍===========//
    
    
    
    ///=======模板 开始===========//
    // view engine setup
      app.set('views', path.join(__dirname, 'views'));
      app.set('view engine', 'jade');
    ///=======模板 结束===========//
    

    当我们在浏览器中 访问 http://localhost:3000/ 调用的就是index中的接口
    我们打开index.js就可以看到该接口的定义:

    var express = require('express');
    var router = express.Router();
    
    
    //定义一个get请求 path为根目录
    /* GET home page. */
    router.get('/', function(req, res, next) {
        res.render('index', { title: 'Express' });
    });
    
    module.exports = router;
    

    定义一个路由的基本格式为:

    app.METHOD(PATH, HANDLER)
    

    其中:
    app 是 express 的实例。
    METHOD是 HTTP 请求方法
    PATH 是服务器上的路径。
    HANDLER 是在路由匹配时执行的函数。
    以上的定义代表
    在根路由 (/) 上(应用程序的主页)对 GET 请求进行响应:

    是不是明白了?

    如果我们想要实现一个获取用户信息接口该怎么写呢?
    很简单在 routes目录下创建一个user.js文件内容如下:
    定义一个User模型

    function User() {
          this.name;
          this.city;
          this.age;
    }
    module.exports = User;
    
    User

    切换到users.js文件
    在文件顶部添加

     var URL = require('url');  
    

    并继续添加如下内容:

    router.get('/getUserInfo', function(req, res, next) {
    
        var user = new User();
        var params = URL.parse(req.url, true).query;
      
     if(params.id == '1') {
    
        user.name = "ligh";
        user.age = "1";
        user.city = "北京市";
    
    }else{  
        user.name = "SPTING";
        user.age = "1";
        user.city = "杭州市";
    }
    
      var response = {status:1,data:user};
      res.send(JSON.stringify(response));
    
    });
    

    解释下重点:

     获取url参数 依赖于url模块 使用前需要使用  require('url')
    var params = URL.parse(req.url, true).query;  
    
    getUserInfo API

    由于users.js路由信息已经在app.js注册
    停止服务器 重新start服务器即可直接访问

    调用方式
    http://localhost:3000/users/getUserInfo?id=1
    或者
    http://localhost:3000/users/getUserInfo?id=2

    响应数据

    你是不是注意到我们访问的方式为users/getUserInfo?id=1 而不是基于根
    原因是我们在app.js注册方式为app.use('/users', users);
    我们可以利用这种方式 开发模块功能 比如 你有另外一个模块为msg
    我们注册为:app.use('/msgs', msgs);
    调用方式为
    http://localhost:3000/msgs/getUserMsgs?id=1

    这里我们写死了返回数据 并没有查询数据库
    当然NodeJS具备访问mysql的能力 但不是本篇文章的介绍范围

    OK 我觉得入门已经完全够了 点到为止~~~


    欢迎关注个人公众号:DevTipss

    DevTipss

    相关文章

      网友评论

      • 大牛在郑州:var User = require('./user');
        var express = require('express');
        var router = express.Router();

        router.get('/',function(req,res,next){
        res.send("user api");
        });

        router.get('/getUserInfo', function(req, res, next) {

        var user = new User();
        var params = URL.parse(req.url, true).query;

        if(params.id == '1') {

        user.name = "ligh";
        user.age = "1";
        user.city = "北京市";

        }else{
        user.name = "SPTING";
        user.age = "1";
        user.city = "杭州市";
        }

        var response = {status:1,data:user};
        res.send(JSON.stringify(response));

        });

        module.exports = router;var URL = require('url');

        报错 Cannot read property 'method' of undefined
      • 简单Gz:Mark。。。
      • ecb036b7adca:学习了,感谢:+1:
      • 赵角:你好,页面一直访问不了是什么问题呢,一直抱错

        This page isn’t working
        localhost didn’t send any data.
        ERR_EMPTY_RESPONSE
      • 44d433537590:非常感谢!!!
        前端一枚,找了许多文档都看不明白如何新建一个自己需要的项目。这篇文章说的很详细。后面的部分看不懂…超出知识范围:grin:
        sprint:@叫我娜姐_2c97 :v::v::v:
      • 薄荷不加冰_gyy:怎么启动服务啊,我启动报错啊
        薄荷不加冰_gyy:@sprint 谢谢:pray:
        sprint:@薄荷不加冰_gyy 进入项目目录后, 在终端执行 npm start
      • a6450ee03d4e:把静态页面放在目录结构下面的public文件夹下,通过npm start,开启服务就可以通过 localhost:3000/index.html 在浏览器中访问了
        minusplus:@没方向菇凉 public文件夹是这样用的吗?一直没用过这个
      • a6450ee03d4e:怎么停止服务器呀?npm start显示Port 3000 is already in use
        sprint:@没方向菇凉 不需要的 只要保证端口未被其他进程占用即可
        a6450ee03d4e:@sprint 哇哇哇,作者回复!!!!是每次运行都要回www中换端口吗?
        sprint:@没方向菇凉 端口占用了 换个端口
      • li_Struggle:users.js最终的代码 是这样。 希望作者下次写文章最好用成功的代码贴出来 。谢谢!

        var URL = require('url');
        var User = require('./user');
        var express = require('express');
        var router = express.Router();

        router.get('/',function(req,res,next){
        res.send("user api");
        });


        router.get('/getUserInfo', function(req, res, next) {

        var user = new User();
        var params = URL.parse(req.url, true).query;

        if(params.id == '1') {

        user.name = "ligh";
        user.age = "1";
        user.city = "北京市";

        }else{
        user.name = "SPTING";
        user.age = "1";
        user.city = "杭州市";
        }

        var response = {status:1,data:user};
        res.send(JSON.stringify(response));

        });

        module.exports = router;
      • 1294536ced3d:您好 请问view文件夹下怎么把jade文件后缀改成html
        js_冠荣:app.set('views', path.join(__dirname, 'views'));
        app.engine('.html',ejs.__express);
        app.set('view engine', 'html');
      • 含泪若笑:你好 问一下 怎么关闭nodejs的服务呢?
        Jake_aa36:users.js中除了var User = require('./user');
        還需要加上:
        var express = require('express');
        var router = express.Router();
        否則出錯。
        sprint:@hanleirx 可使用 终端 终止快捷键 ctrol+c
      • asce1885:users.js中还需要加上对user.js的引入:var User = require('./user');
        否者初学者会因为这个访问页面失败。
        31c1178ad6f9:谢谢你:smile: :blush:
        asce1885:@Moli_wu :joy:
        编程之上:@asce1885 这个作者确实漏了,要调用先引用
      • 81756181d949:jade重命名为pug了,还好用吗?
        sprint:@风清丶杨 没试啊 你试试啥

      本文标题:使用 Node.js + Express 开发服务端

      本文链接:https://www.haomeiwen.com/subject/etdadttx.html