Update middleware.md
This commit is contained in:
		
							parent
							
								
									4904735597
								
							
						
					
					
						commit
						54e6b786d0
					
				@ -1,8 +1,8 @@
 | 
			
		||||
# 中间件
 | 
			
		||||
# Middleware
 | 
			
		||||
 | 
			
		||||
## 如何注册中间件?
 | 
			
		||||
## How to register middleware?
 | 
			
		||||
 | 
			
		||||
中间件的注册方法一般写在 load 方法里
 | 
			
		||||
The registration method for middleware is usually written in the load method
 | 
			
		||||
 | 
			
		||||
```ts
 | 
			
		||||
export class MyPlugin extends Plugin {
 | 
			
		||||
@ -14,13 +14,13 @@ export class MyPlugin extends Plugin {
 | 
			
		||||
}
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
说明:
 | 
			
		||||
Notes.
 | 
			
		||||
 | 
			
		||||
1. `app.acl.use()` 添加资源权限级中间件,在权限判断之前执行
 | 
			
		||||
2. `app.resourcer.use()` 添加资源级中间件,只有请求已定义的 resource 时才执行
 | 
			
		||||
3. `app.use()` 添加应用级中间件,每次请求都执行
 | 
			
		||||
1. `app.acl.use()` Add a resource-permission-level middleware to be executed before permission determination
 | 
			
		||||
2. `app.resourcer.use()` Adds a resource-level middleware that is executed only when a defined resource is requested
 | 
			
		||||
3. `app.use()` Add an application-level middleware to be executed on every request
 | 
			
		||||
 | 
			
		||||
## 洋葱圈模型
 | 
			
		||||
## Onion Circle Model
 | 
			
		||||
 | 
			
		||||
```ts
 | 
			
		||||
app.use(async (ctx, next) => {
 | 
			
		||||
@ -38,45 +38,45 @@ app.use(async (ctx, next) => {
 | 
			
		||||
});
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
访问 http://localhost:13000/api/hello 查看,浏览器响应的数据是:
 | 
			
		||||
Visit http://localhost:13000/api/hello to see that the browser responds with the following data
 | 
			
		||||
 | 
			
		||||
```js
 | 
			
		||||
{"data": [1,3,4,2]}
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## 内置中间件及执行顺序
 | 
			
		||||
## Built-in middlewares and execution order
 | 
			
		||||
 | 
			
		||||
1. `cors`
 | 
			
		||||
2. `bodyParser`
 | 
			
		||||
3. `i18n`
 | 
			
		||||
4. `dataWrapping`
 | 
			
		||||
5. `db2resource`
 | 
			
		||||
6. `restApi`
 | 
			
		||||
   1. `parseToken`
 | 
			
		||||
5. `db2resource` 6.
 | 
			
		||||
6. `restApi` 1.
 | 
			
		||||
   1. `parseToken` 2.
 | 
			
		||||
   2. `checkRole`
 | 
			
		||||
   3. `acl`
 | 
			
		||||
      1. `acl.use()` 添加的其他中间件
 | 
			
		||||
   4. `resourcer.use()` 添加的其他中间件
 | 
			
		||||
   5. action handler
 | 
			
		||||
7. `app.use()` 添加的其他中间件
 | 
			
		||||
   3. `acl` 1.
 | 
			
		||||
      1. `acl.use()` Additional middleware added
 | 
			
		||||
   4. `resourcer.use()` Additional middleware added
 | 
			
		||||
   5. `action handler`
 | 
			
		||||
7. `app.use()` Additional middleware added
 | 
			
		||||
 | 
			
		||||
也可以使用 `before` 或 `after` 将中间件插入到前面的某个 `tag` 标记的位置,如:
 | 
			
		||||
You can also use `before` or `after` to insert the middleware into the location of one of the preceding `tag`, e.g.
 | 
			
		||||
 | 
			
		||||
```ts
 | 
			
		||||
app.use(m1, { tag: 'restApi' });
 | 
			
		||||
app.resourcer.use(m2, { tag: 'parseToken' });
 | 
			
		||||
app.resourcer.use(m3, { tag: 'checkRole' });
 | 
			
		||||
// m4 将排在 m1 前面
 | 
			
		||||
// m4 will come before m1
 | 
			
		||||
app.use(m4, { before: 'restApi' });
 | 
			
		||||
// m5 会插入到 m2 和 m3 之间
 | 
			
		||||
// m5 will be inserted between m2 and m3
 | 
			
		||||
app.resourcer.use(m5, { after: 'parseToken', before: 'checkRole' });
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
如果未特殊指定位置,新增的中间件的执行顺序是:
 | 
			
		||||
If no location is specifically specified, the order of execution of the added middlewares is
 | 
			
		||||
 | 
			
		||||
1. 优先执行 acl.use 添加的,
 | 
			
		||||
2. 然后是 resourcer.use 添加的,包括 middleware handler 和 action handler,
 | 
			
		||||
3. 最后是 app.use 添加的。
 | 
			
		||||
1. middlewares added by `acl.use` will be executed first
 | 
			
		||||
2. then the ones added by `resourcer.use`, including the middleware handler and action handler
 | 
			
		||||
3. and finally the ones added by `app.use`
 | 
			
		||||
 | 
			
		||||
```ts
 | 
			
		||||
app.use(async (ctx, next) => {
 | 
			
		||||
@ -113,19 +113,19 @@ app.resourcer.define({
 | 
			
		||||
});
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
访问 http://localhost:13000/api/hello 查看,浏览器响应的数据是:
 | 
			
		||||
Visit http://localhost:13000/api/hello to see that the browser responds with the data
 | 
			
		||||
 | 
			
		||||
```js
 | 
			
		||||
{"data": [1,2]}
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
访问 http://localhost:13000/api/test:list 查看,浏览器响应的数据是:
 | 
			
		||||
Visiting http://localhost:13000/api/test:list to see, the browser responds with the following data
 | 
			
		||||
 | 
			
		||||
```js
 | 
			
		||||
{"data": [5,3,7,1,2,8,4,6]}
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### resource 未定义,不执行 resourcer.use() 添加的中间件
 | 
			
		||||
### Resource undefined, middlewares added by resourcer.use() will not be executed
 | 
			
		||||
 | 
			
		||||
```ts
 | 
			
		||||
app.use(async (ctx, next) => {
 | 
			
		||||
@ -143,18 +143,18 @@ app.resourcer.use(async (ctx, next) => {
 | 
			
		||||
});
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
访问 http://localhost:13000/api/hello 查看,浏览器响应的数据是:
 | 
			
		||||
Visit http://localhost:13000/api/hello to see that the browser responds with the following data
 | 
			
		||||
 | 
			
		||||
```js
 | 
			
		||||
{"data": [1,2]}
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
以上示例,hello 资源未定义,不会进入 resourcer,所以就不会执行 resourcer 里的中间件
 | 
			
		||||
In the above example, the hello resource is not defined and will not enter the resourcer, so the middleware in the resourcer will not be executed
 | 
			
		||||
 | 
			
		||||
## 中间件用途
 | 
			
		||||
## Middleware Usage
 | 
			
		||||
 | 
			
		||||
待补充
 | 
			
		||||
TODO
 | 
			
		||||
 | 
			
		||||
## 示例
 | 
			
		||||
## Example
 | 
			
		||||
 | 
			
		||||
- [samples/ratelimit](https://github.com/nocobase/nocobase/blob/main/packages/samples/ratelimit/) IP rate-limiting
 | 
			
		||||
 | 
			
		||||
		Loading…
	
		Reference in New Issue
	
	Block a user