JAX-WS 内容协议的选择

为什么80%的码农都做不了架构师？>>>   

JAX-WS支持SOAP1.1,SOAP1.2和HTTP。在之前所写的所有文章中，从没有涉及到跟协议相关的内容。但是JAX-WS默认使用的是SOAP1.1协议。所以之前的所有例子，均是在使用SOAP1.1.

我们也可以使用SOAP1.2，SOAP1.2跟SOAP1.1相比

• SOAP1.2建立在XML infoset上，SOAP1.1建立在XML1.0.

• SOAP1.2不再需要SOAPAction http heander

• SOAP1.2的http contentType为application/soap+xml， 而SOAP1.1使用text/xml.

• 官网上列出了9点，比较抽象，暂时还用不到。http://www.w3.org/2003/06/soap11-soap12.html 

如果使用HTTP内容协议，JAXWS就变成了restful service。

声明内容协议绑定的方式有2种，且优先级由低到高为：

1. 在SEI实现类上使用@BindingType

2. 在sun-jaxws.xml中声明binding

下面，使用官方提供的例子，演示一遍开启soap1.2协议的webservice。

服务器端

SEI实现类

package com.mycompany;

import javax.jws.WebMethod;
import javax.jws.WebService;

@WebService
public class AddNumbers {
    
    @WebMethod(operationName="add")
    public int addNumbers(int number1, int number2) {
        return number1 + number2;
    }
}

sun-jaxws.xml

<?xml version="1.0" encoding="UTF-8"?>
<endpoints xmlns='http://java.sun.com/xml/ns/jax-ws/ri/runtime' version='2.0'>
    <endpoint
        name='soap'
        implementation='com.mycompany.AddNumbers'
        port='{http://mycompany.com/}soap'
        binding="http://www.w3.org/2003/05/soap/bindings/HTTP/"
        url-pattern='/soap'/>
</endpoints>

不需要运行wsgen命令，直接打包成math.war,部署到tomcat。

客户端

首先运行wsimport，产生客户端。由于wsgen默认是产生soap1.1的service，忽略soap1.2，需要添加命令参数 -extension 才可以产生soap1.2的service。

然后使用App中的main函数调用生成的客户端。

public class App {
    public static void main( String[] args ) throws IOException  {
        AddNumbers math = new AddNumbersService().getSoap();
        math.add(1, 2);
    }
}

监听网络查看消息

发出请求

<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
  <S:Body>
    <ns2:add xmlns:ns2="http://mycompany.com/">
      <arg0>1</arg0>
      <arg1>2</arg1>
    </ns2:add>
  </S:Body>
</S:Envelope>

返回应答

<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
  <S:Header/>
  <S:Body>
    <ns2:addResponse xmlns:ns2="http://mycompany.com/">
      <return>3</return>
    </ns2:addResponse>
  </S:Body>
</S:Envelope>

从上面可以看出，SOAP消息实体包在namespace 

http://www.w3.org/2003/05/soap-envelope

之中，这表明使用的是soap1.2.

转载于:https://my.oschina.net/xpbug/blog/261350