nodejs框架 express koa介绍以及从零搭建 koa 模板

这篇具有很好参考价值的文章主要介绍了nodejs框架 express koa介绍以及从零搭建 koa 模板。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

express

下载

npm install express

搭建服务

const express = require("express");

const app = express();

app.get("/home", (req, res) => {
	res.send("home");
});

app.listen(3000, () => {
	console.log("http://127.0.0.1:3000");
});

restful api

操作 请求类型 url 返回
获取所有 GET /users
获取单个 GET /users/1
新增 POST /users
修改部分 PATCH /users/1
修改全部 PUT /users/1
删除 DELETE /users/1

路由

一个路由由 请求方法 路径 和 回调函数组成

app.get("/users", (req, res) => {
	res.send("get users");
});

app.post("/users", (req, res) => {
	res.send("post users");
});

app.delete("/users", (req, res) => {
	res.send("delete users");
});

app.put("/users", (req, res) => {
	res.send("put users");
});

app.patch("/users", (req, res) => {
	res.send("patch users");
});

匹配 404 路由

app.all("*", (req, res) => {
	res.send("404 not found");
});

获取请求报文参数

// /users?a=1&b=2
app.get("/users", (req, res) => {
	// /users
	console.log(req.path);
	// { a: '1', b: '2' }
	console.log(req.query);
	// 获取请求头信息
	console.log(req.get("User-Agent"));
});

获取动态路由参数

app.get("/users/:id", (req, res) => {
	console.log("id", req.params.id);
	res.send("get users");
});

获取 post 请求体参数
下载

npm i body-parser
// 引包
const bodyParser = require("body-parser");

// 配置
// 解析 querystring 格式请求体
app.use(bodyParser.urlencoded({ extecded: false }));
// 解析 json 格式请求体
app.use(bodyParser.json());

app.post("/users", (req, res) => {
	console.log(req.body);
});

响应

app.get("/users/:id", (req, res) => {
	// 设置状态码
	res.status(200);
	// 设置响应头
	res.set("abc", "abc");
	// 返回字符串
	res.send("get users");
	// 返回 json 数据
	res.json({
		data: "123",
	});
	// 重定向
	res.redirect("http://www.baidu.com");
	// 下载响应
	res.download("./test.txt");
	// 响应文件内容
	res.sendFile("./test.html");
});

中间件 Middleware

中间件本质是一个回调函数,可以像路由回调一样访问请求对象request 响应对象 response

中间件的作用是:使用函数封装公共操作,简化代码

全局中间件

// 声明中间件
function customMiddleware(req, res, next) {
	console.log("全局中间件使用了");
	// 必须调用
	next();
}

// 使用
app.use(customMiddleware);

路由中间件

// 声明中间件
function customMiddleware(req, res, next) {
	console.log("路由中间件使用了");
	next();
}

// 使用
app.get("/users", customMiddleware, (req, res) => {
	res.send("get user");
});

// 多个中间件使用
app.get("/users", customMiddleware, customMiddleware2, (req, res) => {
	res.send("get user");
});

静态资源

app.use(express.static(path.join(__dirname, '../public')));

// public 文件夹路径可省略不写如下
http://127.0.0.1:3000/mn.png

防盗链 referer

function customMiddleware(req, res, next) {
	const referer = req.get("referer");
	next();
}

文件上传 formidable

下载

npm install formidable@v2

使用

const formidable = require("formidable");

router.post("/upload", function (req, res, next) {
	const form = formidable({
		multiples: true,
		// 设置上传文件的保存目录
		uploadDir: path.join(__dirname, "../public/images"),
		// 保存文件后缀
		keepExtensions: true,
	});
	form.parse(req, (err, fields, files) => {
		if (err) {
			next(err);
			return;
		}
		res.json({ fields, files });
	});
});

koa

下载

npm install koa

使用

const Koa = require("koa");

const app = new Koa();

