REST 应用程序属性

定义 API 返回实体实例数量的默认最大值。

默认值：10000

定义 API 返回特定实体实例数量的默认最大值。

下面示例中，为两个实体配置了 entityMaxFetchSize。所有其他实体则会使用 jmix.rest.default-max-fetch-size 配置的值。

定义包含一组 JSON 转换配置的文件，由 REST API 在客户端需要某些特定版本格式的数据时使用。

通过 Resources 接口加载，因此文件可位于 classpath 或者配置文件夹中。

默认值：none

定义 REST API 支持上传的文件大小的最大值（单位为字节）。

默认值：20971520（20 MB）

如果 JSON 中提供了 version 属性，则启用实体乐观锁。

默认值：false

定义包含 JPQL 查询语句的文件，JQPL 查询语句用于 实体 API。

通过 Resources 接口加载，因此文件可位于 classpath 或者配置文件夹中。

默认值：none

定义包含一组服务方法的文件，这些服务方法开放为 服务 API。

通过 Resources 接口加载，因此文件可位于 classpath 或者配置文件夹中。

默认值：none

如果设置为 true，则可以在创建和更新请求中使用 responseFetchPlan 参数指定 fetch plan 名称。此时，创建/更新后的实体使用参数指定的 fetch plan 加载后以 JSON 格式返回。

如果设置为 false，返回体仅包含创建/更新后实体的最简单内容。

默认值：true

定义一组由逗号分隔的 URL patterns，这些 URL 支持 匿名访问。

默认值：none

定义一组由逗号分隔的 自定义控制器 URL patterns，这些 URL 需要标准的 OAuth2 认证。

默认值：none

定义一个 REST API 客户端的标识符。这里，客户端并非只平台的用户，而是一个使用 REST API 的应用程序（例如，门户或手机 App）。客户端凭证用在访问 REST API token 接口时做基本认证。

默认值：client

定义 REST API 客户端的密码。这里，客户端并非只平台的用户，而是一个使用 REST API 的应用程序（例如，门户或手机 App）。客户端凭证用在访问 REST API token 接口时做基本认证。

该应用程序属性除了实际的密码值（例如，secret）外，还需要包含一个密码加密器（Password Encoder）的标识符（例如，{noop}）。关于密码加密器的更多信息，请参阅 Spring Security 文档。

默认值：{noop}secret

支持的授权类型。

默认值：password,external,refresh_token

Access token 的有效期，单位为秒。

默认值：43200（12 小时）

Refresh token 的有效期，单位为秒。

默认值：31536000（365 天）

开发模式下，支持无需通过 token 访问 REST API。开发模式支持的免登录用户列表通过 jmix.security.oauth2.dev-username 属性配置。

默认值：false

开发模式下的 username 列表。参考 jmix.security.oauth2.dev-mode。

设置为 true 时，应用程序日志中会对 token 进行掩码处理。

默认值：true

是否可以重用未失效的 refresh token。

默认值：true

是否支持 refresh token。

默认值：true