java wsdl 中不显示参数属性类型的问题解决方案

最新推荐文章于 2024-04-24 22:50:14 发布

weixin_33857230

最新推荐文章于 2024-04-24 22:50:14 发布

阅读量1.4k

点赞数

文章标签： java

原文链接：https://my.oschina.net/u/3358860/blog/3051567

版权

2019独角兽企业重金招聘Python工程师标准>>>

CXF3.0.1解决方案：
配合spring方式

<jaxws:endpoint id="receiveUMSMessageService" implementor="com.sw.extInterface.webservice.service.impl.ReceiveUMSMessageServiceImpl"
address="/ReceiveUMSMessageService" implementorClass="com.sw.extInterface.webservice.service.ReceiveUMSMessageService" />

======================= old =====================
最近采用CXF写了webservice接口，但是生成的wsdl却没有参数。

首先介绍一下JWS的注解：
Java Web Service (JWS) 注释类型是 Web Service 的核心之一。

（一）类级别

[b]@javax.jws.WebService(targetNamespace = "", name = "",serviceName = "") [/b]

targetNamespace :生成的 WSDL 中使用的名称空间
name:Web Service 的名称，映射到 WSDL 文件中的 <wsdl:portType> 元素
serviceName: Web Service 的服务名,映射到 WSDL 文件<wsdl:service> 元素。

[b]@javax.jws.soap.SOAPBinding(parameterStyle = javax.jws.soap.SOAPBinding.ParameterStyle.BARE) [/b]

用于指定 Web Service 到 SOAP 消息协议的映射。

parameterStyle :确定方法参数是否表示整个消息正文，或者参数是否是包装在以操作命名的顶层元素中的元素。默认值：javax.jws.soap.SOAPBinding.ParameterStyle.WRAPPED

（二）方法级别

[b]@javax.jws.WebResult(name = "", targetNamespace = "", partName = "")[/b]

name:指定生成的 WSDL 中的操作结果的名称, 默认名称“return”。

[b]@javax.jws.WebMethod(operationName="") [/b]

operationName: 指定方法公开的公共操作名，映射到 WSDL 文件中的 <wsdl:operation> 元素。没有这个属性的话，操作的公共名称将与方法名相同。

[b]@javax.jws.WebParam(name="",targetNamespace="") [/b]

name: 指定输入参数名,而不是该参数的Java 名称“input”。

注释描述部分转载至：[url]http://suky.iteye.com/blog/692279[/url]

========================================

那么为什么参数类型不在wsdl上显示呢？

原因就在targetNamespace上。
增加webservice interface和webservice impl的@webservice注解的targetNamespace属性。
同时接口方法参数前@WebParam注解。
接口代码，实现类就不展示了

@WebService(targetNamespace="http://ucp.xxx.com")
public interface IMsgBusService {

   /**
   * 接收上行数据，DB数据存储
   * @param username 用户
   * @param password 密码
   * @param msgsObj 消息对象
   * @return 消息状态
   */
   @WebMethod
   Response showMsg(@WebParam(name = "username") String username,
           @WebParam(name = "password") String password,
           @WebParam(name = "msgsObj") MultiMessages msgsObj);

}

[color=red]注意：接口与实现类的targetNamespace属性的值必须一致。[/color]

<?xml version='1.0' encoding='UTF-8'?><wsdl:definitions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:tns="http://impl.service.bus.ucp.xxx.com/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:ns2="http://schemas.xmlsoap.org/soap/http" xmlns:ns1="http://service.bus.ucp.xxx.com/" name="MsgBusServiceImpl" targetNamespace="http://impl.service.bus.ucp.xxx.com/">
<wsdl:import location="http://localhost/ucp/webservice/msgBusService?wsdl=IMsgBusService.wsdl" namespace="http://service.bus.ucp.xxx.com/">
</wsdl:import>
<wsdl:binding name="MsgBusServiceImplSoapBinding" type="ns1:IMsgBusService">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="showMsg">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="showMsg">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="showMsgResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="MsgBusServiceImpl">
<wsdl:port binding="tns:MsgBusServiceImplSoapBinding" name="MsgBusServiceImplPort">
<soap:address location="http://localhost/ucp/webservice/msgBusService"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

<xs:element name="showMsg" type="tns:showMsg"/>

<xs:element name="showMsgResponse" type="tns:showMsgResponse"/>

<xs:complexType name="showMsg">
<xs:sequence>
<xs:element minOccurs="0" name="username" type="xs:string"/>
<xs:element minOccurs="0" name="password" type="xs:string"/>
<xs:element minOccurs="0" name="msgsObj" type="tns:multiMessages"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="multiMessages">
<xs:sequence>
<xs:element minOccurs="0" name="accessType" type="xs:string"/>
<xs:element minOccurs="0" name="id" type="xs:string"/>
<xs:element name="msgCount" type="xs:int"/>
<xs:element maxOccurs="unbounded" minOccurs="0" name="msgList" nillable="true" type="tns:multiMessage"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="multiMessage">
<xs:sequence>
<xs:element minOccurs="0" name="content" type="xs:string"/>
<xs:element minOccurs="0" name="description" type="xs:string"/>

<xs:element minOccurs="0" name="destAgentId" type="xs:string"/>
<xs:element minOccurs="0" name="destination" type="xs:string"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="showMsgResponse">
<xs:sequence>
<xs:element minOccurs="0" name="return" type="tns:response"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="response">
<xs:sequence>
<xs:element minOccurs="0" name="message" type="xs:string"/>
<xs:element minOccurs="0" name="status" type="xs:string"/>
</xs:sequence>
</xs:complexType>

</xs:schema>
</wsdl:types>
<wsdl:message name="showMsg">
<wsdl:part element="tns:showMsg" name="parameters">
</wsdl:part>
</wsdl:message>
<wsdl:message name="showMsgResponse">
<wsdl:part element="tns:showMsgResponse" name="parameters">
</wsdl:part>
</wsdl:message>
<wsdl:portType name="IMsgBusService">
<wsdl:operation name="showMsg">
<wsdl:input message="tns:showMsg" name="showMsg">
</wsdl:input>
<wsdl:output message="tns:showMsgResponse" name="showMsgResponse">
</wsdl:output>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="MsgBusServiceImplSoapBinding" type="tns:IMsgBusService">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="showMsg">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="showMsg">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="showMsgResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="MsgBusServiceImpl">
<wsdl:port binding="tns:MsgBusServiceImplSoapBinding" name="IMsgBusService">
<soap:address location="http://localhost/ucp/webservice/msgBusService"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>