从AXIS2迁移到CXF：WSDL生成Java对象的绑定文件错误排查

问题根源分析 #

1. 初始错误{http://maximus.com/assetworks/fmax-wsdl}[message:integer]不存在：WSDL中getNextLinkTranxNum操作的输出消息引用了tns:integer类型，但该类型未在WSDL的XSD定义中声明。Axis2对这类不规范定义有兼容性处理，但CXF严格遵循JAX-WS/JAXB规范，因此报错。
2. 绑定文件错误Not a valid jaxb or jaxws binding file：你创建的bindings.xml未使用正确的JAX-WS/JAXB命名空间，导致CXF无法识别。

解决方案 #

步骤1：编写正确的绑定文件 #

绑定文件必须包含JAX-WS和JAXB的标准命名空间，同时精准定位需要映射的类型或消息部分。根据你的场景，提供两种绑定方案：

方案A：全局映射未定义的tns:integer类型

如果WSDL中多处引用tns:integer但未声明该类型，使用此方案全局映射：

<jaxws:bindings xmlns:jaxws="http://java.sun.com/xml/ns/jaxws"
                xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
                xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                xmlns:tns="http://maximus.com/assetworks/fmax-wsdl"
                version="2.1">

    <!-- 绑定到WSDL目标命名空间对应的XSD schema -->
    <jaxws:bindings node="wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='http://maximus.com/assetworks/fmax-wsdl']">
        <!-- 将tns:integer映射为java.lang.Integer -->
        <jaxb:bindings node="xsd:simpleType[@name='integer']">
            <jaxb:javaType name="java.lang.Integer" 
                           parseMethod="javax.xml.bind.DatatypeConverter.parseInt" 
                           printMethod="javax.xml.bind.DatatypeConverter.printInt"/>
        </jaxb:bindings>
    </jaxws:bindings>
</jaxws:bindings>

方案B：针对特定消息部分映射

如果仅getNextLinkTranxNum的输出消息引用tns:integer，直接定位到该消息部分进行映射：

<jaxws:bindings xmlns:jaxws="http://java.sun.com/xml/ns/jaxws"
                xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
                xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
                xmlns:tns="http://maximus.com/assetworks/fmax-wsdl"
                version="2.1">

    <!-- 定位到getNextLinkTranxNum的输出消息的message部分 -->
    <jaxws:bindings node="wsdl:definitions/wsdl:operation[@name='getNextLinkTranxNum']/wsdl:output/wsdl:message[@name='getNextLinkTranxNumResponse']/wsdl:part[@name='message']">
        <jaxb:property>
            <jaxb:baseType name="java.lang.Integer"/>
        </jaxb:property>
    </jaxws:bindings>
</jaxws:bindings>

步骤2：执行正确的wsdl2java命令 #

使用CXF的wsdl2java工具，指定绑定文件、输出目录和包名：

wsdl2java -b bindings.xml -d ./generated-sources -p com.your.company.assetworks your-wsdl-file.wsdl

参数说明：

• -b：指定绑定文件路径
• -d：指定生成代码的输出目录
• -p：指定生成代码的Java包名

额外检查项 #

• 确保绑定文件中的targetNamespace与WSDL中的targetNamespace完全一致（包括大小写、斜杠等细节）
• 若Java版本为11及以上，使用CXF 4.x版本；Java 8使用CXF 3.x版本，避免版本兼容问题
• 若有权限修改WSDL，直接将tns:integer替换为标准的xsd:int，可省去绑定文件的配置

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