|
此版本仍在开发中,尚未被视为稳定版本。如需最新稳定版本,请使用 Spring Boot 4.0.4! |
使用 Gradle 运行您的应用程序
要在不先构建归档文件的情况下运行您的应用程序,请使用 bootRun 任务:
$ ./gradlew bootRun
bootRun 任务是 BootRun 的一个实例,而后者是 JavaExec 的子类。
因此,您可以使用在 Gradle 中执行 Java 进程的所有常规配置选项。
该任务会自动配置为使用主源集的运行时类路径。
默认情况下,主类将通过在主源集的输出中查找具有 public static void main(String[]) 方法的类来自动配置。
也可以使用任务的 main 属性显式配置主类:
-
Groovy
-
Kotlin
tasks.named("bootRun") {
mainClass = 'com.example.ExampleApplication'
}
tasks.named<BootRun>("bootRun") {
mainClass.set("com.example.ExampleApplication")
}
或者,可以使用 Spring Boot DSL 的 mainClass 属性在整个项目范围内配置主类名称:
-
Groovy
-
Kotlin
springBoot {
mainClass = 'com.example.ExampleApplication'
}
springBoot {
mainClass.set("com.example.ExampleApplication")
}
默认情况下,bootRun 将配置 JVM 优化其启动过程,以在开发期间实现更快的启动速度。
可以通过使用 optimizedLaunch 属性来禁用此行为,如下例所示:
-
Groovy
-
Kotlin
tasks.named("bootRun") {
optimizedLaunch = false
}
tasks.named<BootRun>("bootRun") {
optimizedLaunch.set(false)
}
如果已应用 application 插件,则必须配置其 mainClass 属性,并可用于相同目的:
-
Groovy
-
Kotlin
application {
mainClass = 'com.example.ExampleApplication'
}
application {
mainClass.set("com.example.ExampleApplication")
}
向应用程序传递参数
与所有 JavaExec 任务一样,当使用 Gradle 4.9 或更高版本时,可以使用 --args='<arguments>' 从命令行将参数传递到 bootRun。
例如,要激活名为 dev 的配置文件的运行你的应用程序,可以使用以下命令:
$ ./gradlew bootRun --args='--spring.profiles.active=dev'
详见 JavaExec.setArgsString 的 Javadoc 以了解更多信息。
将系统属性传递给您的应用程序
由于 bootRun 是一个标准的 JavaExec 任务,因此可以通过在构建脚本中指定系统属性,将其传递给应用程序的 JVM。
要使系统属性的值可配置,请使用项目属性来设置其值。
要允许项目属性为可选,请使用 findProperty 来引用它。
这样做还允许使用 ?: Elvis 操作符提供默认值,如下例所示:
-
Groovy
-
Kotlin
tasks.named("bootRun") {
systemProperty 'com.example.property', findProperty('example') ?: 'default'
}
tasks.named<BootRun>("bootRun") {
systemProperty("com.example.property", findProperty("example") ?: "default")
}
前面的示例将 com.example.property 系统属性设置为 example 项目属性的值。
如果未设置 example 项目属性,则系统属性的值将为 default。
Gradle 允许以多种方式设置项目属性,包括在命令行上使用 -P 标志,如下例所示:
$ ./gradlew bootRun -Pexample=custom
前面的示例将 example 项目属性的值设置为 custom。
随后,bootRun 会将其用作 com.example.property 系统属性的值。
重新加载资源
如果已将 devtools 添加到项目中,它将自动监视应用程序类路径的更改。 请注意,需要重新编译修改后的文件,以便更新类路径并触发 devtools 的重新加载。 有关使用 devtools 的更多详细信息,请参阅参考文档的本节。
或者,您可以将 bootRun 配置为从源位置加载应用程序的静态资源:
-
Groovy
-
Kotlin
tasks.named("bootRun") {
sourceResources sourceSets.main
}
tasks.named<BootRun>("bootRun") {
sourceResources(sourceSets["main"])
}
这使得它们可以在运行的应用程序中重新加载,这在开发阶段会很有帮助。
使用测试主类
除了 bootRun 之外,还注册了一个 bootTestRun 任务。
与 bootRun 类似,bootTestRun 是 BootRun 的一个实例,但它被配置为使用测试源集输出中的主类,而不是主源集中的主类。
它还使用测试源集的运行时类路径,而不是主源集的运行时类路径。
由于 bootTestRun 是 BootRun 的一个实例,因此上述针对 bootRun 描述的所有配置选项也可用于 bootTestRun。