此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Boot 3.3.1Spring中文文档

此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Boot 3.3.1Spring中文文档

PropertiesLauncher具有一些可以使用外部属性(系统属性、环境变量、清单条目或 )启用的特殊功能。 下表描述了这些属性:loader.propertiesSpring中文文档

钥匙 目的

loader.pathSpring中文文档

逗号分隔的类路径,例如 . 较早的条目优先,就像命令行上的常规条目一样。lib,${HOME}/app/lib-classpathjavacSpring中文文档

loader.homeSpring中文文档

用于解析 中的相对路径。 例如,给定 ,则是一个类路径位置(以及该目录中的所有 jar 文件)。 此属性还用于查找文件,如以下示例所示 它默认为 。loader.pathloader.path=lib${loader.home}/libloader.properties/opt/app${user.dir}Spring中文文档

loader.argsSpring中文文档

main 方法的默认参数(以空格分隔)。Spring中文文档

loader.mainSpring中文文档

要启动的主类的名称(例如,)。com.app.ApplicationSpring中文文档

loader.config.nameSpring中文文档

属性文件的名称(例如,)。 它默认为 。launcherloaderSpring中文文档

loader.config.locationSpring中文文档

属性文件的路径(例如,)。 它默认为 。classpath:loader.propertiesloader.propertiesSpring中文文档

loader.systemSpring中文文档

Boolean 标志,指示应将所有属性添加到系统属性中。 它默认为 。falseSpring中文文档

当指定为环境变量或清单条目时,应使用以下名称:Spring中文文档

钥匙 清单条目 环境变量

loader.pathSpring中文文档

Loader-PathSpring中文文档

LOADER_PATHSpring中文文档

loader.homeSpring中文文档

Loader-HomeSpring中文文档

LOADER_HOMESpring中文文档

loader.argsSpring中文文档

Loader-ArgsSpring中文文档

LOADER_ARGSSpring中文文档

loader.mainSpring中文文档

Start-ClassSpring中文文档

LOADER_MAINSpring中文文档

loader.config.locationSpring中文文档

Loader-Config-LocationSpring中文文档

LOADER_CONFIG_LOCATIONSpring中文文档

loader.systemSpring中文文档

Loader-SystemSpring中文文档

LOADER_SYSTEMSpring中文文档

构建插件会自动将属性移动到构建 uber jar 时。 如果使用它,请使用属性并省略 来指定要启动的类的名称。Main-ClassStart-ClassMain-ClassStart-Class
构建插件会自动将属性移动到构建 uber jar 时。 如果使用它,请使用属性并省略 来指定要启动的类的名称。Main-ClassStart-ClassMain-ClassStart-Class

以下规则适用于使用:PropertiesLauncherSpring中文文档

  • loader.properties在 中搜索,然后在类路径的根目录中搜索,然后在 中搜索。 使用具有该名称的文件存在的第一个位置。loader.homeclasspath:/BOOT-INF/classesSpring中文文档

  • loader.home仅当未指定时,才是其他属性文件的目录位置(覆盖默认值)。loader.config.locationSpring中文文档

  • loader.path可以包含目录(以递归方式扫描 jar 和 zip 文件)、归档路径、归档文件中扫描 jar 文件的目录(例如,)或通配符模式(用于缺省 JVM 行为)。 归档路径可以是相对于文件系统或文件系统中带有前缀的任何位置。dependencies.jar!/libloader.homejar:file:Spring中文文档

  • loader.path(如果为空)默认为 (表示本地目录或嵌套目录(如果从存档运行)。 因此,其行为与未提供其他配置时的行为相同。BOOT-INF/libPropertiesLauncherJarLauncherSpring中文文档

  • loader.path不能用于配置的位置(用于搜索后者的类路径是启动时的 JVM 类路径)。loader.propertiesPropertiesLauncherSpring中文文档

  • 占位符替换是在使用之前从系统和环境变量以及所有值的属性文件本身完成的。Spring中文文档

  • 属性的搜索顺序(在多个位置查找是有意义的)是环境变量、系统属性、分解存档清单和存档清单。loader.propertiesSpring中文文档