javax.xml.ws.Holder的使用方式

参考文章：http://tomee.apache.org/examples-trunk/webservice-holder/README.html

在一次soap请求中可能会要求返回多个值，但是java只能返回一个对象，因此javax.xml.ws.Holder的出现就是为了解决这个问题，Holder只是一个简单的包装类，可以当作参数传递到webservice的方法中，客户端在请求期间发送Holder的值随后服务端将Holder的值当作输出参数返回。

接口

 

package com.gjb;



import javax.jws.WebService;

import javax.xml.ws.Holder;



@WebService

public interface HelloI {

	public String hehe(int a, int b, Holder<Integer> add,

			Holder<Integer> minus);

}

实现类

 

 

package com.gjb;



import javax.jws.WebParam;

import javax.jws.WebParam.Mode;

import javax.jws.WebService;

import javax.xml.ws.Endpoint;

import javax.xml.ws.Holder;



@WebService(endpointInterface = "com.gjb.HelloI")

public class Hello implements HelloI {

	@Override

	public String hehe(int a, int b,

			@WebParam(mode = Mode.OUT) Holder<Integer> add,

			@WebParam(mode = Mode.OUT) Holder<Integer> minus) {

		add.value = a + b;

		minus.value = a - b;

		return "测试完成";

	}



	public static void main(String[] args) {

		Endpoint.publish("http://localhost:8888/gjb", new Hello());

	}

}

 

holder必须要配合webparam注释的mode使用，关于这个注释，请看我的另外一篇文章webservice注释。

为了方便，实现类带了一个main方法，执行后可以发布这个服务。接着我们用wsimport命令生成客户端java文件，然后用这些文件去调用我们刚刚发布的服务。

Client类的代码如下

 

package com.gjb;



import javax.xml.ws.Holder;



public class Client {

	public static void main(String[] args) {

		HelloService hs = new HelloService();

		HelloI hi = hs.getHelloPort();

		Holder<Integer> a = new Holder<Integer>();

		Holder<Integer> b = new Holder<Integer>();

		System.out.println(hi.hehe(5, 1, a, b));

		System.out.println(a.value);

		System.out.println(b.value);

	}

}

最终输出结果如下

 

 

测试完成

6

4

wsdl文件中类型定义的内容如下

 

 

<xs:schema xmlns:tns="http://gjb.com/" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="1.0" targetNamespace="http://gjb.com/">

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

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

<xs:complexType name="hehe">

<xs:sequence>

<xs:element name="arg0" type="xs:int"/>

<xs:element name="arg1" type="xs:int"/>

<xs:element name="arg2" type="xs:int" minOccurs="0"/>

<xs:element name="arg3" type="xs:int" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="heheResponse">

<xs:sequence>

<xs:element name="arg2" type="xs:int" minOccurs="0"/>

<xs:element name="arg3" type="xs:int" minOccurs="0"/>

<xs:element name="return" type="xs:string" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

</xs:schema>

可以看到返回值有三个，而不是一个。

 

利用TCPMon这个工具，我们可以看到soap的具体内容

这是请求soap

 

POST /gjb HTTP/1.1

Accept: text/xml, multipart/related

Content-Type: text/xml; charset=utf-8

SOAPAction: ""

User-Agent: JAX-WS RI 2.2.4-b01

Host: 127.0.0.1:7777

Connection: keep-alive

Content-Length: 193



<?xml version="1.0" ?>

   <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">

      <S:Body>

         <ns2:hehe xmlns:ns2="http://gjb.com/">

            <arg0>5</arg0>

            <arg1>1</arg1>

         </ns2:hehe>

      </S:Body>

   </S:Envelope>

这是响应soap

 

 

HTTP/1.1 200 OK

Transfer-encoding: chunked

Content-type: text/xml;charset="utf-8"



<?xml version="1.0" ?>

   <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">

      <S:Body>

         <ns2:heheResponse xmlns:ns2="http://gjb.com/">

            <arg2>6</arg2>

            <arg3>4</arg3>

            <return>测试完成</return>

         </ns2:heheResponse>

      </S:Body>

   </S:Envelope>

 

版权声明：本文为博主原创文章，未经博主允许不得转载。