如何在Anypoint Studio中正确导入带依赖的外部jar包？

是否必须通过Maven导入依赖 #

在Mule项目中不强制仅通过Maven导入Jar，也可以选择将所有依赖Jar放入Mule runtime的server/lib目录实现全局加载，但该方案会大幅提升类冲突风险，不同项目的同依赖不同版本会互相干扰，生产环境完全不推荐使用。Mule runtime的类加载机制基于Maven依赖树实现隔离加载，仅通过IDE build path添加Jar只会满足IDE编译通过要求，Runtime运行时无法识别对应依赖，就会触发你遇到的类未找到异常，因此强烈推荐通过Maven统一管理所有依赖。

正确导入Jar包的具体步骤 #

第一步：处理私有Jar包（厂商提供的无公共仓库的Jar） #

针对厂商自定义签名Jar这类没有发布到公共Maven仓库的依赖，二选一执行即可：

• 方案1：安装到本地Maven仓库
  对每个私有Jar执行如下Maven命令：

  mvn install:install-file -Dfile=<Jar包本地存储路径> -DgroupId=<自定义分组名，例如com.xxx.vendor> -DartifactId=<自定义组件名，例如custom-sign-sdk> -Dversion=<自定义版本号，例如1.0.0> -Dpackaging=jar
  

• 方案2：存入项目本地私有目录
  在项目根目录新建libs文件夹，将所有私有Jar放入该目录，随后在pom.xml的<repositories>节点新增本地仓库配置：

  <repository>
    <id>local-project-libs</id>
    <url>file:${project.basedir}/libs</url>
  </repository>
  

第二步：配置pom.xml依赖与仓库优先级 #

• 先在pom.xml的<dependencies>节点添加所有需要的依赖，包括厂商自定义Jar、commons lang、gson等公共依赖，厂商自定义Jar的依赖配置示例如下：

  <dependency>
    <groupId>com.xxx.vendor</groupId>
    <artifactId>custom-sign-sdk</artifactId>
    <version>1.0.0</version>
  </dependency>
  

• 调整pom.xml的<repositories>节点顺序，将Maven中央仓库配置放到Mule官方仓库前面，解决公共依赖优先去Mule仓库搜索找不到的问题：

  <repositories>
    <!-- 优先从Maven中央仓库拉取公共依赖 -->
    <repository>
      <id>central</id>
      <url>https://repo1.maven.org/maven2</url>
    </repository>
    <!-- 其次从Mule官方仓库拉取Mule相关组件 -->
    <repository>
      <id>mulesoft-releases</id>
      <url>https://repository.mulesoft.org/releases/</url>
    </repository>
    <!-- 若使用第一步的方案2，在此处添加本地libs仓库配置 -->
  </repositories>
  

• 配置完成后执行mvn clean install命令，确认所有依赖正常拉取。

第三步：配置类导出规则 #

如果执行完上述步骤还是出现类未找到异常，修改项目根目录的mule-artifact.json文件，将需要调用的类所在的包添加到导出配置中，示例如下：

{
  "minMuleVersion": "4.4.0",
  "classLoaderModelLoaderDescriptor": {
    "id": "mule",
    "attributes": {
      "exportedPackages": [
        "com.xxx.vendor.sign",
        "org.apache.commons.lang3",
        "com.google.gson"
      ]
    }
  }
}

配置完成后重启项目即可正常在DataWeave中调用对应方法。

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