`
schy_hqh
  • 浏览: 556061 次
  • 性别: Icon_minigender_1
社区版块
存档分类
最新评论

JAX-WS（三）wsdl详解

 
阅读更多
http://localhost:8888/numberService?wsdl 
<?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>


type节点分析
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>


http://localhost:8888/numberService?xsd=1 

<?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>


message节点分析
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>


portType节点分析
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>


binding节点分析
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>


service节点分析
结合前面的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>


SOAP
SOAP通过"信封"传递消息
信封：携带方法的入参 
<?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>


信封：携带方法的返回值 
<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>


定制SOAP中的参数名
通过注解详细说明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);
}



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

<?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>
分享到：
| Editplus安装xml格式器
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

    jax-rs jax-ws所需包，亲测可用

    **JAX-RS与JAX-WS详解：** 1. **JAX-RS**（Java API for RESTful Web Services）是Java平台上的REST（Representational State Transfer）风格Web服务的标准。REST是一种轻量级的架构风格，它基于HTTP协议，利用URL...

    JAX-WS规范

    **JAX-WS规范详解** Java API for XML Web Services（JAX-WS）是Java平台上的一个标准，用于创建Web服务和客户端。它提供了一种简单、类型安全的方式来构建和消费基于SOAP的消息传递应用程序，是Java世界中实现Web...

    webservice之jax-ws

    JAX-WS可以自动生成WSDL文件。 - **SOAP绑定**：将SEI的方法映射到SOAP消息。 - **SOAP消息处理**：包括SOAP消息的生成和解析，以及错误处理。 - **端点发布**：将Java服务实例发布为Web服务，使得客户端可以通过...

    jax-ws用户指南 pdf版

    ### JAX-WS 2.2 用户指南知识点详解 #### 概览 JAX-WS (Java API for XML Web Services) 是 Java 平台上用于开发和实现 Web 服务的官方标准之一。本用户指南详细介绍了 JAX-WS 2.2 版本的功能、编程模型以及如何...

    设计与开发 JAX-WS 2.0 Web 服务

    - **添加注解**：在服务接口和实现类上添加必要的JAX-WS注解，例如`@WebService`和`@WebMethod`等，用以指导工具生成相应的WSDL文件和其他元数据。 3. **示例：订单处理Web服务** - **服务接口定义**：创建一个...

    jax-ws步骤

    **Java JAX-WS 步骤详解** Java JAX-WS (Java API for XML Web Services) 是一种标准的 Java 框架，用于创建和消费 Web 服务。它简化了 Web 服务的开发过程，无需复杂的配置文件，而是通过注解来定义服务接口和服务...

    JAX-WS Webservice

    **JAX-WS Web服务详解** Java API for XML Web Services（JAX-WS）是Java平台上用于构建和消费Web服务的标准API。它基于SOAP（Simple Object Access Protocol），用于创建面向服务架构（SOA）中的服务。JAX-WS是...

    JAX-WS 2.2 Jar包

    **JAX-WS 2.2 Jar包详解** JAX-WS（Java API for XML Web Services）是Java平台上用于创建和消费Web服务的标准API。它提供了面向服务架构（SOA）的模型，使得开发人员能够方便地在Java环境中构建、部署和使用Web...

    JAX-WS开发webservice示例详解

    **JAX-WS开发Web服务示例详解** Java API for XML Web Services (JAX-WS) 是Java平台上的一个标准，用于开发基于SOAP协议的Web服务。它简化了Web服务的创建、部署和消费，使得开发者可以使用面向对象的方式来处理...

    JAX-WS2.0规范

    ### JAX-WS 2.0 规范详解 #### 一、概述 JAX-WS（Java API for XML Web Services）2.0 是一种用于创建和访问 Web 服务的标准 Java API，它允许开发人员使用 Java 编写 Web 服务，并以 XML 的形式进行数据交换。JAX...

    JAX-WS 实现WebService发布

    **JAX-WS实现Web Service发布的详解** JAX-WS（Java API for XML Web Services）是Java平台上用于创建Web服务的标准API，它简化了Web服务的开发、部署和消费过程。JAX-WS允许开发者使用Java语言来定义和实现Web服务...

    Jax-WS的配置方式

    **Jax-WS详解与配置指南** Jax-WS（Java API for XML Web Services）是Java平台上的一个标准，用于创建和消费Web服务。它提供了一种基于SOAP（Simple Object Access Protocol）的、类型安全的方式来处理Web服务。...

    JAX-WS Five Minute Tutorial 源码

    **JAX-WS详解** Java API for XML Web Services (JAX-WS) 是Java平台上的一个标准组件，用于构建和消费Web服务。它提供了一种简单、类型安全的方式来创建和访问基于SOAP的消息传递应用程序。本教程将深入探讨JAX-WS...

    将铲子朝向JAX-WS

    1. **SOAP与WSDL**：JAX-WS是基于SOAP的，SOAP是一种XML格式的消息传递协议，用于在Web服务之间交换结构化信息。WSDL（Web Services Description Language）是用来定义服务接口的XML格式，描述了服务的位置、操作...

    jax-ws服务端所需的完整jar包

    **JAX-WS服务端所需完整Jar包详解** Java API for XML Web Services（JAX-WS）是Java平台上用于创建Web服务的标准API，它简化了服务端开发过程，提供了基于SOAP的消息交换支持。本篇文章将深入探讨JAX-WS服务端开发...

    JAX-WS_Java API for XML Web Services

    **JAX-WS: Java API for XML Web Services详解** JAX-WS，全称为Java API for XML Web Services，是Java平台上的一个标准组件，用于构建和消费基于Web服务的应用程序。它提供了一种简单且直观的方式来创建、部署和...

    JAX-WS2.2规约

    ### JAX-WS 2.2 规范详解 #### 一、概述 JAX-WS（Java API for XML-based Web Services）2.2规范是由JCP（Java Community Process）组织发布的一个重要的技术文档，该文档对JAX-WS 2.2版本进行了详尽的说明。对于...

    jax-ws tuto

    ### JAX-WS 教程：服务器端与客户端详解 #### 概览 JAX-WS（Java API for XML Web Services）是Java平台标准的一部分，用于开发和部署Web服务。它简化了Web服务的开发过程，允许将普通的Java对象（POJO）轻松地...

    上传一个基于Jax-ws的WebService

    【标题】：“基于Jax-ws的WebService”详解 在Web服务的世界中，JAX-WS（Java API for XML Web Services）是Java平台上的标准，用于创建和消费SOAP（Simple Object Access Protocol）服务。它提供了从Java类到SOAP...

    jax-ws基于web容器发布webServer

    2. **服务接口定义**：使用JAX-WS，你可以通过Java注解来定义服务接口，如`@WebService`，这将自动生成服务的WSDL（Web Service Description Language）文件。 3. **服务实现**：实现服务接口，提供具体的服务逻辑...

Magicbox
Global site tag (gtag.js) - Google Analytics