PropertiesLauncher 功能

PropertiesLauncher 有几个特殊功能，可以通过外部属性（系统属性、环境变量、清单条目或 loader.properties）启用。下表描述了这些属性

键 目的

loader.path

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

loader.home

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

loader.args

主方法的默认参数（空格分隔）。

loader.main

要启动的主类名称（例如，com.app.Application）。

loader.config.name

属性文件名称（例如，launcher）。它默认为 loader。

loader.config.location

属性文件路径（例如，classpath:loader.properties）。默认值为loader.properties。

loader.system

布尔标志，指示是否应将所有属性添加到系统属性中。默认值为false。

当指定为环境变量或清单条目时，应使用以下名称

键 清单条目 环境变量

loader.path

Loader-Path

LOADER_PATH

loader.home

Loader-Home

LOADER_HOME

loader.args

Loader-Args

LOADER_ARGS

loader.main

Start-Class

LOADER_MAIN

loader.config.location

Loader-Config-Location

LOADER_CONFIG_LOCATION

loader.system

Loader-System

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

以下规则适用于使用PropertiesLauncher

  • loader.properties在loader.home中搜索，然后在类路径的根目录中搜索，最后在classpath:/BOOT-INF/classes中搜索。使用第一个找到该名称的文件的位置。

  • loader.home是附加属性文件的目录位置（覆盖默认值），仅当未指定loader.config.location时。

  • loader.path可以包含目录（递归扫描 jar 和 zip 文件）、存档路径、存档中扫描 jar 文件的目录（例如，dependencies.jar!/lib）或通配符模式（用于默认 JVM 行为）。存档路径可以相对于loader.home或文件系统中的任何位置，并带有jar:file:前缀。

  • loader.path（如果为空）默认为BOOT-INF/lib（表示本地目录或从存档运行时的嵌套目录）。因此，当没有提供其他配置时，PropertiesLauncher的行为与JarLauncher相同。

  • loader.path不能用于配置loader.properties的位置（用于搜索后者的类路径是在启动PropertiesLauncher时使用的 JVM 类路径）。

  • 在使用之前，对所有值从系统和环境变量以及属性文件本身进行占位符替换。

  • 属性搜索顺序（在多个位置进行搜索时）是环境变量、系统属性、loader.properties、展开的存档清单和存档清单。