Update application.md

This commit is contained in:
Pearl C 2022-12-25 18:15:58 +08:00 committed by GitHub
parent cb5d324800
commit 934a0c7b1b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -133,28 +133,28 @@ Use the `upgrade` command in `cli` to upgrade NocoBase Web service when needed.
* Trigger the `afterUpgrade` event. * Trigger the `afterUpgrade` event.
* Call the `stop` medthod to end upgrade. * Call the `stop` medthod to end upgrade.
## 构造函数 ## Constructor
### `constructor()` ### `constructor()`
创建一个应用实例。 Create an instance.
**签名** **Signature**
* `constructor(options: ApplicationOptions)` * `constructor(options: ApplicationOptions)`
**参数** **Parameters**
| 参数名 | 类型 | 默认值 | 描述 | | Name | Type | Default | Description |
| --- | --- | --- | --- | | --- | --- | --- | --- |
| `options.database` | `IDatabaseOptions` or `Database` | `{}` | 数据库配置 | | `options.database` | `IDatabaseOptions` or `Database` | `{}` | Database configuration |
| `options.resourcer` | `ResourcerOptions` | `{}` | 资源路由配置 | | `options.resourcer` | `ResourcerOptions` | `{}` | Resource route configuration |
| `options.logger` | `AppLoggerOptions` | `{}` | 日志 | | `options.logger` | `AppLoggerOptions` | `{}` | Log |
| `options.cors` | [`CorsOptions`](https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/koa__cors/index.d.ts#L24) | `{}` | 跨域配置,参考 [@koa/cors](https://npmjs.com/package/@koa/cors) | | `options.cors` | [`CorsOptions`](https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/koa__cors/index.d.ts#L24) | `{}` | Cross-domain configuration, refer to [@koa/cors](https://npmjs.com/package/@koa/cors) |
| `options.dataWrapping` | `boolean` | `true` | 是否包装响应数据,`true` 则将把通常的 `ctx.body` 包装为 `{ data, meta }` 的结构。 | | `options.dataWrapping` | `boolean` | `true` | Whether or not to wrap the response data, `true` will wrap the usual `ctx.body` into a `{ data, meta }` structure. |
| `options.registerActions` | `boolean` | `true` | 是否注册默认的 [actions](#) | | `options.registerActions` | `boolean` | `true` | Whether or not to register the default [actions](#) |
| `options.i18n` | `I18nOptions` | `{}` | 国际化配置,参考 [i18next](https://www.i18next.com/overview/api) | | `options.i18n` | `I18nOptions` | `{}` | Internationalization configuration, refer to [i18next](https://www.i18next.com/overview/api) |
| `options.plugins` | `PluginConfiguration[]` | `[]` | 默认启用的插件配置 | | `options.plugins` | `PluginConfiguration[]` | `[]` | Configuration of the plugins enabled by default |
Type Type
@ -164,44 +164,44 @@ interface ApplicationOptions {
} }
``` ```
## 实例成员 ## Instance Members
### `cli` ### `cli`
命令行工具实例,参考 npm 包 [Commander](https://www.npmjs.com/package/commander)。 CLI tool instance, refer to the npm package [Commander](https://www.npmjs.com/package/commander)。
### `db` ### `db`
数据库实例,相关 API 参考 [Database](/api/database)。 Database instance, refer to [Database](/api/database) for the related API.
### `resourcer` ### `resourcer`
应用初始化自动创建的资源路由管理实例,相关 API 参考 [Resourcer](/api/resourcer)。 Resource route management instance created automatically during app initialization, refer to [Resourcer](/api/resourcer) for the related API.
### `acl` ### `acl`
ACL 实例,相关 API 参考 [ACL](/api/acl)。 ACL instance, refer to [ACL](/api/acl) for the related API.
### `logger` ### `logger`
Winston 实例,相关 API 参考 [Winston](https://github.com/winstonjs/winston#table-of-contents)。 Winston instance, refer to [Winston](https://github.com/winstonjs/winston#table-of-contents) for the related API.
### `i18n` ### `i18n`
I18next 实例,相关 API 参考 [I18next](https://www.i18next.com/overview/api)。 I18next instance, refer to [I18next](https://www.i18next.com/overview/api) for the related API.
### `pm` ### `pm`
插件管理器实例,相关 API 参考 [PluginManager](./plugin-manager)。 Plugin manager instance, refer to [PluginManager](./plugin-manager) for the related API.
### `version` ### `version`
应用版本实例,相关 API 参考 [ApplicationVersion](./application-version)。 App version instance, refer to [ApplicationVersion](./application-version) for the related API.
### `middleware` ### `middleware`
内置的中间件有: Built-in middleware includes:
- logger - logger
- i18next - i18next
@ -213,9 +213,9 @@ I18next 实例,相关 API 参考 [I18next](https://www.i18next.com/overview/ap
### `context` ### `context`
继承自 koa 的 context可以通过 `app.context` 访问,用于向每个请求注入上下文可访问的内容。参考 [Koa Context](https://koajs.com/#app-context)。 Context inherited from koa, accessible via `app.context`, is used to inject context-accessible content to each request. Refer to [Koa Context](https://koajs.com/#app-context).
NocoBase 默认对 context 注入了以下成员,可以在请求处理函数中直接使用: NocoBase injects the following members to context by default, which can be used directly in the request function:
| 变量名 | 类型 | 描述 | | 变量名 | 类型 | 描述 |
| --- | --- | --- | | --- | --- | --- |