JAX-WS（三）wsdl详解

最新推荐文章于 2021-02-25 22:53:18 发布
最新推荐文章于 2021-02-25 22:53:18 发布
阅读量590 收藏
点赞数
分类专栏： WEB后台@JAX-WS 文章标签： java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/schy_hqh/article/details/84458912
版权
[url]http://localhost:8888/numberService?wsdl[/url] 

<?xml version="1.0"?>
<!-- Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.6 in JDK 6. -->
<!-- Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.6 in JDK 6. -->
<definitions targetNamespace="http://service.hqh.com/" name="MyServiceImplService">
  <types>
    <xsd:schema>
      <xsd:import namespace="http://service.hqh.com/" schemaLocation="http://localhost:8888/numberService?xsd=1"/>
    </xsd:schema>
  </types>
  <message name="plus">
    <part name="parameters" element="tns:plus"/>
  </message>
  <message name="plusResponse">
    <part name="parameters" element="tns:plusResponse"/>
  </message>
  <message name="minus">
    <part name="parameters" element="tns:minus"/>
  </message>
  <message name="minusResponse">
    <part name="parameters" element="tns:minusResponse"/>
  </message>
  <portType name="IMyService">
    <operation name="plus">
      <input message="tns:plus"/>
      <output message="tns:plusResponse"/>
    </operation>
    <operation name="minus">
      <input message="tns:minus"/>
      <output message="tns:minusResponse"/>
    </operation>
  </portType>
  <binding name="MyServiceImplPortBinding" type="tns:IMyService">
    <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
    <operation name="plus">
      <soap:operation soapAction=""/>
      <input>
        <soap:body use="literal"/>
      </input>
      <output>
        <soap:body use="literal"/>
      </output>
    </operation>
    <operation name="minus">
      <soap:operation soapAction=""/>
      <input>
        <soap:body use="literal"/>
      </input>
      <output>
        <soap:body use="literal"/>
      </output>
    </operation>
  </binding>
  <service name="MyServiceImplService">
    <port name="MyServiceImplPort" binding="tns:MyServiceImplPortBinding">
      <soap:address location="http://localhost:8888/numberService"/>
    </port>
  </service>
</definitions>


[b]type节点分析[/b]
type用来定义访问的类型，即方法入参的个数，类型和返回值的类型 

<definitions targetNamespace="http://service.hqh.com/" name="MyServiceImplService">
  <types>
    <xsd:schema>
      <xsd:import namespace="http://service.hqh.com/" schemaLocation="http://localhost:8888/numberService?xsd=1"/>
    </xsd:schema>
  </types>
</definitions>


[url]http://localhost:8888/numberService?xsd=1[/url] 


<?xml version="1.0"?>
<!-- Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.6 in JDK 6. -->
<xs:schema version="1.0" targetNamespace="http://service.hqh.com/">
  <!--方法A的参数-->
  <xs:element name="minus" type="tns:minus"/>
  <!--方法A的返回值-->
  <xs:element name="minusResponse" type="tns:minusResponse"/>
  <!--方法B的参数-->
  <xs:element name="plus" type="tns:plus"/>
  <!--方法B的返回值-->
  <xs:element name="plusResponse" type="tns:plusResponse"/>
  <!--方法A的参数信息-->
  <xs:complexType name="minus">
    <xs:sequence>
      <xs:element name="arg0" type="xs:int"/>
      <xs:element name="arg1" type="xs:int"/>
    </xs:sequence>
  <!--方法A的返回值信息-->
  </xs:complexType>
  <xs:complexType name="minusResponse">
    <xs:sequence>
      <xs:element name="return" type="xs:int"/>
    </xs:sequence>
  </xs:complexType>
  <!--方法B的参数信息-->
  <xs:complexType name="plus">
    <xs:sequence>
      <xs:element name="arg0" type="xs:int"/>
      <xs:element name="arg1" type="xs:int"/>
    </xs:sequence>
  </xs:complexType>
  <!--方法B的返回值信息-->
  <xs:complexType name="plusResponse">
    <xs:sequence>
      <xs:element name="return" type="xs:int"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>


