此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Boot 3.4.0spring-doc.cadn.net.cn

属性Launcher 功能

PropertiesLauncher具有一些可以通过外部属性(系统属性、环境变量、清单条目或loader.properties). 下表描述了这些属性:spring-doc.cadn.net.cn

钥匙 目的

loader.pathspring-doc.cadn.net.cn

逗号分隔的类路径,例如lib,${HOME}/app/lib. 较早的条目优先,就像常规的-classpathjavac命令行。spring-doc.cadn.net.cn

loader.homespring-doc.cadn.net.cn

用于解析loader.path. 例如,给定loader.path=lib然后${loader.home}/lib是 Classpath 位置(以及该目录中的所有 jar 文件)。 此属性还用于查找loader.properties文件,如以下示例所示/opt/app它默认为${user.dir}.spring-doc.cadn.net.cn

loader.argsspring-doc.cadn.net.cn

main 方法的默认参数(以空格分隔)。spring-doc.cadn.net.cn

loader.mainspring-doc.cadn.net.cn

要启动的主类的名称(例如com.app.Application).spring-doc.cadn.net.cn

loader.config.namespring-doc.cadn.net.cn

属性文件的名称(例如launcher). 它默认为loader.spring-doc.cadn.net.cn

loader.config.locationspring-doc.cadn.net.cn

属性文件的路径(例如classpath:loader.properties). 它默认为loader.properties.spring-doc.cadn.net.cn

loader.systemspring-doc.cadn.net.cn

Boolean 标志,指示所有属性都应添加到 System properties。 它默认为false.spring-doc.cadn.net.cn

当指定为环境变量或清单条目时,应使用以下名称:spring-doc.cadn.net.cn

钥匙 清单条目 环境变量

loader.pathspring-doc.cadn.net.cn

Loader-Pathspring-doc.cadn.net.cn

LOADER_PATHspring-doc.cadn.net.cn

loader.homespring-doc.cadn.net.cn

Loader-Homespring-doc.cadn.net.cn

LOADER_HOMEspring-doc.cadn.net.cn

loader.argsspring-doc.cadn.net.cn

Loader-Argsspring-doc.cadn.net.cn

LOADER_ARGSspring-doc.cadn.net.cn

loader.mainspring-doc.cadn.net.cn

Start-Classspring-doc.cadn.net.cn

LOADER_MAINspring-doc.cadn.net.cn

loader.config.locationspring-doc.cadn.net.cn

Loader-Config-Locationspring-doc.cadn.net.cn

LOADER_CONFIG_LOCATIONspring-doc.cadn.net.cn

loader.systemspring-doc.cadn.net.cn

Loader-Systemspring-doc.cadn.net.cn

LOADER_SYSTEMspring-doc.cadn.net.cn

构建插件会自动将Main-Class属性设置为Start-Class当 Uber Jar 构建时。 如果使用该选项,请使用Main-Class属性并省略Start-Class.

以下规则适用于使用PropertiesLauncher:spring-doc.cadn.net.cn

  • loader.propertiesloader.home,然后在 Classpath 的根目录中,然后在classpath:/BOOT-INF/classes. 使用具有该名称的文件所在的第一个位置。spring-doc.cadn.net.cn

  • loader.home是附加属性文件的目录位置(覆盖默认值),仅当loader.config.location未指定。spring-doc.cadn.net.cn

  • loader.path可以包含目录(以递归方式扫描 jar 和 zip 文件)、存档路径、存档中扫描 jar 文件的目录(例如dependencies.jar!/lib)或通配符模式(用于默认 JVM 行为)。 归档路径可以是相对于loader.home或文件系统中具有jar:file:前缀。spring-doc.cadn.net.cn

  • loader.path(如果为空)默认为BOOT-INF/lib(如果从存档运行,则表示本地目录或嵌套目录)。 正因为如此,PropertiesLauncher的行为与JarLauncher未提供其他配置时。spring-doc.cadn.net.cn

  • loader.path不能用于配置位置loader.properties(用于搜索后者的类路径是 JVM 类路径,当PropertiesLauncher启动)。spring-doc.cadn.net.cn

  • 占位符替换是在使用之前根据 System 和 environment variables 以及 properties 文件本身对所有值完成的。spring-doc.cadn.net.cn

  • 属性的搜索顺序(在多个位置查找是有意义的)是环境变量、系统属性、loader.properties、exploded archive 清单和 archive 清单。spring-doc.cadn.net.cn