如何在Guidewire的ClaimCenter/PolicyCenter中添加外部Java依赖

以下是两种主流适配方案，可根据你使用的Guidewire版本选择：

方案1：全版本通用手动导入方案 #

适用于所有Guidewire版本，操作门槛低：

• 先下载对应版本的docusign-esign-java.jar，以及该库关联的所有依赖jar包，避免运行时出现类缺失问题
• 将所有下载完成的jar包放入ClaimCenter/PolicyCenter项目的modules/ext/lib目录下，若目录不存在可手动新建
• 打开modules/ext/module.xml配置文件，在块中注册所有引入的jar包，参考配置如下：

<module>
  <dependencies>
    <!-- 原有依赖无需修改 -->
  </dependencies>
  <sources>
    <!-- 原有配置无需修改 -->
  </sources>
  <libraries>
    <library name="docusign-esign-java.jar" />
    <!-- 其余引入的依赖jar包均按照以上格式逐个添加即可 -->
  </libraries>
</module>

• 重启Guidewire Studio后执行gw rebuild命令完成项目重构，依赖即可生效
• 验证方式：在Gosu或Java代码中直接导入docusign相关类，无报错即为导入成功

方案2：Guidewire 10+版本自动依赖拉取方案 #

10及以上版本支持Maven/Gradle自动管理依赖，无需手动下载jar包：

• 打开项目根目录下的构建配置文件，Gradle构建对应build.gradle，Maven构建对应pom.xml
• 若为Gradle构建，在dependencies代码块中添加如下配置：

implementation group: 'com.docusign', name: 'docusign-esign-java', version: '你需要使用的库版本号'

• 若为Maven构建，在pom.xml的dependencies代码块中添加如下配置：

<dependency>
    <groupId>com.docusign</groupId>
    <artifactId>docusign-esign-java</artifactId>
    <version>你需要使用的库版本号</version>
</dependency>

• 执行gw clean build命令，系统会自动从Maven仓库拉取目标库及所有关联依赖
• 重启Studio后即可正常调用库相关能力

注意事项 #

• 引入前请确认第三方库的JDK版本与Guidewire项目的运行JDK版本兼容，例如Guidewire 10+默认使用JDK11，不要引入仅支持JDK8及以下的库版本
• 生产环境为集群部署时，需确保所有节点的ext目录同步了对应的jar包，或通过构建流水线自动将依赖打入发布包
• 建议先在测试环境完成全功能验证，避免类冲突、依赖缺失等问题导致线上服务异常

内容的提问来源于stack exchange，提问作者Md Safdar Khan