Express 搭建web服务器

2,110

原文发表于我的个人博客,欢迎访问

安装Nodejs

windows

1.打开node官网nodejs.org

2.直接点击 LTS 版本,下载安装包,Current版本是开发版,不要下载,如图

图片描述
下载完成之后,直接安装即可

ubuntu

运行以下命令

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt-get install -y nodejs

mac

与windows类似,下载安装包即可

安装完成后,运行如下命令检查是否安装成功,(以上方法安装node都会带上对应的npm,所以也需要检查一下npm是否安装成功。)

node -v // 检查node版本
npm -v  // 检查npm版本

搭建服务器

安装express

Express is a minimal and flexible Node.js web application framework that provides a robust set of features for web and mobile applications.

npm install express -g            // 全局安装express
npm install express-generator -g  // 全局安装express脚手架,安装之后可以使用express命令
express --version                 // 检查express版本

生成项目文件

mkdir app
cd app
/**
 * 生成项目文件
 * express 默认使用ajs模板,加上 -e 指定更友好的ejs模板
 */
express -e
npm intall    // 安装依赖
npm start     // 启动项目

然后浏览器访问localhost:3000,最简单的服务器就ok了。

Express 进阶

如何修改程序启动的默认3000端口

Express 的启动目录是<project>/bin/www,里面有一行代码:

var port = normalizePort(process.env.PORT || '3000');

不难看出程序先去取process.env.PORT(环境变量PORT)的值,没有就默认为3000

所以如果想改变端口,可以直接把3000改成想要的端口号或者修改环境变量PORT的值,操作如下:

在启动程序之前,执行

// ubuntu IOS
export PORT=4000;
// windows
set PORT=4000;

然后执行npm start,端口就被设置成了4000.

如何修改运行环境

Express默认的运行环境是development,运行环境可以通过process.env.NODE_ENV来获取,将系统环境设置为production,代码如下:

// ubuntu IOS
export NODE_ENV=production
// wondows
set NODE_ENV=production

如何添加接口

app.js中,app.use('/', routes);前面新增

app.get('/status', function (req, res) {
       res.send({status: 'ok'});
})

启动服务器,访问localhost:3000/status,得到数据{status: 'ok'}; 具体分析一下: app.get(), get是app对象的一个方法,负责处理get方法,改成post,则只处理post请求,不会处理别的请求,其余像put,delete类似。若写成use,则会处理此路由任何方法的请求。 /status, 指定需要处理的路由 回调函数,即请求此路由的处理函数,它可以接收两个参数,三个参数,四个参数。一旦参数为四个就被express认定是错误处理函数

// app.js 里这就是个错误处理函数,用来处理所有路由上面抛出的错误,一般写在最后
app.use(function(err, req, res, next) {
    res.status(err.status || 500);
    res.render('error', {
      message: err.message,
      error: err
    });
});

req Express 封装的http request对象,包含headers,query,params等自带属性。用来获取某次http请求的各项数据。 res Express 封装的http reponse对象,包含send,json,jsonp等方法。 next 如果执行next,在执行完此处理函数之后,会继续向后找下一个处理函数,

app.get('/test-next', function(req, res, next) {
       console.log('first handler fn');
       next();
});
app.get('/test-next', function(req, res, next) {
       res.send({status: 'second handler fn'});
}

浏览器访问localhoat:3000/test-next,会得到{status: 'second handler fn'}, 处理路由/test-next,第一个回调函数,执行到next()时,继续找下一个能处理/test-next的回调.

什么是中间件

中间件(middlewear)是Express中的一个重要概念,Express使用中间件完成对请求体的改造,或者执行一些中间操作。归根结底,中间件就是一个函数,满足两个条件,

  1. req,res,next三个参数,
  2. 最后执行next函数,将处理权移交出去

写一个打印请求的中间件:

// 定义中间件,打印请求的方法和url
function logRequest(req, res, next) {
  console.log(req.method, method.url);
  next();
}
// 使用中间件
app.use(logRequest);

Express 如何处理路由

对于一个请求,Express处理经过一下流程

1.从第一个use开始处理请求,如果是中间件,处理完成之后,继续向下处理

2.如果遇到指定静态文件的中间件,会查询静态文件是否匹配,如果匹配直接返回,不匹配就继续向下寻找合适路由。

3.如果匹配到自定义的路由,立即执行回调函数,如果处理函数中没有next()则不再往下执行,如果执行了next(),会继续向下匹配。

4.如果一个也没有匹配到,会进入404处理中间件,这个中间件会抛出一个错误,交由错误处理中间件处理。

理解静态资源处理中间件

app.use(express.static(path.join(__dirname, 'public')));,express.static(PATH) 会将指定的目录下的所有资源作为静态资源。客户端可以输入指定资源的路径访问此资源。其实可以理解为将静态资源的路径,作为路由注册到了app。 如果要将文件<project>/public/stylesheets/style.css,设置为静态资源,可以指定静态文件目录

app.use(express.static(path.join(__dirname, 'public')));

也可以不设置静态文件,自定义路由

app.get('/stylesheets/style.css', function (req, res, next) {
        res.sendFile(path.join(__dirname, 'public/stylesheets/style.css'));
})

两种方式访问http://localhost:3000/stylesheets/style.css都能得到style.css文件。

静态资源和用户自定义路由是等价的,所以,一般将静态资源处理中间件放在用户自定义中间件前面,避免路由冲突。

如何使用模板(默认使用ejs模板引擎)

// path 为.ejs模板的路径
// data 是给模板传入的值,必须是对象类型
res.render(<path>, [data]);

例如 app.js

app.get('/ejs', function(req, res, next) {
    res.render('index', { title: 'Express' });
});

index.ejs

<h1><%= title %></h1>
<p>test ejs</p>

访问localhost:3000/ejs即可看到结果。 ejs的常用语法如下

1.<% %> 在标签里可以写任意的 javascript 代码,可以把 javascript 代码拆开或者合在一起写,也可以与 html 标签一起写:

<% var a = 1
   var b = 2 
   var c = a+b %>
   // var user = [1,2,3]
   <% for(let i=0; i<user.length; i++) { %>
      <p> html </p>
 <% } %>

2.<%= %> 输出转义后的内容

// ejs
<p><%= '<lol>' %></p>

// 转义后
<p>&lt;lol&gt;</p>

3.<%- %> 输出未转义的内容

 // ejs
<p><%- '<a href="http://www.baidu.com>baidu</a>' %></p>

// 不转义的输出
<p><a href="http://www.baidu.com>baidu</a></p> 

4.<%# %> 注释

5.include 引入其他 ejs 文件,比如引用当前 ejs 文件同级目录下有一个名为 test.ejs 的文件,代码如下:

// exp1
<% var data = 1 %>
<% include ./test %>
// exp2
<%- include('test', {data:1}) %>