[b]message节点分析[/b]
message节点用来传递消息---SOAP simple object access protocol
每个方法都有入参和返回值，这些数据就是通过message来进行传递的
客户端通过message节点传递参数到服务端，服务端执行方法，返回值又通过message节点来传递数据。一个方法至少对于2个message节点！ 

<?xml version="1.0"?>
<!-- Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.6 in JDK 6. -->
<!-- Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.6 in JDK 6. -->
<definitions targetNamespace="http://service.hqh.com/" name="MyServiceImplService">
  <types>
    <xsd:schema>
      <xsd:import namespace="http://service.hqh.com/" schemaLocation="http://localhost:8888/numberService?xsd=1"/>
    </xsd:schema>
  </types>
  <!--传递plus()的入参-->
  <message name="plus">
    <part name="parameters" element="tns:plus"/>
  </message>
  <!--传递plus()返回的消息-->
  <message name="plusResponse">
    <part name="parameters" element="tns:plusResponse"/>
  </message>
  <!--传递minus()的入参-->
  <message name="minus">
    <part name="parameters" element="tns:minus"/>
  </message>
  <!--传递minus()返回的消息-->
  <message name="minusResponse">
    <part name="parameters" element="tns:minusResponse"/>
  </message>
</definitions>


[b]portType节点分析[/b]
portType指名对外暴露的接口名称
operation 指定被访问的方法
input 指定方法的入参（指定入参对应的message）
output 指定方法的返回值（指定返回值对应的message） 

<?xml version="1.0"?>
<!-- Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.6 in JDK 6. -->
<!-- Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.6 in JDK 6. -->
<definitions targetNamespace="http://service.hqh.com/" name="MyServiceImplService">
  <types>
    <xsd:schema>
      <xsd:import namespace="http://service.hqh.com/" schemaLocation="http://localhost:8888/numberService?xsd=1"/>
    </xsd:schema>
  </types>
  <message name="plus">
    <part name="parameters" element="tns:plus"/>
  </message>
  <message name="plusResponse">
    <part name="parameters" element="tns:plusResponse"/>
  </message>
  <message name="minus">
    <part name="parameters" element="tns:minus"/>
  </message>
  <message name="minusResponse">
    <part name="parameters" element="tns:minusResponse"/>
  </message>
  <!-- 服务器端的接口 -->
  <portType name="IMyService">
    <!--接口中的方法-->
    <operation name="plus">
      <!--方法的入参通过name="tns:plus"的message传递-->
      <input message="tns:plus"/>
      <!--方法的返回值通过name="tns:plusResponse"的message传递-->
      <output message="tns:plusResponse"/>
    </operation>
    <operation name="minus">
      <input message="tns:minus"/>
      <output message="tns:minusResponse"/>
    </operation>
  </portType>
</definitions>



[b]binding节点分析[/b]
bingding节点主要用于指定SOAP消息以何种方式/样式进行传递 

