提前处理

Spring AOT 是一个在构建时分析应用程序并生成其优化版本的过程。 这是运行 Spring 的强制性步骤ApplicationContext在本机图像中。spring-doc.cadn.net.cn

有关 Spring Boot 中 GraalVM 本机映像支持的概述,请查看参考文档

Spring Boot Maven 插件提供了可用于对应用程序和测试代码执行 AOT 处理的目标。spring-doc.cadn.net.cn

处理应用程序

要将应用程序配置为使用此功能,请为process-aot目标,如以下示例所示:spring-doc.cadn.net.cn

<plugin>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-maven-plugin</artifactId>
	<executions>
		<execution>
			<id>process-aot</id>
			<goals>
				<goal>process-aot</goal>
			</goals>
		</execution>
	</executions>
</plugin>

作为BeanFactory在构建时做好充分准备,还评估条件。 与常规 Spring Boot 应用程序在运行时执行的作相比,这有一个重要的区别。 例如,如果要选择加入或选择退出某些功能,则需要配置构建时使用的环境才能执行此作。 这process-aot因此,目标与运行目标共享许多属性。spring-doc.cadn.net.cn

使用本机配置文件

如果您使用spring-boot-starter-parent作为parent项目的nativeprofile 可用于简化构建本机映像所需的步骤。spring-doc.cadn.net.cn

nativeprofile 配置以下内容:spring-doc.cadn.net.cn

使用原始类路径意味着本机图像不知道生成的MANIFEST.MF. 如果您需要读取本机映像中清单的内容,例如获取应用程序的实现版本,请配置classesDirectory选择使用常规罐子。spring-doc.cadn.net.cn

要从nativeprofile,则表示应用程序的模块应定义两个插件,如以下示例所示:spring-doc.cadn.net.cn

<plugin>
	<groupId>org.graalvm.buildtools</groupId>
	<artifactId>native-maven-plugin</artifactId>
</plugin>
<plugin>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>

单个项目可以使用云原生 Buildpack原生映像构建工具在命令行上触发原生映像的生成。spring-doc.cadn.net.cn

要使用nativeprofile,您可以创建native配置文件,以便调用您首选的技术。spring-doc.cadn.net.cn

要在package阶段,将以下内容添加到多模块项目的根 POM:spring-doc.cadn.net.cn

<profile>
	<id>native</id>
	<build>
		<pluginManagement>
			<plugins>
				<plugin>
					<groupId>org.springframework.boot</groupId>
					<artifactId>spring-boot-maven-plugin</artifactId>
					<executions>
						<execution>
							<id>build-image</id>
							<goals>
								<goal>build-image-no-fork</goal>
							</goals>
						</execution>
					</executions>
				</plugin>
			</plugins>
		</pluginManagement>
	</build>
</profile>

以下示例对本机生成工具执行相同的作:spring-doc.cadn.net.cn

<profile>
	<id>native</id>
	<build>
		<pluginManagement>
			<plugins>
				<plugin>
					<groupId>org.graalvm.buildtools</groupId>
					<artifactId>native-maven-plugin</artifactId>
					<executions>
						<execution>
							<id>build-image</id>
							<goals>
								<goal>compile-no-fork</goal>
							</goals>
						</execution>
					</executions>
				</plugin>
			</plugins>
		</pluginManagement>
	</build>
</profile>

完成上述作后,您可以构建多模块项目并在相关子模块中生成原生镜像,如以下示例所示:spring-doc.cadn.net.cn

$ mvn package -Pnative
“相关”子模块是表示 Spring Boot 应用程序的模块。 此类模块必须如上所述定义本机构建工具和 Spring Boot 插件。

spring-boot:process-aot

org.springframework.boot:spring-boot-maven-plugin:3.5.5spring-doc.cadn.net.cn

在应用程序上调用 AOT 引擎。spring-doc.cadn.net.cn

必填参数

名称 类型 默认值

classes目录spring-doc.cadn.net.cn

Filespring-doc.cadn.net.cn

${project.build.outputDirectory}spring-doc.cadn.net.cn

