本文旨在解决wso2 micro integrator (mi) 中自定义类中介器出现 `classnotfoundexception` 的问题。核心在于理解mi的类加载机制，特别是区分maven项目中`pom.xml`文件的`packaging`类型（`jar`或`bundle`），并根据此类型将编译后的jar文件部署到正确的目录（`mi/lib`或`mi/dropins`）。遵循正确的部署策略，即可确保mi在运行时能够成功加载并执行自定义类。
WSO2 Micro Integrator中自定义类加载错误诊断与解决方案
在WSO2 Micro Integrator (MI) 中开发和部署自定义类中介器是扩展其功能的重要方式。然而，开发者常会遇到 java.lang.ClassNotFoundException 错误，即使已将编译好的JAR文件放置到 MI_HOME/lib 目录下。本文将深入探讨这一问题的原因，并提供一套详细的解决方案，确保您的自定义类能够被MI正确加载和执行。
理解 ClassNotFoundException 的根源
当MI运行时抛出 Error loading class: com.test.mediator.ChangeValue - Class not found java.lang.ClassNotFoundException: com.test.mediator.ChangeValue cannot be found by synapse-core_2.1.7.wso2v182 这样的错误时，表明MI的类加载器无法在预期的位置找到 com.test.mediator.ChangeValue 这个类。这通常不是因为JAR文件不存在，而是因为它被放置在了错误的位置，或者其打包方式与部署位置不匹配。
WSO2 MI基于OSGi框架构建，其类加载机制比传统的Java应用更为复杂。OSGi通过“bundle”的概念来管理组件及其依赖。因此，对于自定义类中介器，其Maven项目的pom.xml文件中定义的packaging类型至关重要。
示例：自定义类中介器及其调用
假设我们有一个简单的自定义类中介器 ChangeValue，用于修改消息上下文中的属性：
package com.test.mediator;
import org.apache.synapse.MessageContext;
import org.apache.synapse.mediators.AbstractMediator;
public class ChangeValue extends AbstractMediator {
@Override
public boolean mediate(MessageContext context) {
changeVal(context);
return true;
}
public void changeVal(MessageContext context) {
String Namem = (String) context.getProperty("NAMEE"); // 获取现有属性
String Namen = "Hary"; // 定义新值
context.setProperty("NameN", Namen); // 设置新属性
}
}在Synapse配置中，我们通过
当上述Synapse配置尝试加载 com.test.mediator.ChangeValue 时，如果部署不当，就会出现 ClassNotFoundException。
解决方案：根据打包类型正确部署JAR
解决此问题的关键在于识别自定义中介器项目的Maven pom.xml 文件中的 packaging 类型，并据此选择正确的部署目录。
步骤一：停止WSO2 Micro Integrator服务器
在进行任何文件系统操作之前，务必停止正在运行的MI服务器，以避免文件锁定或不一致状态。
步骤二：清理现有部署（可选但推荐）
为了确保部署环境的清洁，建议删除之前可能错误部署的JAR文件。检查并移除 MI_HOME/dropins 和 MI_HOME/lib 目录中与您的自定义中介器相关的JAR文件。
步骤三：检查项目 pom.xml 中的打包类型
打开您的自定义中介器项目的 pom.xml 文件，查找
... bundle ...... jar ...
步骤四：根据打包类型部署JAR文件
如果
bundle ： 这表示您的项目被打包为一个OSGi bundle。这种类型的JAR文件应该直接复制到 MI_HOME/dropins 目录。MI的OSGi框架会自动识别并加载 dropins 目录下的bundle。如果
jar （或未指定，默认为 jar）： 这表示您的项目被打包为一个普通的Java JAR文件。这种类型的JAR文件应该复制到 MI_HOME/lib 目录。lib 目录下的JAR文件会被添加到MI的系统类路径中，供非OSGi bundle的组件使用。
步骤五：重启WSO2 Micro Integrator服务器
将JAR文件放置到正确目录后，重新启动WSO2 Micro Integrator服务器。此时，MI应该能够成功加载您的自定义类中介器，并且在Synapse配置中调用它时不再出现 ClassNotFoundException。
注意事项与最佳实践
- 依赖管理： 确保您的自定义中介器项目的所有外部依赖（如果不是MI自带的）也以正确的方式打包和部署。对于OSGi bundle，依赖通常通过Import-Package头在MANIFEST.MF中声明。
- 版本兼容性： 确保您的自定义中介器使用的WSO2 Synapse API版本与您正在运行的MI版本兼容。
- 日志排查： 如果问题依然存在，仔细检查MI服务器的日志文件（wso2carbon.log），它们会提供更详细的错误信息，帮助您进一步诊断问题。
- Maven Archetype： 建议使用WSO2提供的Maven Archetype来创建自定义中介器项目，这通常会预配置正确的packaging类型和OSGi元数据。
通过遵循上述步骤，您将能够有效地解决WSO2 Micro Integrator中自定义类中介器的 ClassNotFoundException 问题，确保您的扩展功能能够稳定运行。理解MI的类加载机制，特别是OSGi bundle和普通JAR的区别，是成功部署自定义组件的关键。