app.listen(3000, () => {
	console.log(`http://127.0.0.1:3000`);
});

获取 get 请求体参数

ctx.request.query

获取动态路由参数

ctx.params?.id

@koa/router 路由

下载

npm install @koa/router

使用

const Router = require("@koa/router");

const router = new Router();

// 设置路由前缀
// const router = new Router({ prefix: "/users" });

router.get("/", (ctx) => {
	ctx.body = {
		code: 0,
	};
});

app.use(router.routes());

koa-body

获取 post 请求体参数
下载

npm install koa-body

使用

const { koaBody } = require("koa-body");

app.use(koaBody());

获取 post 请求体参数

ctx.request.body

koa-static

配置静态资源

下载

npm install koa-static

使用

const path = require("node:path");
const static = require("koa-static");

app.use(static(path.join(__dirname, "../public")));
// http://127.0.0.1:3000/images/test.jpg

npm install koa-views ejs

引入模板文件
下载

npm install koa-views ejs

使用

const views = require("koa-views");
// 此时文件后缀为  .ejs
// app.use(views(path.join(__dirname, "../views"), { extension: "ejs" }));
// 把文件后缀替换为 .html
app.use(views(path.join(__dirname, "../views"), { map: { html: "ejs" } }));

router.get("/", async (ctx) => {
	let title = "你好ejs";
	let list = ["哈哈", "嘻嘻", "看看", "问问"];
	let content = "<h2>这是一个h2</h2>";
	let num = 10;
	await ctx.render("index", {
		title,
		list,
		content,
		num,
	});
});

模板

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>

<body>
    <h1>普通模版</h1>
    <h1>ejs循环输出模版</h1>
    <ul>
        <%for(var i=0;i<list.length;i++){%>
            <li>
                <%= list[i] %>
            </li>
        <%}%>
    </ul>
    <h2>原文输出标签</h2>
    <%- content %>
        <h2>条件判断</h2>
        <% if(num> 20){ %>
            大于20
        <% }else{ %>
            小于20
        <% }
    %>
</body>

</html>

formidable 文件上传

下载

npm install formidable@v2

使用

const path = require("node:path");
const formidable = require("formidable");

router.post("/", async (ctx, next) => {
	const form = formidable({
		multiples: true,
		// 设置上传文件的保存目录
		uploadDir: path.join(__dirname, "../public/uploads"),
		// 保存文件后缀
		keepExtensions: true,
		// 修改文件名 必须返回一个字符串即:新的存储文件名称
		filename: (name, ext, part, form) => {
			return `ttttt${ext}`;
		},
	});

	await new Promise((resolve, reject) => {
		form.parse(ctx.req, (err, fields, files) => {
			if (err) return reject(err);
			// files.file file就是前端上传的字段名称
			ctx.body = { fields, files: files.file };
			resolve();
		});
	});

	return await next();
});

async-validator 数据校验

下载

npm i async-validator

两种模块化使用方式

es6

import Schema from "async-validator";

const descriptor = {
  age: {
    type: "number",
    required: true,
    message: "年龄必填",
  },
};

const validator = new Schema(descriptor);
const values = await validator.validate({ age });

commonjs

const Schema = require("async-validator");

const descriptor = {
  age: {
    type: "number",
    required: true,
    message: "年龄必填",
  },
};

const validator = new Schema.default(descriptor);
const values = await validator.validate({ age });

其他常用校验

const Schema = require("async-validator");

