此版本仍在开发中,尚不被认为是稳定的。对于最新的稳定版本,请使用 Spring Boot 3.5.5! |
使用 Gradle 运行您的应用程序
要在不先构建存档的情况下运行应用程序,请使用bootRun
任务:
$ ./gradlew bootRun
默认情况下,主类将通过查找具有public static void main(String[])
方法。
也可以使用任务的main
财产:
-
Groovy
-
Kotlin
tasks.named("bootRun") {
mainClass = 'com.example.ExampleApplication'
}
tasks.named<BootRun>("bootRun") {
mainClass.set("com.example.ExampleApplication")
}
或者,可以使用mainClass
Spring Boot DSL 的属性:
-
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
tasks,参数可以传递给bootRun
从命令行使用--args='<arguments>'
使用 Gradle 4.9 或更高版本时。例如,要使用名为dev
active 可以使用以下命令:
$ ./gradlew bootRun --args='--spring.profiles.active=dev'
看javadoc 的JavaExec.setArgsString
了解更多详情。
将系统属性传递给应用程序
因为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
system 属性设置为example
project 属性。如果example
project 属性未设置,则系统属性的值将为default
.
Gradle 允许以多种方式设置项目属性,包括在命令行上使用-P
标志,如以下示例所示:
$ ./gradlew bootRun -Pexample=custom
前面的示例设置了example
project 属性设置为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
.