generated类spring-doc.cadn.net.cn

Filespring-doc.cadn.net.cn

${project.build.directory}/spring-aot/main/classesspring-doc.cadn.net.cn

生成资源spring-doc.cadn.net.cn

Filespring-doc.cadn.net.cn

${project.build.directory}/spring-aot/main/resourcesspring-doc.cadn.net.cn

生成源spring-doc.cadn.net.cn

Filespring-doc.cadn.net.cn

${project.build.directory}/spring-aot/main/sourcesspring-doc.cadn.net.cn

参数详情

arguments

AOT 处理应考虑的应用程序参数。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

argumentsspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.lang.String[]spring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

classesDirectory

包含应打包到存档中的类和资源文件的目录。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

classesDirectoryspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.io.Filespring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

${project.build.outputDirectory}spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

compilerArguments

应提供给 AOT 编译过程的参数。在命令行上,确保在引号之间包装多个值。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

compilerArgumentsspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.lang.Stringspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

spring-boot.aot.compilerArgumentsspring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

excludeGroupIds

要排除的 groupId 名称的逗号分隔列表(完全匹配)。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

excludeGroupIdsspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.lang.Stringspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

spring-boot.excludeGroupIdsspring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

1.1.0spring-doc.cadn.net.cn

excludes

要排除的工件定义的集合。这Exclude元素定义了强制性的groupIdartifactId组件和可选的classifier元件。 配置为属性时,值应使用冒号分隔的组件以逗号分隔:groupId:artifactId,groupId:artifactId:classifierspring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

excludesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.util.Listspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

spring-boot.excludesspring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

1.1.0spring-doc.cadn.net.cn

generatedClasses

包含生成类的目录。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

generatedClassesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.io.Filespring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

${project.build.directory}/spring-aot/main/classesspring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

generatedResources

包含生成资源的目录。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

generatedResourcesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.io.Filespring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

${project.build.directory}/spring-aot/main/resourcesspring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

generatedSources

包含生成源的目录。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

generatedSourcesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.io.Filespring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

${project.build.directory}/spring-aot/main/sourcesspring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

includes

要包含的工件定义集合。 这Include元素定义了强制性的groupIdartifactId组件和可选的classifier元件。 配置为属性时,值应使用冒号分隔的组件以逗号分隔:groupId:artifactId,groupId:artifactId:classifierspring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

includesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.util.Listspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

spring-boot.includesspring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

1.2.0spring-doc.cadn.net.cn

jvmArguments

应与 AOT 进程关联的 JVM 参数。在命令行上,确保在引号之间括住多个值。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

jvmArgumentsspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.lang.Stringspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

spring-boot.aot.jvmArgumentsspring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

mainClass

要用作 AOT 进程源的主类的名称。如果未指定,将使用找到的第一个包含“main”方法的编译类。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

mainClassspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.lang.Stringspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

spring-boot.aot.main-classspring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

profiles

AOT 加工时要考虑的弹簧型材。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

profilesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.lang.String[]spring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

systemPropertyVariables

要传递给 AOT 进程的 JVM 系统属性列表。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

systemPropertyVariablesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.util.Mapspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

处理测试

AOT 引擎可以应用于使用 Spring 的测试上下文框架的 JUnit 5 测试。 这些测试由 AOT 引擎处理,然后在本机映像中执行。spring-doc.cadn.net.cn

就像生产代码一样spring-boot-starter-parent定义一个nativeTest配置文件,可用于简化在本机映像中执行测试所需的步骤。spring-doc.cadn.net.cn

nativeTestprofile 配置以下内容:spring-doc.cadn.net.cn

要从nativeTestprofile,则表示应用程序的模块应定义两个插件,如以下示例所示:spring-doc.cadn.net.cn

<plugin>
	<groupId>org.graalvm.buildtools</groupId>
	<artifactId>native-maven-plugin</artifactId>
</plugin>
<plugin>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>

为需要此功能的每个模块做好上述作后,您可以构建多模块项目并在相关子模块的本机映像中执行测试,如以下示例所示:spring-doc.cadn.net.cn

