Node简介
Node 是一个基于 V8 引擎的 Javascript 运行环境,它使得 Javascript 可以运行在服务端,直接与操作系统进行交互,与文件控制、网络交互、进程控制等。
Chrome 浏览器同样是集成了 V8 引擎的 Javascript 运行环境,与 Node 不同的是他们向 Javascript 注入的内容不同,Chrome 向 Javascript 注入了 window 对象,Node 注入的是 global,这使得两者应用场景完全不同,Chrome 的 Javascript 所有指令都需要通过 Chrome 浏览器作为中介实现。
Express 简介
express 是一个轻量级的 Node Web 服务端框架,同样是一个人气超高的项目,它可以帮助我们快速搭建基于 Node 的 Web 应用。
项目初始化
创建项目
➜ code mkdir admin-cloud
➜ code cd admin-cloud
➜ admin-cloud npm init -y
Wrote to /Users/a1/Documents/code/admin-cloud/package.json:
{
"name": "admin-cloud",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"keywords": [],
"author": "",
"license": "ISC"
}
➜ admin-cloud
安装依赖
➜ admin-cloud npm i -S express
npm notice created a lockfile as package-lock.json. You should commit this file.
npm WARN [email protected] No description
npm WARN [email protected] No repository field.
+ [email protected]
added 50 packages from 37 contributors in 3.931s
╭────────────────────────────────────────────────────────────────╮
│ │
│ New minor version of npm available! 6.9.0 → 6.14.5 │
│ Changelog: https://github.com/npm/cli/releases/tag/v6.14.5 │
│ Run npm install -g npm to update! │
│ │
╰────────────────────────────────────────────────────────────────╯
➜ admin-cloud
创建 app.js
const express = require('express')
// 创建 express 应用
const app = express()
// 监听 / 路径的 get 请求
app.get('/', function(req, res) {
res.send('hello world node')
})
// 使 express 监听 8000 端口号发起的 http 请求
const server = app.listen(8000, function() {
const { address, port } = server.address()
console.log('Http Server is running on http://%s:%s', address, port)
})
Express 三大基础概念
中间件
中间件是一个函数,在请求和响应周期中被顺序调用。
const myLogger = function(req, res, next) {
console.log('myLogger')
next()
}
app.use(myLogger)
提示:中间件需要在响应结束前被调用。
路由
应用如何响应请求的一种规则。
响应 / 路径的 get 请求:
app.get('/', function(req, res) {
res.send('hello world node')
})
响应 / 路径的 post 请求:
app.post('/', function(req, res) {
res.send('hello world node')
})
规则主要分两部分:
- 请求方法:get、post......
- 请求的路径:/、/servers、/.*net$/......
异常处理
通过自定义异常处理中间件处理请求中产生的异常。
app.get('/', function(req, res) {
throw new Error('something has error...')
})
const errorHandler = function (err, req, res, next) {
console.log('errorHandler...')
res.status(500)
res.send('down...')
}
app.use(errorHandler)
使用时需要注意两点:
- 第一,参数一个不能少,否则会视为普通的中间件。
- 第二,中间件需要在请求之后引用。
项目框架搭建
路由
安装 boom 依赖(帮助我们快速的生成一些异常信息):
➜ admin-cloud npm i -S boom
npm WARN deprecated [email protected]: This module has moved and is now available at @hapi/boom. Please update your dependencies as this version is no longer maintained an may contain bugs and security issues.
npm WARN deprecated [email protected]: This module has moved and is now available at @hapi/hoek. Please update your dependencies as this version is no longer maintained an may contain bugs and security issues.
npm WARN [email protected] No description
npm WARN [email protected] No repository field.
+ [email protected]
added 2 packages in 2.164s
➜ admin-cloud
创建 router 文件夹,创建 router/index.js:
const express = require('express')
const boom = require('boom')
const serverRouter = require('./server')
const {
CODE_ERROR
} = require('../utils/constant')
// 注册路由
const router = express.Router()
router.get('/', function(req, res) {
res.send('欢迎使用云平台服务')
})
// 通过 serverRouter 来处理 /server 路由,对路由处理进行解耦
router.use('/server', serverRouter)
/**
* 集中处理404请求的中间件
* 注意:该中间件必须放在正常处理流程之后
* 否则,会拦截正常请求
*/
router.use((req, res, next) => {
next(boom.notFound('接口不存在'))
})
/**
* 自定义路由异常处理中间件
* 注意两点:
* 第一,方法的参数不能减少
* 第二,方法的必须放在路由最后
*/
router.use((err, req, res, next) => {
const msg = (err && err.message) || '系统错误'
const statusCode = (err.output && err.output.statusCode) || 500;
const errorMsg = (err.output && err.output.payload && err.output.payload.error) || err.message
res.status(statusCode).json({
code: CODE_ERROR,
msg,
error: statusCode,
errorMsg
})
})
module.exports = router
创建 router/server.js:
const express = require('express')
const router = express.Router()
router.get('/info', function(req, res, next) {
res.json('server info...')
})
module.exports = router
创建 utils/constant.js:
module.exports = {
CODE_ERROR: -1
}
修改 app.js,将router作为中间件使用,提高代码的灵活性,松耦合处理
const express = require('express')
const router = require('./router')
// 创建 express 应用
const app = express()
// 将router作为中间件使用
app.use('/', router)
// 使 express 监听 8000 端口号发起的 http 请求
const server = app.listen(8000, function() {
const { address, port } = server.address()
console.log('Http Server is running on http://%s:%s', address, port)
})
启动服务
➜ admin-cloud node app.js
Http Server is running on http://:::8000
浏览器输入:http://localhost:8000/
至此,基础服务环境搭建完成!!!