原文发表于我的,欢迎访问
安装Nodejs
windows
1.打开node()
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 // 全局安装expressnpm install express-generator -g // 全局安装express脚手架,安装之后可以使用express命令express --version // 检查express版本复制代码
生成项目文件
mkdir appcd app/** * 生成项目文件 * express 默认使用ajs模板,加上 -e 指定更友好的ejs模板 */express -enpm 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 IOSexport PORT=4000;// windowsset PORT=4000;复制代码
然后执行npm start
,端口就被设置成了4000.
如何修改运行环境
Express默认的运行环境是development
,运行环境可以通过process.env.NODE_ENV
来获取,将系统环境设置为production
,代码如下:
// ubuntu IOSexport NODE_ENV=production// wondowsset 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使用中间件完成对请求体的改造,或者执行一些中间操作。归根结底,中间件就是一个函数,满足两个条件,
- 有
req
,res
,next
三个参数, - 最后执行
next
函数,将处理权移交出去
写一个打印请求的中间件:
// 定义中间件,打印请求的方法和urlfunction 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(, [data]);复制代码
例如 app.js
app.get('/ejs', function(req, res, next) { res.render('index', { title: 'Express' });});复制代码
index.ejs
<%= title %>
test ejs
复制代码
访问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; ihtml
<% } %>复制代码
2.<%= %> 输出转义后的内容
// ejs<%= '
' %> // 转义后<lol>
复制代码
3.<%- %> 输出未转义的内容
// ejs<%- 'baidu
复制代码
4.<%# %> 注释
5.include 引入其他 ejs 文件,比如引用当前 ejs 文件同级目录下有一个名为 test.ejs 的文件,代码如下:
// exp1<% var data = 1 %><% include ./test %>// exp2<%- include('test', {data:1}) %>复制代码