<?xml version="1.0"?>
<!-- Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.6 in JDK 6. -->
<!-- Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.6 in JDK 6. -->
<definitions targetNamespace="http://service.hqh.com/" name="MyServiceImplService">
  <types>
    <xsd:schema>
      <xsd:import namespace="http://service.hqh.com/" schemaLocation="http://localhost:8888/numberService?xsd=1"/>
    </xsd:schema>
  </types>
  <message name="plus">
    <part name="parameters" element="tns:plus"/>
  </message>
  <message name="plusResponse">
    <part name="parameters" element="tns:plusResponse"/>
  </message>
  <message name="minus">
    <part name="parameters" element="tns:minus"/>
  </message>
  <message name="minusResponse">
    <part name="parameters" element="tns:minusResponse"/>
  </message>
  <portType name="IMyService">
    <operation name="plus">
      <input message="tns:plus"/>
      <output message="tns:plusResponse"/>
    </operation>
    <operation name="minus">
      <input message="tns:minus"/>
      <output message="tns:minusResponse"/>
    </operation>
  </portType>
  <!-- 指定SOAP消息传递所使用的格式 -->
  <binding name="MyServiceImplPortBinding" type="tns:IMyService">
    <!-- SOAP使用document的风格进行传递（原来使用RBC的风格） -->
    <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
    <!-- plus()的消息传递 -->
    <operation name="plus">
      <soap:operation soapAction=""/>
      <!--输入消息通过literal方式进行传递（jdk1.6之前使用SOAPMessage encode方式传递）-->
      <input>
        <soap:body use="literal"/>
      </input>
      <!--输出消息通过literal-->
      <output>
        <soap:body use="literal"/>
      </output>
    </operation>
    <!-- minus()的消息传递 -->
    <operation name="minus">
      <soap:operation soapAction=""/>
      <!--输入消息通过literal方式进行传递 -->
      <input>
        <soap:body use="literal"/>
      </input>
      <!--输出消息通过literal-->
      <output>
        <soap:body use="literal"/>
      </output>
    </operation>
  </binding>
</definitions>



[b]service节点分析[/b]
结合前面的SOAP消息传输、接口和方法（参数和返回值）的说明、SOAP消息（message）来提供一个服务
通过该服务即可调用webservice对外提供的方法 

<?xml version="1.0"?>
<!-- Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.6 in JDK 6. -->
<!-- Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.6 in JDK 6. -->
<definitions targetNamespace="http://service.hqh.com/" name="MyServiceImplService">
  <types>
    <xsd:schema>
      <xsd:import namespace="http://service.hqh.com/" schemaLocation="http://localhost:8888/numberService?xsd=1"/>
    </xsd:schema>
  </types>
  <message name="plus">
    <part name="parameters" element="tns:plus"/>
  </message>
  <message name="plusResponse">
    <part name="parameters" element="tns:plusResponse"/>
  </message>
  <message name="minus">
    <part name="parameters" element="tns:minus"/>
  </message>
  <message name="minusResponse">
    <part name="parameters" element="tns:minusResponse"/>
  </message>
  <portType name="IMyService">
    <operation name="plus">
      <input message="tns:plus"/>
      <output message="tns:plusResponse"/>
    </operation>
    <operation name="minus">
      <input message="tns:minus"/>
      <output message="tns:minusResponse"/>
    </operation>
  </portType>
  <binding name="MyServiceImplPortBinding" type="tns:IMyService">
    <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
    <operation name="plus">
      <soap:operation soapAction=""/>
      <input>
        <soap:body use="literal"/>
      </input>
      <output>
        <soap:body use="literal"/>
      </output>
    </operation>
    <operation name="minus">
      <soap:operation soapAction=""/>
      <input>
        <soap:body use="literal"/>
      </input>
      <output>
        <soap:body use="literal"/>
      </output>
    </operation>
  </binding>
  <!--指定服务的名称（同definitions的name属性）-->
  <service name="MyServiceImplService">
    <!--prot的name属性指定的端口（一个方法）将返回服务接口的一个实现，该实现基于name="MyServiceImplPortBinding"的SOAP消息定义进行创建-->
    <port name="MyServiceImplPort" binding="tns:MyServiceImplPortBinding">
      <!--指定服务对外发布的地址-->
      <soap:address location="http://localhost:8888/numberService"/>
    </port>
  </service>
</definitions>


[b]SOAP[/b]
SOAP通过[b]"信封"[/b]传递消息
[b]信封：携带方法的入参[/b] 

<?xml version="1.0"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
<!--对外发布的服务所在的包(逆序)-->
xmlns:q0="http://service.hqh.com/" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Body>
    <q0:plus>
      <arg0>1</arg0>
      <arg1>2</arg1>
    </q0:plus>
  </soapenv:Body>
</soapenv:Envelope>


[b]信封：携带方法的返回值[/b] 

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:plusResponse xmlns:ns2="http://service.hqh.com/">
      <return>3</return>
    </ns2:plusResponse>
  </S:Body>
</S:Envelope>


