使用 Gradle 运行您的应用程序

要运行应用程序而不先构建存档,请使用 bootRun 任务

$ ./gradlew bootRun

bootRun 任务是 BootRun 的一个实例,BootRunJavaExec 的子类。因此,所有在 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 一样,bootTestRunBootRun 的一个实例,但它被配置为使用在测试源集的输出中找到的主类,而不是主源集。它还使用测试源集的运行时类路径,而不是主源集的运行时类路径。由于 bootTestRunBootRun 的一个实例,因此上面为 bootRun 描述的所有配置选项也可以与 bootTestRun 一起使用。