$ mvn test -PnativeTest
与应用程序 AOT 处理一样,BeanFactory在构建时已做好充分准备。

spring-boot:process-test-aot

org.springframework.boot:spring-boot-maven-plugin:3.5.5spring-doc.cadn.net.cn

在测试中调用 AOT 引擎。spring-doc.cadn.net.cn

必填参数

名称 类型 默认值

classes目录spring-doc.cadn.net.cn

Filespring-doc.cadn.net.cn

${project.build.outputDirectory}spring-doc.cadn.net.cn

generated类spring-doc.cadn.net.cn

Filespring-doc.cadn.net.cn

${project.build.directory}/spring-aot/main/classesspring-doc.cadn.net.cn

生成资源spring-doc.cadn.net.cn

Filespring-doc.cadn.net.cn

${project.build.directory}/spring-aot/test/resourcesspring-doc.cadn.net.cn

生成源spring-doc.cadn.net.cn

Filespring-doc.cadn.net.cn

${project.build.directory}/spring-aot/test/sourcesspring-doc.cadn.net.cn

generatedTestClassesspring-doc.cadn.net.cn

Filespring-doc.cadn.net.cn

${project.build.directory}/spring-aot/test/classesspring-doc.cadn.net.cn

testClasses目录spring-doc.cadn.net.cn

Filespring-doc.cadn.net.cn

${project.build.testOutputDirectory}spring-doc.cadn.net.cn

参数详情

classesDirectory

包含应用于运行测试的类和资源文件的目录。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

classesDirectoryspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.io.Filespring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

${project.build.outputDirectory}spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

compilerArguments

应提供给 AOT 编译过程的参数。在命令行上,确保在引号之间包装多个值。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

compilerArgumentsspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.lang.Stringspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

spring-boot.aot.compilerArgumentsspring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

excludeGroupIds

要排除的 groupId 名称的逗号分隔列表(完全匹配)。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

excludeGroupIdsspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.lang.Stringspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

spring-boot.excludeGroupIdsspring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

1.1.0spring-doc.cadn.net.cn

excludes

要排除的工件定义的集合。这Exclude元素定义了强制性的groupIdartifactId组件和可选的classifier元件。 配置为属性时,值应使用冒号分隔的组件以逗号分隔:groupId:artifactId,groupId:artifactId:classifierspring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

excludesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.util.Listspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

spring-boot.excludesspring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

1.1.0spring-doc.cadn.net.cn

generatedClasses

包含生成的测试类的目录。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

generatedClassesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.io.Filespring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

${project.build.directory}/spring-aot/main/classesspring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

generatedResources

包含生成的测试资源的目录。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

generatedResourcesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.io.Filespring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

${project.build.directory}/spring-aot/test/resourcesspring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

generatedSources

包含生成源的目录。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

generatedSourcesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.io.Filespring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

${project.build.directory}/spring-aot/test/sourcesspring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

generatedTestClasses

包含生成的测试类的目录。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

generatedTestClassesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.io.Filespring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

${project.build.directory}/spring-aot/test/classesspring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

includes

要包含的工件定义集合。 这Include元素定义了强制性的groupIdartifactId组件和可选的classifier元件。 配置为属性时,值应使用冒号分隔的组件以逗号分隔:groupId:artifactId,groupId:artifactId:classifierspring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

includesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.util.Listspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

spring-boot.includesspring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

1.2.0spring-doc.cadn.net.cn

jvmArguments

应与 AOT 进程关联的 JVM 参数。在命令行上,确保在引号之间括住多个值。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

jvmArgumentsspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.lang.Stringspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

spring-boot.aot.jvmArgumentsspring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

systemPropertyVariables

要传递给 AOT 进程的 JVM 系统属性列表。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

systemPropertyVariablesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.util.Mapspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn

testClassesDirectory

包含应打包到存档中的类和资源文件的目录。spring-doc.cadn.net.cn

名称spring-doc.cadn.net.cn

testClassesDirectoryspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.io.Filespring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

${project.build.testOutputDirectory}spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

因为spring-doc.cadn.net.cn