Axis2 1.6.2升级至1.8版本时NamedStaxOMBuilder编译错误如何解决

问题根因 #

Axis2从1.7.x版本开始重构了数据绑定模块，移除了原org.apache.axis2.databinding.utils.NamedStaxOMBuilder和同包下的StreamWrapper类，相关功能已整合到新的工具类中，因此1.6.2版本生成的代码在1.8版本下会出现编译错误。

解决方案 #

方案1：调整wsdl2java生成参数（优先推荐） #

该问题大多由生成代码的wsdl2java工具版本与项目依赖的Axis2版本不一致导致，按以下操作可从根源避免问题：

• 确保使用Axis2 1.8版本自带的wsdl2java工具执行代码生成，不要复用旧版本工具
• 运行生成命令时追加-d adb -u参数，强制生成适配新版本API的ADB绑定代码，示例命令：

wsdl2java -d adb -u -uri 你的wsdl地址

方案2：手动适配已生成的代码 #

如果不方便重新生成代码，可直接修改报错的代码段：

1. 移除原有的过时导入语句，替换为新版本的类导入：

// 删除以下两行
// import org.apache.axis2.databinding.utils.NamedStaxOMBuilder;
// import org.apache.axis2.databinding.util.StreamWrapper;
// 新增导入
import org.apache.axis2.databinding.utils.OMBuilderUtil;
import org.apache.axiom.om.OMElement;

2. 替换原有的Builder实例化代码：

// 原代码
// NamedStaxOMBuilder builder = new NamedStaxOMBuilder(new StreamWrapper(reader), reader.getName());
// 替换为
OMElement element = OMBuilderUtil.buildOMElement(reader);

后续如果有使用builder对象生成OM节点的逻辑，直接使用上述element对象即可，功能完全等价。

注意事项 #

如果项目内有自定义代码直接调用了NamedStaxOMBuilder，统一替换为OMBuilderUtil的对应静态方法即可，该类已覆盖原类的全部功能。

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