如何为Open Liberty Bell扩展加载依赖？优化自定义用户注册表依赖管理

针对你用Bell特性实现自定义用户注册表时，因Java 8兼容使用Apache HTTP Client而需要添加依赖的场景，以下是比fat jar更简洁优雅的方案：

1. 扩展现有Library配置，单独添加依赖JAR #

无需将依赖打包进自定义用户注册表的JAR，直接在<library>配置中逐个添加所需的依赖JAR即可：

<featureManager>
    <!-- To enable the custom user registry-->
    <feature>bells-1.0</feature>
    <!-- Required in the CUR -->
    <feature>jsonb-3.0</feature>
</featureManager>
<library id="bellsCurLib" name="bellsCurLib">
    <file name="${server.config.dir}/resources/ol-cur.jar"/>
    <!-- 添加Apache HTTP Client及相关依赖 -->
    <file name="${server.config.dir}/resources/httpclient-4.5.14.jar"/>
    <file name="${server.config.dir}/resources/httpcore-4.4.16.jar"/>
    <file name="${server.config.dir}/resources/commons-logging-1.2.jar"/>
</library>
<bell libraryRef="bellsCurLib" enableSpiVisibility="true">
    <properties
        prop1="value1"
        prop2="value2"/>
</bell>

这种方式的优势：

• 依赖与自定义注册表代码分离，便于单独升级依赖版本
• 避免fat jar可能带来的类冲突（比如Open Liberty本身可能已包含部分公共依赖）
• 配置清晰，便于排查依赖相关问题

2. 用Maven自动复制依赖（简化部署流程） #

如果希望构建时自动将依赖复制到指定目录，可使用maven-dependency-plugin插件，在打包阶段自动把所需依赖复制到server资源目录：

在你的自定义注册表项目的pom.xml中添加如下配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <version>3.6.0</version>
    <executions>
        <execution>
            <id>copy-dependencies</id>
            <phase>package</phase>
            <goals>
                <goal>copy-dependencies</goal>
            </goals>
            <configuration>
                <!-- 指定依赖输出目录，可对应server的resources目录 -->
                <outputDirectory>${project.build.directory}/resources</outputDirectory>
                <!-- 仅复制所需的依赖组，避免冗余 -->
                <includeGroupIds>org.apache.httpcomponents,commons-logging</includeGroupIds>
            </configuration>
        </execution>
    </executions>
</plugin>

执行mvn package后，插件会自动将Apache HTTP Client及其依赖复制到指定目录，部署时只需将该目录下的所有JAR复制到Open Liberty的server.config.dir/resources即可。

3. 共享库配置（适用于多组件复用依赖场景） #

如果你的Open Liberty服务器中有多个Bell或应用需要使用Apache HTTP Client等依赖，可以将这些依赖配置为共享库：

<library id="apacheHttpLib" name="apacheHttpLib">
    <file name="${server.config.dir}/resources/httpclient-4.5.14.jar"/>
    <file name="${server.config.dir}/resources/httpcore-4.4.16.jar"/>
    <file name="${server.config.dir}/resources/commons-logging-1.2.jar"/>
</library>

<!-- 在Bell的libraryRef中引用多个库 -->
<bell enableSpiVisibility="true">
    <libraryRef>bellsCurLib</libraryRef>
    <libraryRef>apacheHttpLib</libraryRef>
    <properties
        prop1="value1"
        prop2="value2"/>
</bell>

这种方式适合依赖复用的场景，减少重复配置。

为什么不推荐fat jar？ #

• 容易引发类版本冲突：如果Open Liberty本身已包含某些依赖（如commons-logging），fat jar中的版本可能与服务器内置版本冲突，导致类加载异常
• 依赖升级繁琐：需要重新打包整个fat jar才能升级单个依赖
• 调试与维护困难：无法快速区分自定义代码与第三方依赖，排查问题时复杂度更高

内容的提问来源于stack exchange，提问作者Bernd