目录
一 包与npm
(1)介绍
(2)格式化时间的两种作法
(3)npm 初体验
(4)包管理配置文件
(4) 解决下包速度慢的问题
(5)模块的加载机制
二 express
(1)介绍
(2)创建基本的Web服务器
(3)监听Get和Post请求
(4)静态源处理
(5)路由
(6)路由的模块化
定义:Node.js中的第三方模块又叫做包。
搜索 包:https://www.npmjs.com/
下载包:https://registry.npmjs.org/
我们可以使用Node Package Manager (简称npm包管理工具),从https://registry.npmjs.org/服务器把需要的包下载到本地使用。这个包管理工具随着Node.js的安装包一起被安装到了用户的电脑
可以在终端中执行npm -v命令,来查看自己电脑上所安装的npm包管理工具的版本号
1)传统做法
①创建格式化时间的自定义模块
②定义格式化时间的方法
③创建补零函数
④从自定义模块中导出格式化时间的函数
⑤导入格式化时间的自定义模块
dateFormat.js:
//1.定义格式化时间的自定义模块
function dateFormat(dtStr){
const dt=new Date(dtStr)
const y=dt.getFullYear()
const m=padZero(dt.getMonth()+1)
const d=padZero(dt.getDate())
const hh=padZero(dt.getHours())
const mm=padZero(dt.getMinutes())
const ss=padZero(dt.getSeconds())
return `${y}-${m}-${d} ${hh}-${mm}-${ss}`
}
//定义补零的整数
function padZero(n){
return n>9?n:'0'+n
}
//从自定义模块中导出格式化时间的函数
module.exports={
dateFormat
}
//导入自定义的格式化时间的模块
const TIME=require('./dateFormat.js')
//调用方法,进行时间的格式化
const dt=new Date()
//console.log(dt)
const newDT=TIME.dateFormat(dt)
console.log(newDT)
2)格式化时间的高级做法
①使用npm包管理工具,在项目中安装格式化时间的包moment
②使用require()导入格式化时间的包
③参考moment的官方API文档对时间进行格式化
//导入moment包
const moment=require('moment')
//2.参考moment 官方API文档,调用对应的方法,对时间进行格式化
//2.1调用moment() 方法,得到当前的时间
//2.2针对当前的时间,调用format() 方法,按照指定的格式进行时间的格式化
const dt=moment().format('YYYY-MM-DD HH:mm:ss')
console.log(dt)//2022-07-14 21:50:02
1)初次装包完成后,在项目文件夹下多一个叫做 node.modules的文件夹和1
package-lock.json的配置文件。
其中:
node_ modules文件夹用来存放所有已安装到项目中的包。require()导入第三方包时,就是 从这个目录中查找并加载包。
package-lock.json配置文件用来记录node_ modules目录下的每一个包的下载信息,例如包的名字、版本号、下载地址等。这两个包不用修改其中的代码!!!
默认情况下,使用npm install 命令安装包的时候,会自动安装最新版本的包。如果需要安装 指定版本的包,可以在包名之后,通过@符号指定具体的版本,例如: .
npm i [email protected]可以一次性安装多个包,包直接用空格隔开,例:
npm i jquery art-template
2)包的语义化版本规范:
包的版本号是以"点分十进制”形式进行定义的,总共有三位数字,例如2.24.0
其中每-位数字所代表的的含义如下:
第1位数字:大版本
第2位数字:功能版本
第3位数字: Bug修复版本
版本号提升的规则:只要前面的版本号增长了,则后面的版本号归零。
npm规定,在项目根目录中,必须提供一个叫做 package.json的包管理配置文件。来记录与项目有关的一些配置
信息。例如:
●项目的名称、版本号、描述等
●项目中都用到了哪些包
●哪些包只在开发期间会用到
●那些包在开发和部署时都需要用到
在项目根目录中,创建-个叫做package.json的配置文件,即可用来记录项目中安装了哪些包。从而方便剔除node_ modules目录之后,在团队成员之间共享项目的源代码。
注意:今后在项目开发中,一定要把 node_ modules文件夹,添加到.gitignore 忽略文件中。
npm包管理工具提供了一个快捷命令,可以在执行命令时所处的目录中,快速创建package.json这个包管理
//在执行命令所处的目录中,快速新建package. json 文件 npm init -y
注意:
①上述命令只能在英文的目录下成功运行!所以,项目文件夹的名称一定要使用英文命名, 不要使用中文,不能出现空格。
②运行npm install命令安装包的时候,npm包管理工具会自动把包的名称和版本号,记录到package.json中。(我们不需要手动修改package.json包信息)
package.json文件中,有一个dependencies节点,专]用来记录您使用npm install
命令安装了哪些包。如果某些包只在项目开发阶段会用到,在项目上线之后不会用到,则建议把这些包记录到devDependencies节点中。
与之对应的,如果某些包在开发和项目//安装指定的包,并记录到devDependencies 节点中 npm i 包名 -D //注意:上述命令是简写形式,等价于下面完整的写法: npm install 包名--save-dev
上线之后都需要用到,则建议把这些包记录到dependencies节点中。
当我们拿到一个剔除了node_ modules的项目之后,需要先把所有的包下载到项目中,才能将项目运行起
否则会报类似于下面的错误:
//由于项目运行依赖于moment 这个包,如果没有提前安装好这个包,就会报如下的错误: Error: Cannot find module 'moment'
一次性安装所有的包:
可以运行npm install命令(或npm i)-次性安装所有的依赖包://执行npm install命令时,npm包管理工具会先读取package. json 中的dependencies 节点, //读取到记录的所有依赖包名称和版本号之后,npm包管理工具会把这些包一 次性下载到项目中 npm install
可以运行npm uninstall命令,来卸载指定的包注意: npm uninstall命令执行成功后,会把卸载的包,自动从package json的dependencies中移除掉。
1)下包速度慢的原因:在使用npm下包的时候,默认从国外的https://regitry.npmjs.org/服务器进行下载,此时,网络数据的传输需要经过漫长的海底光缆,因此下包速度会很慢。
2)镜像是一种文件存储形式,一个磁盘上的数据在另一个磁盘上存在一 个完全相同的副本即为镜像。
3)切换npm的下包镜像源
下包的镜像源,指的就是下包的服务器地址。
//查看当前的下包镜像源
npm config get registry
//将下包的镜像源切换为淘宝镜像源
npm config set registry=https://registry .npm. taobao.org/
//检查镜像源是否下载成功
npm config get registry
4)nrm
为了更方便的切换下包的镜像源,我们可以安装nrm这个小工具,利用nrm提供的终端命令,可以快速查看和切换下包的镜像源。
//通过npm包管理器,将nrm安装为全局可用的工具
npm i nrm -g
//查看所有可用的镜像源
nrm ls
//将下包的镜像源切换为taobao 镜像
nrm use taobao
5)包的分类及结构
包分为项目包和全局包
那些被安装到项目的node. modules目录中的包,都是项目包。
项目包又分为两类,分别是:
●开发依赖包 (被记录到devDependencies节点中的包,只在开发期间会用到)
●核心依赖包(被记录到dependencies节点中的包,在开发期间和项目.上线之后都会用到)
全局:在执行npm install 命令时,如果提供了-g参数,则会把包安装为全局包。
npmi 包名 -g //全局安装指定的包
npm uninstall 包名 -g //卸载全局安装的包
注意:
①只有工具性质的包(如nrm),才有全局安装的必要性。因为它们提供了好用的终端命令。
②判断某个包是否需要全局安装后才能使用,可以参考官方提供的使用说明即可。
输入 npm root -g就可以查看全局包的安装位置
-------------------------------------------------------------------------------------------------------------------------
i5ting_ toc 是一个可以把md文档转为html页面的小具,使用步骤如下:
//将i5ting toc安装为全局包
npm install -g i5ting _toc
//调用i5ting_toc, 轻松实现md转html的功能
i5ting_toc -f 要转换的md文件路径 -o
--------------------------------------------------------------------------------------------------------------------------------一个规范的包,它的组成结构,必须符合以下3点要求:
①包必须以单独的目录而存在
②包的顶级目录下要必须包含package.json这个包管理配置文件
③package.json 中必须包含name, version, main 这三个属性,分别代表包的名字、版本号、包的入口。
-----------------------------------------------------------------------------------------------------------------------------
包根目录中的README.md文件,是包的使用说明文档。通过它,我们可以事先把包的使用说明,以markdown的格式写出来,方便用户参考。README文件中具体写什么内容,没有强制性的要求;只要能够清晰地把包的作用、用法、注意事项等描述清楚即可。
模块在第一次加载后会被缓存。这也意味着多次调用 require0不会导致模块的代码被执行多次。
注意:不论是内置模块、用户自定义模块、还是第三方模块,它们都会优先从缓存中加载,从而提高模块的加载效率。
1)内置模块的加载机制
内置模块是由Node.js官方提供的模块,内置模块的加载优先级最高。
例如,require("fs") 始终返回内置的fs模块,即使在node_ modules 目录下有名字相同的包也叫fs。
2)自定义模块的加载机制
使用require()加载自定义模块时,必须指定以./或./开头的路径标识符。在加载自定义模块时,如果没有指定./或../这样的路径标识符,则node会把它当作内置模块或第三方模块进行加载。
同时,在使用require()导入自定义模块时,如果省略了文件的扩展名,则Node.js会按顺序分别尝试加载以下的文件:
①按照确切的文件名进行加载
②补全js扩展名进行加载
③补全json扩展名进行加载
④补全.node扩展名进行加载
⑤加载失败,终端报错
3)第三方模块的加载机制
如果传递给require0的模块标识符不是一个内置模块, 也没有以'./' 或../.’ 开头, 则Node,js会从当前模块的父目录开始,尝试从/node modules文件夹中加载第三方模块。
如果没有找到对应的第三方模块,则移动到再上一层父目录中,进行加载,直到文件系统的根目录。
4)目录作为模块
当把目录作为模块标识符,传递给require()进行加载的时候,有三种加载方式:
①在被加载的目录下查找一个叫做package.json的文件,并寻找main属性,作为require0加载的入口
②如果目录里没有package.json 文件,或者main入口不存在或无法解析,则Node.js将会试图加载目录下的index.js文件。
③如果以上两步都失败了,则Node.js会在终端打印错误消息,报告模块的缺失: Error: Cannot find module 'xx'
Express的本质:就是一个npm上的第三方包,提供了快速创建Web服务器的便捷方法。
http内置模块用起来很复杂,开发效率低; Express 是基于内置的http模块进一步封装出来的, 能够极大的提高开发效率。
对于前端程序员来说,最常见的两种服务器,分别是:
●Web 网站服务器:专i ]对外提供Web网页资源的服务器。
●API 接口服务器:专门]对外提供API接口的服务器。
使用Express,我们可以方便、快速的创建Web网站的服务器或API接口的服务器。
// 1.导入express
const express = require( 'express' )
// 2.创建web服务器
const app = express()
// 3.调用app.listen(端口号, 启动成功后的回调函数) ,启动服务器
app.listen(80,() => {
console. log( 'express server running at http://127.0.0.1')
})
通过app.get()方法,可以监听客户端的GET请求,具体的语法格式如下:
//参数1:客户端请求的URL地址
//参数2:请求对应的处理函数
//req:请求对象(包含了与请求相关的属性与方法)
//res:响应对象(包含了与响应相关的属性与方法)
app. get( '请求URL' , function(req, res) { /*处理函数*/ })
通过app.post0方法,可以监听客户端的POST请求,具体的语法格式如下:
//参数1:客户端请求的URL地址
//参数2:请求对应的处理函数
//req:请求对象(包含了与请求相关的属性与方法)
//res:响应对象(包含了与响应相关的属性与方法)
app. post( '请求URL',function(req, res) { /*处理函数*/ })
通过res. send()方法(既可以向客户端相应JSON对象又可以响应一个文本字符串)可以把处理好的内容,发送给客户端,
通过req.query对象,可以访问到客户端通过查询字符串的形式,发送到服务器的参数:
app.get('/', (req, res) =
// req .query 默认是一一个空对象
/客户端使用?name=zs&age=20 这种查询字符串形式,发送到服务器的参数,,
//可以通过req. query对象访问到,例如:
/ req.query.name
req.query.age
console.log(req.query)
})
通过req.params对象,可以访问到URL中,通过:匹配到的动态参数:
// URL地址中,可以通过:参数名的形式,匹配动态参数值
app.get('/user/:id', (req, res) => {
// req.params 默认是一 个空对象
//里面存放着通过:动态匹配到的参数值
console.log( req.params)
})
express提供了一个非常好用的函数,叫做express.static(),通过它,我们可以非常方便地创建一个静态资源服务器,
例如,通过如下代码就可以将public目录下的图片、CSS 文件、JavaScript 文件对外开放访问了:
app . use(express.static('public'))
注意: Express 在指定的静态目录中查找文件,并对外提供资源的访问路径。因此,存放静态文件的目录名不会出现在URL中。
如果要托管多个静态资源目录,请多次调用express. static()函数;访问静态资源文件时,express.static()函数会根据目录的添加顺序查找所需的文件。
如果希望在托管的静态资源访问路径之前,挂载路径前缀,则可以使用如下的方式:
app.use(' /public',express. static(' public' ))
在Express中,路田指的是客户端的请求与服务器处理函数间的映射天系。
Express中的路由分3部分组成,分别是请求的类型、请求的URL地址、处理函数,格式如下
//这里的METHOD可以是get,也可以是post
app.METHOD(PATH,HANDLER)
路由的匹配过程:
每当一个请求到达服务器之后,需要先经过路由的匹配,只有匹配成功之后,才会调用对应的处理函数。
在匹配时,会按照路由的顺序进行匹配,如果请求类型和请求的URL同时四配成功,则Express会将这次请求,转交给对应的function函数进行处理。
路由匹配的注意点:
①按照定义的先后顺序进行匹配
②请求类型和请求的URL同时匹配成功,才会调用对应的处理函数
创建路由模块:
var express = require('express')// 1.导入express
var router = express . Router()// 2.创建路由对象
router . get( ' /user/list', function (req, res) { // 3.挂载获取用户列表的路由
res. send( 'Get user list. ' )
})
router . post( ' /user/add', function (req, res) { // 4.挂载添加用户的路由
res。send('Add new user.")
})
module.exports = router // 5.向外导出路由对象
注册路由模块:
// 1.导入路由模块
const userRouter = require(自定义模块 )
//2.使用app.use() 注册路由模块
app . use(userRouter )
//3. 使用app.use() 注册路由模块,并添加统的访问前缀/api
app.use( '/api',userRouter )