深入 Node.js 技术栈 学习笔记

exports 和 module.exports

• 默认情况下，exports 是 module.exports 的引用

• 直接对 exports 赋值会断开两者的关联

• 下面两种用法的效果相同

exports.obj = { foo: 'bar' };
exports.myFunc = () => {};

module.exports = {
	obj: { foo: 'bar' },
	muFunc: () => {}
}

path.join 和 path.resolve

// 当前路径为
/Users/xiao/work/test
path.join('a', 'b', '..', 'd');
// a/d
path.resolve('a', 'b', '..', 'd');
// /Users/xiao/work/test/a/d

webpack alias

const resolve = dir => path.resolve(__dirname, dir);
module.exports = {
	...
	webpack: {
		alias: {
			"@": resolve("src"),
			"components": resolve("src/components")	
		}
	}
}

使用 npx 执行局部命令

全局安装webpack 5.1.3 项目安装webpack 3.6.0

浏览器中的事件循环：事件队列、宏任务微任务

8.Buffer和浏览器的时间循环

https://drive.google.com/drive/folders/1p3YonZMwoy23Ycr2tonPTpI10oavSAwE?usp=sharing

https://odysee.com/@learningdatabase_txkt:9/87882cced9884a9e94497131aef8a6cb:4?lid=4a78c8351062009be0f04ab74ea49e17bb3ea632

Node 中的事件循环

• Node 与浏览器的差异

Node.js 事件循环，定时器和 process.nextTick() | Node.js

Node.js® is a JavaScript runtime built on Chrome's V8 JavaScript engine.

https://nodejs.org/zh-cn/docs/guides/event-loop-timers-and-nexttick

9.(理解)事件循环-发布npm-stream

https://drive.google.com/drive/folders/1p3YonZMwoy23Ycr2tonPTpI10oavSAwE?usp=sharing

https://odysee.com/@learningdatabase_txkt:9/e01fe7c1fc3245829197100351dbc175:f?lid=4a78c8351062009be0f04ab74ea49e17bb3ea632

项目开发习惯

路由与中间件

• 目录结构

src/
	controller/
		user.controller.js
	router/
		user.router.js
	service/
		user.service.js
	middleware/
		user.middleware.js
	...

• user.router.js 只负责注册接口

const Router = require('koa-router');
const {
	create
} = require('../controller/user.controller.js'); // ===> 抽取到单独文件 controller
const {
	verifyUser
} = require('../middleware/user.middleware.js'); // ===> 抽取到单独文件 middleware
const userRouter = new Router({ prefix: "/users" });

// userRouter.post('/', 具体的处理逻辑);
userRouter.post('/create', verifyUser, create);

module.exports = userRouter;

• user.controller.js 编写具体的处理逻辑，可以编写类，new 一个来导出

const service = require('../service/user.service.js');
class UserController {
	async create(ctx, next) {
		// 获取用户请求传递的参数
		...
		// 查询数据 ===> 抽取到单独文件 service
		const result = await service.create(user);	
		// 返回数据
		ctx.body = result;
		// ...
	}
}

module.exports = new UserController();

• user.service.js 中间操作太长，抽离出来

class UserService {
	async create(user) {
		// 将 user 存储到数据库中
	return "创建成功";
	}
}

module.exports = new UserService();

• user.middleware.js 检查前置条件，类似 solidity 的 modifier

const verifyUser = async (ctx, next) => {
	// 获取用户名和密码
	const { name, password } = ctx.request.body;
	// 判断非空，没被注册过，等等
	await next();
}

module.exports = {
	verifyUser,
};

错误处理

• 目录结构

src/
	constants/
		error-types.js
	app/
		index.js
		error-handle.js

• 错误常量 error-types.js

const NAME_OR_PASSWORD_IS_REQUIRED = 'name_or_password_is_required';

module.exports = {
	NAME_OR_PASSWORD_IS_REQUIRED
};

const errorType = require('../constants/error-types');

const verifyUser = async (ctx, next) => {
	// 获取用户名和密码
	const { name, password } = ctx.request.body;
	// 判断非空，没被注册过，等等
	if(!name || !password || name === '' || password === '') {
		const error = new Error(errorType.NAME_OR_PASSWORD_IS_REQUIRED);
		return ctx.app.emit('error', error, ctx); // 返回错误
	}
	await next();
}

• error-handle.js

const errorType = require('../constants/error-types'); 

const errorHandler = (error, ctx) => {
	let status, message;

	switch(error.message) { // 根据错误类型进行处理
		case errorType.NAME_OR_PASSWORD_IS_REQUIRED:
			status = 400; // Bad Request
			message = "用户名和密码不能为空";
			break;
		default: // 默认错误
			status = 404;
			message = "默认错误";
	}
}

module.exports = errorHandler;

• index.js;

// const Koa = require('koa');
// const bodyParser = require('koa-bodyparser');

// const userRouter = require('../router/user.router');
const errorHandler = require('./error-handler.js');

const app = new Koa();

// app.use(bodyParser());
// app.use(userRouter.routes());
// app.use(userRouter.allowedMethods());

app.on('error', errorHandler);

密码处理

• utils/password-handle.js

const crypto = require('crypto');

const md5password = (password) => {
	const md5 = crypto.createHash('md5'); // 创建 Hash 类
	const result = md5.update(password) // 计算生成的哈希
										.digest('hex'); // 若留空，默认返回 Buffer
}

module.exports = md5password;

• middleware/user.middleware.js

const handlePassword = async (ctx, next) => {
	const { password } = ctx.request.body;
	ctx.request.body.password = md5password(password);
	await next();
}

登录凭证

Cookie + Session (Deprecated)

JWT Token 前后端分离