Express 框架
Web 应用程序
Express 是一个保持最小规模的灵活的 Node.js Web 应用程序开发框架,为 Web 和移动应用程序提供一组强大的功能。
API
使用您所选择的各种 HTTP 实用工具和中间件,快速方便地创建强大的 API。
性能
Express 提供精简的基本 Web 应用程序功能,而不会隐藏您了解和青睐的 Node.js 功能。
Express- 路由基本使用
下载:npm install express –save
Hello world
新建一个 server.js 文件,然后输入:
const express = require(‘express’);
const app= express();
app.get(‘/’, (req, res)=>{
req.send(‘Hello world’);
});
app.listen(8083, ()=>{
console.log(‘Server is running at http://localhost:8083’)
})
然后运行:node server.js 打开:http://localhost:8083/ 就出现:
请求和响应
Express 应用使用回调函数的参数:request 和 response 对象来处理请求和响应的数据。
app.get(‘/’, function (request, response) {
// —
})
request 和 response 对象的具体介绍:
Request 对象
request 对象表示 HTTP 请求,包含了请求查询字符串,参数,内容,HTTP 头部等属性。常见属性有:
req.app:当 callback 为外部文件时,用 req.app 访问 express 的实例 req.baseUrl:获取路由当前安装的 URL 路径 req.body / req.cookies:获得「请求主体」/ Cookiesreq.fresh / req.stale:判断请求是否还「新鲜」req.hostname / req.ip:获取主机名和 IP 地址 req.originalUrl:获取原始请求 URLreq.params:获取路由的 parametersreq.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 类型
Response 对象
response 对象表示 HTTP 响应,即在接收到请求时向客户端发送的 HTTP 响应数据。常见属性有:
res.app:同 req.app 一样 res.append():追加指定 HTTP 头 res.set()在 res.append()后将重置之前设置的头 res.cookie(name,value [,option]):设置 Cookieopition: domain / expires / httpOnly / maxAge / path / secure / signedres.clearCookie():清除 Cookieres.download():传送指定路径的文件 res.get():返回指定的 HTTP 头 res.json():传送 JSON 响应 res.jsonp():传送 JSONP 响应 res.location():只设置响应的 Location HTTP 头,不设置状态码或者 close responseres.redirect():设置响应的 Location HTTP 头,并且设置状态码 302res.render(view,[locals],callback):渲染一个 view,同时向 callback 传递渲染后的字符串,如果在渲染过程中有错误发生 next(err)将会被自动调用。callback 将会被传入一个可能发生的错误以及渲染后的页面,这样就不会自动输出了。res.send():传送 HTTP 响应 res.sendFile(path [,options] [,fn]):传送指定路径的文件 - 会自动根据文件 extension 设定 Content-Typeres.set():设置 HTTP 头,传入 object 可以一次设置多个头 res.status():设置 HTTP 状态码 res.type():设置 Content-Type 的 MIME 类型
Express- 路由
我们已经了解了 HTTP 请求的基本应用,而路由决定了由谁 (指定脚本) 去响应客户端请求。在 HTTP 请求中,我们可以通过路由提取出请求的 URL 以及 GET/POST 参数。
路由的基本形式:app.METHOD(PATH, HANDLER)
app 表示的是一个 Express 的实例
METHOD 是 http 请求的方法(get, psot..)
PATH 服务器上的路径
HANDLER 请求之后的执行函数
下面的示例说明了如何定义路由:
// 对 /news 页面进行 get 请求
app.get(‘news’, (req, res)=>{
res.send(‘Hello news’);
});
// 对 /about 页面进行 post 请求
app.post(‘about’, (req, res)=>{
res.send(‘Hello about’);
});
// 对 /list* 可匹配 /list+ 任意字符
app.get(‘/list*’, (req, res)=>{
res.send(‘Hello list pages’);
})
然后运行:node server.js 打开:http://localhost:8083/
Express- 搭建静态资源库
Express 提供了内置的中间件 express.static 来设置静态文件如:图片,CSS, JavaScript 等。
你可以使用 express.static 中间件来设置静态文件路径。例如,如果你将图片,CSS, JavaScript 文件放在 public 目录下,你可以这么写:app.use(express.static(‘public’));
现在,你就可以访问 public 目录中的所有文件了:
public/index.html
public/images
public/images/bg.jpeg
public/css
…
如果要使用多个静态资源目录,请多次调用 express.static 中间件函数:
app.use(express.static(‘public’))
app.use(express.static(‘files’))
Express 在静态目录查找文件,因此,存放静态文件的目录名不会出现在 URL 中。但是您可以给静态目录添加一个路由:app.use(‘/static’, express.static(path.join(__dirname, ‘public’)))设置 /static 为 /public 目录的路由。现在,你就可以通过带有 /static 前缀地址来访问 public 目录中的文件了。
http://localhost:8083/static/css
http://localhost:8083/static/css/index.css
http://localhost:8083/static/image
http://localhost:8083/static/images/bg.jpeg
http://localhost:8083/static/index.html
为了安全,最好使用绝对路由:app.use(‘/static’, express.static(path.join(__dirname, ‘public’)))然后运行:node server.js 打开:http://localhost:8083/static 就可以访问 public 下的所有文件,如图:
Express- 模板引擎之 EJS
EJS 是一套简单的模板语言,帮你利用普通的 JavaScript 代码生成 HTML 页面。
下载 Ejs: npm install ejs –save 同目录下新建 myejs.js:
const express= require(‘express’);
const app = express();
// 设置模板文件的目录, 并且新建一个 viwes 的目录
app.set(‘views’, ‘./views’);
// 注册模板引擎
app.set(‘view engine’, ‘ejs’);
// 使用 res.render()来渲染一个视图并将呈现的 HTML 字符串发送给客户端;
app.get(‘/’, function(req, res,) {
res.render(‘index’, { title: ‘ 测试 ’});
});
// 监听 8083 端口
app.listen(8083, ()=>{
console.log(‘Server is running at http://localhost:8083’)
})
在新建 views 目录中新建 index.ejs:
<h1><%= title %></h1>
然后运行:node myejs.js 打开:http://localhost:8083 即可看到:
当然,也可以返回一个 json 文件来渲染视图:在同目录下新建一个 data.json:
{
“list”: [
{“name”:” 小明 ” , “age”:”6″, “sex”: “ 男 ”},
{“name”:” 小红 ” , “age”:”4″ ,”sex”: “ 女 ”},
{“name”:” 小亮 ” , “age”:”5″ ,”sex”: “ 男 ”}
],
“source”:” 神奇二班 ”
}
然后更改 myejs.js:
const express= require(‘express’);
const fs= require(‘fs’);
const app = express();
// 设置模板文件的目录, 并且新建一个 viwes 的目录
app.set(‘views’, ‘./views’);
// 注册模板引擎
app.set(‘view engine’, ‘ejs’);
// 使用 res.render()来渲染一个视图并将呈现的 HTML 字符串发送给客户端;
app.get(‘/’, function(req, res,) {
getDataJson((dataJson)=>{
console.log(dataJson);
res.render(‘index’, dataJson);
})
});
// 访问 data.json 拿到数据解析并返回
const getDataJson=(callBack)=>{
fs.readFile(‘./data.json’, (err, data)=>{
if(!err){
let jsonData= JSON.parse(data);
callBack(jsonData);
}else{
throw err;
}
})
}
// 监听 8083 端口
app.listen(8083, ()=>{
console.log(‘Server is running at http://localhost:8083’)
})
然后更改 index.ejs:
<h4><%=source %></h4>
<ul>
<% for(var i=0; i<list.length; i++){%>
<li><%= list[i].name %> | <%= list[i].age %> | <%= list[i].sex %></li>
<% } %>
</ul>
然后在运行:然后运行:node myejs.js 打开:http://localhost:8083
参考:GitHub 源码 Express 官方文档 EJS 模板引擎