Node.js笔记二

目录

  一 包与npm

（1）介绍

（2）格式化时间的两种作法

 (3)npm 初体验

 （4）包管理配置文件

(4) 解决下包速度慢的问题 

(5)模块的加载机制

二 express

（1）介绍

（2）创建基本的Web服务器

(3)监听Get和Post请求

(4)静态源处理

(5)路由

(6)路由的模块化

  一 包与npm

（1）介绍

定义：Node.js中的第三方模块又叫做包。

搜索 包：https://www.npmjs.com/

下载包：https://registry.npmjs.org/

我们可以使用Node Package Manager (简称npm包管理工具)，从https://registry.npmjs.org/服务器把需要的包下载到本地使用。这个包管理工具随着Node.js的安装包一起被安装到了用户的电脑

可以在终端中执行npm -v命令,来查看自己电脑上所安装的npm包管理工具的版本号

（2）格式化时间的两种作法

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

 (3)npm 初体验

1）初次装包完成后，在项目文件夹下多一个叫做 node.modules的文件夹和1

package-lock.json的配置文件。
其中:
  node_ modules文件夹用来存放所有已安装到项目中的包。require()导入第三方包时，就是 从这个目录中查找并加载包。
  package-lock.json配置文件用来记录node_ modules目录下的每一个包的下载信息,例如包的名字、版本号、下载地址等。

这两个包不用修改其中的代码！！！

  默认情况下，使用npm install 命令安装包的时候，会自动安装最新版本的包。如果需要安装 指定版本的包，可以在包名之后，通过@符号指定具体的版本，例如: .
 npm i moment@2.22.2

  可以一次性安装多个包，包直接用空格隔开，例：

npm i jquery art-template

2）包的语义化版本规范：
包的版本号是以"点分十进制”形式进行定义的，总共有三位数字,例如2.24.0
其中每-位数字所代表的的含义如下: 
第1位数字:大版本
第2位数字:功能版本
第3位数字: Bug修复版本
版本号提升的规则:只要前面的版本号增长了，则后面的版本号归零。

 （4）包管理配置文件

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中移除掉。
 

(4) 解决下包速度慢的问题 

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文件中具体写什么内容,没有强制性的要求;只要能够清晰地把包的作用、用法、注意事项等描述清楚即可。

(5)模块的加载机制

模块在第一次加载后会被缓存。这也意味着多次调用 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

（1）介绍

Express的本质:就是一个npm上的第三方包，提供了快速创建Web服务器的便捷方法。
http内置模块用起来很复杂,开发效率低; Express 是基于内置的http模块进一步封装出来的， 能够极大的提高开发效率。
对于前端程序员来说，最常见的两种服务器，分别是: 
       ●Web 网站服务器:专i ]对外提供Web网页资源的服务器。
        ●API 接口服务器:专门]对外提供API接口的服务器。
使用Express,我们可以方便、快速的创建Web网站的服务器或API接口的服务器。

（2）创建基本的Web服务器

// 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')
})

(3)监听Get和Post请求

通过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)
})

(4)静态源处理

express提供了一个非常好用的函数，叫做express.static(),通过它,我们可以非常方便地创建一个静态资源服务器,
例如，通过如下代码就可以将public目录下的图片、CSS 文件、JavaScript 文件对外开放访问了:

app . use(express.static('public'))

注意: Express 在指定的静态目录中查找文件,并对外提供资源的访问路径。因此，存放静态文件的目录名不会出现在URL中。
如果要托管多个静态资源目录，请多次调用express. static()函数;访问静态资源文件时，express.static()函数会根据目录的添加顺序查找所需的文件。
如果希望在托管的静态资源访问路径之前，挂载路径前缀，则可以使用如下的方式:
app.use(' /public'，express. static(' public' ))

(5)路由

在Express中，路田指的是客户端的请求与服务器处理函数间的映射天系。
Express中的路由分3部分组成，分别是请求的类型、请求的URL地址、处理函数,格式如下

//这里的METHOD可以是get，也可以是post
app.METHOD(PATH,HANDLER)

路由的匹配过程：

每当一个请求到达服务器之后，需要先经过路由的匹配，只有匹配成功之后,才会调用对应的处理函数。
在匹配时，会按照路由的顺序进行匹配，如果请求类型和请求的URL同时四配成功，则Express会将这次请求,转交给对应的function函数进行处理。
路由匹配的注意点:
①按照定义的先后顺序进行匹配
②请求类型和请求的URL同时匹配成功，才会调用对应的处理函数
 

(6)路由的模块化

创建路由模块：

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 )