[b]定制SOAP中的参数名[/b]
通过注解详细说明wsdl中的参数名称，否则默认使用args0,args1...来表示形参
服务接口中使用注解定义如下： 

@WebService
public interface IMyService {
	@WebResult(name="plusResult")
	public int plus(@WebParam(name="a")int a,@WebParam(name="b")int b);

	@WebResult(name="minusResult")
	public int minus(@WebParam(name="a")int a,@WebParam(name="b")int b);
}


[b]
通过注解标注了参数后，SOAP中的参数名就是指定的名称了
[/b] 

<?xml version="1.0"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:q0="http://service.hqh.com/" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Body>
    <q0:plus>
      <a>5</a> <!--信封中参数名称为注解所标注的名称-->
      <b>7</b> <!--信封中参数名称为注解所标注的名称-->
    </q0:plus>
  </soapenv:Body>
</soapenv:Envelope>
schy_hqh
关注
专栏目录
jax ws wsdl2java,jax-ws发布WS，用axis的wsdl2java生成的客户端调用有有关问题
weixin_35029653的博客
03-16 168
jax-ws发布WS，用axis的wsdl2java生成的客户端调用有问题本帖最后由 lg_asus 于 2012-06-20 15:58:38 编辑我用jax-ws发布一个简易的WS，jdk版本是1.6.11,axis版本是1.4，我没用容器如tomcat。代码如下@WebService@SOAPBinding(style=SOAPBinding.Style.RPC)publicinter...
JAX-WS与WSDL的映射关系
Laurence的技术博客
05-19 9280
      JAX-WS实际上就是将java组件映射成webservice的一组规范，一方面，它通过一组注解可以将一个java类映射出一个WSDL文件（确切地说是portType部分），这种映射关系如下图。另一方面，通过JAXB，它又能将WSDL中的复杂数据类型和java类之间进行映射，因此我们可以简单地说：JAX-WS就是一组将java类（组件）描述为web service的规范。
