此版本仍在开发中，尚不被认为是稳定的。对于最新的稳定版本，请使用 Spring Boot 3.5.5！spring-doc.cadn.net.cn

PropertiesLauncher 功能

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

钥匙目的

钥匙	目的
`loader.path`spring-doc.cadn.net.cn	逗号分隔的类路径，例如`lib,${HOME}/app/lib`. 较早的条目优先，就像常规条目一样`-classpath`在`javac`命令行。spring-doc.cadn.net.cn
`loader.home`spring-doc.cadn.net.cn	用于解析`loader.path`. 例如，给定`loader.path=lib`然后`${loader.home}/lib`是一个类路径位置（以及该目录中的所有 jar 文件）。此属性还用于查找`loader.properties`文件，如以下示例所示`/opt/app`它默认为`${user.dir}`.spring-doc.cadn.net.cn
`loader.args`spring-doc.cadn.net.cn	main 方法的默认参数（空格分隔）。spring-doc.cadn.net.cn
`loader.main`spring-doc.cadn.net.cn	要启动的主类的名称（例如`com.app.Application`).spring-doc.cadn.net.cn
`loader.config.name`spring-doc.cadn.net.cn	属性文件的名称（例如`launcher`). 它默认为`loader`.spring-doc.cadn.net.cn
`loader.config.location`spring-doc.cadn.net.cn	属性文件的路径（例如`classpath:loader.properties`). 它默认为`loader.properties`.spring-doc.cadn.net.cn
`loader.system`spring-doc.cadn.net.cn	布尔标志，指示应将所有属性添加到系统属性。它默认为`false`.spring-doc.cadn.net.cn

loader.pathspring-doc.cadn.net.cn

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

loader.homespring-doc.cadn.net.cn

用于解析loader.path. 例如，给定loader.path=lib然后${loader.home}/lib是一个类路径位置（以及该目录中的所有 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

布尔标志，指示应将所有属性添加到系统属性。它默认为false.spring-doc.cadn.net.cn

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

钥匙清单条目环境变量

钥匙	清单条目	环境变量
`loader.path`spring-doc.cadn.net.cn	`Loader-Path`spring-doc.cadn.net.cn	`LOADER_PATH`spring-doc.cadn.net.cn
`loader.home`spring-doc.cadn.net.cn	`Loader-Home`spring-doc.cadn.net.cn	`LOADER_HOME`spring-doc.cadn.net.cn
`loader.args`spring-doc.cadn.net.cn	`Loader-Args`spring-doc.cadn.net.cn	`LOADER_ARGS`spring-doc.cadn.net.cn
`loader.main`spring-doc.cadn.net.cn	`Start-Class`spring-doc.cadn.net.cn	`LOADER_MAIN`spring-doc.cadn.net.cn
`loader.config.location`spring-doc.cadn.net.cn	`Loader-Config-Location`spring-doc.cadn.net.cn	`LOADER_CONFIG_LOCATION`spring-doc.cadn.net.cn
`loader.system`spring-doc.cadn.net.cn	`Loader-System`spring-doc.cadn.net.cn	`LOADER_SYSTEM`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 Jer 建成时。如果使用它，请使用Main-Class属性并省略Start-Class.

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

loader.properties在loader.home，然后在类路径的根目录中，然后在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
占位符替换是从系统和环境变量以及使用前所有值的属性文件本身完成的。spring-doc.cadn.net.cn
属性的搜索顺序（在多个位置查找是有意义的）是环境变量、系统属性、loader.properties、分解的存档清单和存档清单。spring-doc.cadn.net.cn