附录
这部分参考文档涵盖了适用于核心 Spring Framework 中多个模块的主题。
Spring 属性
SpringProperties 是一个静态持有者,用于控制 Spring 框架某些低级别方面的属性。用户可以通过 JVM 系统属性或通过 SpringProperties.setProperty(String key, String value)
方法以编程方式配置这些属性。如果部署环境不允许自定义 JVM 系统属性,则后者可能是必要的。作为替代,这些属性可以在类路径根目录下的 spring.properties
文件中进行配置 — 例如,部署在应用程序的 JAR 文件内。
下表列出了所有当前支持的 Spring 属性。
表 1. 支持的 Spring 属性
名称 | 描述 |
---|---|
spring.aop.ajc.ignore | 指示 Spring 忽略 ajc 编译的方面,以便为同时启用织入和 AspectJ 自动代理的场景恢复传统的 Spring 行为。有关详细信息,请参见 AbstractAspectJAdvisorFactory。 |
spring.aot.enabled | 指示应用程序应使用 AOT 生成的工件运行。有关详细信息,请参见 提前优化 和 AotDetector。 |
spring.beaninfo.ignore | 指示 Spring 在调用 JavaBeans Introspector 时使用 Introspector.IGNORE_ALL_BEANINFO 模式。有关详细信息,请参见 StandardBeanInfoFactory。 |
spring.cache.reactivestreams.ignore | 指示 Spring 的缓存基础设施忽略 Reactive Streams 的存在,特别是在 @Cacheable 方法返回类型声明中忽略 Reactor 的 Mono /Flux 。有关详细信息,请参见 CacheAspectSupport。 |
spring.classformat.ignore | 指示 Spring 在类路径扫描期间忽略类格式异常,特别是对于不支持的类文件版本。有关详细信息,请参见 ClassPathScanningCandidateComponentProvider。 |
spring.context.checkpoint | 指定常见上下文检查点的属性。请参见 Automatic checkpoint/restore at startup 和 DefaultLifecycleProcessor 了解详细信息。 |
spring.context.exit | 用于在上下文达到特定阶段时终止 JVM 的属性。有关详细信息,请参见 Automatic checkpoint/restore at startup 和 DefaultLifecycleProcessor。 |
spring.context.expression.maxLength | 在 XML bean 定义、@Value 等中使用的 Spring 表达式语言 表达式的最大长度。 |
spring.expression.compiler.mode | 编译表达式时使用的模式,适用于 Spring Expression Language。 |
spring.getenv.ignore | 指示 Spring 忽略操作系统环境变量,如果 Spring Environment 属性 — 例如,配置字符串中的占位符 — 无法以其他方式解析。有关详细信息,请参见 AbstractEnvironment。 |
spring.jdbc.getParameterType.ignore | 指示 Spring 完全忽略 java.sql.ParameterMetaData.getParameterType 。请参阅 使用对象列表的批量操作 中的说明。 |
spring.jndi.ignore | 指示 Spring 忽略默认的 JNDI 环境,作为一种优化,适用于在这种 JNDI 回退搜索中根本不会找到任何内容的场景,从而避免重复的 JNDI 查找开销。有关详细信息,请参见 JndiLocatorDelegate。 |
spring.objenesis.ignore | 指示 Spring 忽略 Objenesis,甚至不尝试使用它。有关详细信息,请参见 SpringObjenesis。 |
spring.test.aot.processing.failOnError | 一个布尔标志,用于控制在 Spring TestContext Framework 中遇到的 AOT 处理错误是否应导致一个异常,从而使整个过程失败。请参见 Ahead of Time Support for Tests。 |
spring.test.constructor.autowire.mode | 如果测试类上没有 @TestConstructor ,则使用的默认 测试构造函数自动装配模式。请参见 更改默认测试构造函数自动装配模式。 |
spring.test.context.cache.maxSize | Spring TestContext Framework 中上下文缓存的最大大小。请参见 Context Caching。 |
spring.test.context.failure.threshold | 在 Spring TestContext Framework 中尝试加载 ApplicationContext 时遇到的错误的失败阈值。请参见 Context Failure Threshold。 |
spring.test.enclosing.configuration | 默认的 封闭配置继承模式,如果测试类上没有 @NestedTestConfiguration 。请参见 更改默认封闭配置继承模式。 |