JAX-WS使用教程
09-17
JAX-WS使用教程，包括wsdl生成java代码，和从java生成wsdl
JAX-WS（二）通过wsimport解析wsdl
一名菜鸟攻城师
07-15 524
[b]1.使用wsimport命令将wsdl转换为本地的java接口[/b] [b]wsimport 是java提供的命令，专门用来对wsdl文件进行解析，并转换为本地的java文件[/b] 命令： wsimport -d E:\technology-hqh\proj\webservice\JAX-WS\wsimport_01 -keep http://localhost:8888/numb...
jax-ws 注释详解
weixin_34396902的博客
08-19 188
网络资料来源http://pic.dhe.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=%2Fcom.ibm.websphere.wsfep.multiplatform.doc%2Finfo%2Fae%2Fae%2Frwbs_jaxwsannotations.html基于 XML 的 Web Service 的 Java AP...
java wsdl jaxws_spring – jaxws wsdl解析问题
weixin_42503482的博客
02-16 765
我有一个使用JAX-WS创建的WebService,我编写了一个JUnit,以下列方式连接到它：public class LicenseSvcClient {private static final String WS_URL = "https://dubdubdub.com/licenseService?wsdl";private static LicenseService licenseSer...
jax-rs jax-ws所需包，亲测可用
09-19
**JAX-RS与JAX-WS详解：** 1. **JAX-RS**（Java API for RESTful Web Services）是Java平台上的REST（Representational State Transfer）风格Web服务的标准。REST是一种轻量级的架构风格，它基于HTTP协议，利用URL...
jax-ws handler 的详解及简单实例
08-29
JAX-WS Handler 是 Java API for XML Web Services (JAX-WS) 中的一个关键组件，它提供了一种在服务端和客户端处理消息的机制，类似于面向切面编程（AOP）的概念。Handler 可以在 Web Service 请求和响应之间插入...
webservice之jax-ws
04-22
JAX-WS可以自动生成WSDL文件。 - **SOAP绑定**：将SEI的方法映射到SOAP消息。 - **SOAP消息处理**：包括SOAP消息的生成和解析，以及错误处理。 - **端点发布**：将Java服务实例发布为Web服务，使得客户端可以通过...
JAX-WS规范
04-16
**JAX-WS规范详解** Java API for XML Web Services（JAX-WS）是Java平台上的一个标准，用于创建Web服务和客户端。它提供了一种简单、类型安全的方式来构建和消费基于SOAP的消息传递应用程序，是Java世界中实现Web...
JAX-WS开发webservice示例详解
06-01
**JAX-WS开发Web服务示例详解** Java API for XML Web Services (JAX-WS) 是Java平台上的一个标准，用于开发基于SOAP协议的Web服务。它简化了Web服务的创建、部署和消费，使得开发者可以使用面向对象的方式来处理...
JAX-WS和WSDL两个概念的理解
HAPP NEW JAVA
05-22 1854
Java API for XML Web Services (JAX-WS)是Java程序设计语言一个用来创建Web服务的API。JAX-WS是sun的Java企业平台一部分。和其它Java EE的API一样，JAX-WS使用了Java SE 5引入的Java 标注机制来简化Web服务客户端和服务端的开发和部署。 JAX-WS的参考实现是作为一个开源项目开发的，是GlassFish项目的一部
JAX-WS Web 服务开发调用和数据传输分析
编程的本质是数学问题
03-08 1118
增加一个add的服务 import javax.jws.WebService; import javax.jws.WebMethod; import javax.jws.WebParam; /** * * @author Administrator */ @WebService(serviceName = "CalculatorWS") public class CalculatorWS
java对外服务前缀修改_java – 更改使用JAXWS生成的默认XML命名空间前缀
weixin_32818365的博客
02-25 264
也许对你来说太迟了,我不知道这是否可以工作,但是你可以试试.首先,您需要实现一个SoapHandler,并且在handleMessage方法中可以修改SOAPMessage.我不知道您是否可以直接修改该前缀,但可以尝试：public class MySoapHandler implements SOAPHandler{@Overridepublic boolean handleMessage(SO...
安卓开发 调用 jax-ws 格式的webservices
mfc2003的专栏
12-04 2490
在研究HTML5 写移动客户端程序， 在想和后台数据交互的问题。 html5 通过 jquery  get/post /getjson/ajax 可以很方便和后台 servlet 或者action交互，但要直接访问webserivces 好像资料很少 昨天研究jax-rs 未成功，暂时不研究了。 以后碰到了再研究，目前jax-ws 足够使用。   今天重新温习了一下 andorid下 调用
WebService wsdl没有types的问题
KIWI的专栏
01-31 741
刚学WebService就遇到一个问题，按视屏敲的代码，它生成的wsdl页面与自己的不一样，我的没有types,结构完全不同了 This XML file does not appear to have any style information associated with it. The document tree is shown below. &lt;!-- Published b...
实现WebService几种方式之JAX-WS详解
csdn_1364491554的博客
12-19 6623
介绍 前文提到了WebService是一种跨语言和操作系统的远程调用技术，WebService如此强大，市面上关于它的技术也是层出不穷，下面便是WebService的JAVA原生实现–JAX-WS： JAX-WS(Java API for XML Web Services)规范是一组XML web services的JAVA API，JAX-WS允许开发者可以选择RPC-oriented或者me...
使用XMLStreamWriter写XML
一名菜鸟攻城师
07-27 2227
[code="java"] package com.hqh.stax; import javax.xml.stream.FactoryConfigurationError; import javax.xml.stream.XMLOutputFactory; import javax.xml.stream.XMLStreamException; import javax.xml.s...
JAVA WebService详解：JAX-WS、JAX-RPC与JAX-RS
JAX-WS支持WSDL 2.0，并且强调基于注解的编程模型，简化了服务的开发和部署。然而，它不再支持RPC/encoded样式的服务，这意味着JAX-WS与JAX-RPC不完全向后兼容。 3. **JAX-RS** (Java API for RESTful Web Services...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值