async create(ctx) {
	try{
  		let { name, age, sex } = ctx.request.body;
 	 	//  参数检验
      	const descriptor = {
			name: [
				{
					// 类型
					type: "string",
					// 必填
					required: true,
					// 长度(姓名三个字)
					// len: 3,
					// 范围(姓名3-5个字)
					min: 3,
					max: 5,
					// 提示信息
					message: "姓名3-5个字",
				},
				{
					// 自定义校验函数
					validator: (rule, value) => value.includes("xr"), message: "姓名必须包含xr" },
			],
			age: {
				type: "number",
				required: true,
				// 正则
				pattern: /^[0-9]+$/,
				// 验证前执行的函数:去除空格
				transform(value) {
					return value.trim();
				},
				message: "年龄必填",
			},
			sex: {
				type: "enum",
				enum: [1, 2],
				required: true,
				message: "性别错误",
			},
      };
      const validator = new Schema.default(descriptor);
      const values = await validator.validate({ name, age, sex });
	}catch(error){
  		const msg = error?.errors[0]?.message;
	}
}

错误处理 koa-json-error

下载

npm install --save koa-json-error

使用

const error = require("koa-json-error");

const app = new Koa();
app.use(error());

cross-env 设置环境变量

下载

npm install --save-dev cross-env

配置变量
package.json

// cross-env NODE_ENV=dev NODE_TEST=true
{
	"scripts": {
		"test": "echo \"Error: no test specified\" && exit 1",
		"dev": "cross-env NODE_ENV=dev NODE_TEST=true nodemon ./src/main.js "
	},
}

获取值

// dev true string
console.log(process.env.NODE_ENV, process.env.NODE_TEST, typeof process.env.NODE_TEST);

dotenv

从 .env 为 nodejs 项目加载环境变量。

下载

npm install dotenv --save

配置使用
在项目的根目录中创建一个 .env 文件
.env

NODE_PORT = 3000;
const path = require("path");
// 添加到 process.env 中,默认获取 .env 文件
require("dotenv").config();

// 获取 .env.dev 文件
require("dotenv").config({ path: path.resolve(process.cwd(), ".env.dev") });

// 3000
console.log(process.env.NODE_PORT);

jsonwebtoken

下载

npm install jsonwebtoken

生成 token

const jwt = require("jsonwebtoken");
const token = jwt.sign(payload, JWTSECRET, { expiresIn: 60 * 60 * 24 });

验证 token

jwt.verify(token, JWTSECRET);

报错 Expected “payload” to be a plain object.(翻译结果为:“payload”应为纯对象。)

返回的不是纯对象 == res._doc

const res = await UserModel.create(body);
const token = jwt.sign(res._doc, JWTSECRET, { expiresIn: 60 * 60 * 24 });

bcryptjs

下载

npm install bcryptjs

使用

/**
 * 加密
 * @param {*} val
 * @returns
 */
const crpytPassword = (val) => {
	const salt = bcrypt.genSaltSync(10);
	const hash = bcrypt.hashSync(val, salt);
	return hash;
};

/**
 * 解密验证
 * @param {*} val 原始值
 * @param {*} hash 加密后的值
 * @returns
 */
const checkPassword = (val, hash) => {
	return bcrypt.compareSync(val, hash);
};

pm2 负载均衡

下载

npm install pm2@latest -g

查看版本

pm2 - v;

启动

pm2 start app.js

// --watch 监听
pm2 start app.js --watch

// --name 别名
pm2 start app.js --name test

重载(不关闭)和重启(瞬间关闭开启)

pm2 reload app.js
pm2 reload all

pm2 restart app.js
pm2 restart all

从 pm2 中关闭


pm2 stop id值

// 例
pm2 stop 0
pm2 stop all

从 pm2 中移除

pm2 delete 0
pm2 delete all

查看 pm2 所有项目列表

pm2 list

查看详情

pm2 show name的值

// 例
pm2 show app

实时监控查看资源

pm2 monit

查看日志

pm2 logs


pm2 logs app

mode

  • fork
    只启动一个进程单实例,用于多语言混编 python php

  • cluster
    多实例多进程,只适用 node 一种语言,不需要额外端口配置

生成配置文件文章来源地址https://www.toymoban.com/news/detail-632842.html

pm2 init simple


// 运行
pm2 start .\ecosystem.config.js

到了这里,关于nodejs框架 express koa介绍以及从零搭建 koa 模板的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包