【Java EE 学习 80 下】【调用WebService服务的四种方式】【WebService中的注解】

不考虑第三方框架，如果只使用JDK提供的API，那么可以使用三种方式调用WebService服务；另外还可以使用Ajax调用WebService服务。

预备工作：开启WebService服务，使用jdk命令wsimport生成调用源代码

package com.kdyzm.ws;
import javax.jws.WebService;
import javax.xml.ws.Endpoint;
@WebService
public class MyWsServer {
    public String calculate(int input){
        System.out.println("接收到请求数据："+input);
        return input*input+"";
    }
    public static void main(String[] args) {
        Endpoint.publish("http://localhost:9090/ws", new MyWsServer());
        System.out.println("server ready ......");
    }
}

　　生成源代码命令：

wsimport -s . http://localhost:9090/ws?wsdl

　　可能出现的问题参考：http://blog.sina.com.cn/s/blog_924d6a570102w21v.html

　　因为出现了上述问题，所以本次测试环境使用jdk 1.7。

方法一:使用最简单、效率最高的方法调用WebService服务

　　将生成的java文件包括文件夹直接导入项目，并使用其提供的API。

package com.kdyzm.call.method;

import com.kdyzm.ws.MyWsServer;
import com.kdyzm.ws.MyWsServerService;

/**
 * 第一种方式就是使用wsimport命令获取所有的需要调用的代码，并直接使用这些代码完成任务
 * @author kdyzm
 *
 */
public class Method1 {
    public static void main(String[] args) {
        MyWsServerService myWsServerService=new MyWsServerService();
        MyWsServer myWsServer=myWsServerService.getMyWsServerPort();
        String result=myWsServer.calculate(2);
        System.out.println(result);
    }
}

　　客户端控制台打印结果：4

　　服务端控制台打印结果：

　　

　　这种方式是使用最多的方式，也是最不容易出错、效率最高的方式，推荐使用这种方式。

方法二：使用URLConnection调用WebService服务

　　URLConnection是JDK最底层的类，所有的网络服务底层都要使用到该类，现在尝试直接使用该类操作调用WebService服务的过程，但是首先需要获取SOAL格式的请求体，可以使用之前介绍的Web Service Explorer浏览器捕获请求体，并将该请求体进行处理转换成字符串的格式（对"进行转义"）。

　　使用这种方法不依赖于任何服务端提供的类和接口，只需要知道SOAP请求体的内容即可。

　　SOAL请求体：

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:q0="http://ws.kdyzm.com/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soapenv:Body>
        <q0:calculate>
            <arg0>2</arg0>
        </q0:calculate>
    </soapenv:Body>
</soapenv:Envelope>

　　转换成String字符串：

String requestMessage = "<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" "
                + "xmlns:q0="http://ws.kdyzm.com/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" "
                + "xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">" + "<soapenv:Body>" + "    <q0:calculate>"
                + "        <arg0>2</arg0>" + "    </q0:calculate>" + "</soapenv:Body>" + "</soapenv:Envelope>";

　　测试代码：

package com.kdyzm.call.method;

import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.PrintWriter;
import java.net.HttpURLConnection;
import java.net.URL;

/**
 * 第二种方式是使用UrlConnecction调用WebService服务。
 */
public class Method2 {
    public static void main(String[] args) throws Exception {
        // 服务的地址
        URL url = new URL("http://localhost:9090/ws");

        HttpURLConnection connection = (HttpURLConnection) url.openConnection();
        connection.setDoInput(true);
        connection.setDoOutput(true);

        connection.setRequestMethod("POST");
        connection.setRequestProperty("Content-Type", "text/xml;charset=utf-8");
        OutputStream os = connection.getOutputStream();
        PrintWriter pw = new PrintWriter(os, true);
        String requestMessage = "<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" "
                + "xmlns:q0="http://ws.kdyzm.com/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" "
                + "xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">" + "<soapenv:Body>" + "    <q0:calculate>"
                + "        <arg0>2</arg0>" + "    </q0:calculate>" + "</soapenv:Body>" + "</soapenv:Envelope>";
        // 发起请求
        pw.println(requestMessage);

        InputStream is = connection.getInputStream();
        BufferedReader br = new BufferedReader(new InputStreamReader(is));
        String temp = null;

        System.out.println("响应结果是：");
        while ((temp = br.readLine()) != null) {
            System.out.println(temp);
        }
        pw.close();
        os.close();
        br.close();
        is.close();
    }
}

　　结果和方法一种的结果相同。

方法三：使用JDK提供的WebService相关API实现对WebService的服务调用

　　使用这种方法只需要一个接口：MyWsServer就可以了，该接口也是通过wsimport命令获取的，它和服务端对应的服务类同名。

package com.kdyzm.call.method;

import java.net.URL;

import javax.xml.namespace.QName;
import javax.xml.ws.Service;

import com.kdyzm.ws.MyWsServer;

/**
 * 第三种方式：通过客户端编程实现Serice的远程调用
 * 使用这种方式只需要知道一个MyWsServer接口就可以了。
 * @author kdyzm
 *
 */
public class Method3 {
    public static void main(String[] args) throws Exception {
        URL url = new URL("http://localhost:9090/ws?wsdl");
        Service service=Service.create(url, new QName("http://ws.kdyzm.com/", "MyWsServerService"));
        MyWsServer myWsServer=service.getPort(new QName("http://ws.kdyzm.com/", "MyWsServerPort"),MyWsServer.class);
        String result=myWsServer.calculate(2);
        System.out.println(result);
    }
}

　　服务端和客户端的控制台打印结果同上。

方法四：使用Ajax调用WebService服务

　　这里使用原生的js来操作该过程：

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
<script type="text/javascript">
    function ajaxFunction() {
        var xmlHttp;
        try {
            // Firefox, Opera 8.0+, Safari
            xmlHttp = new XMLHttpRequest();
        } catch (e) {
            // Internet Explorer
            try {
                xmlHttp = new ActiveXObject("Msxml2.XMLHTTP");
            } catch (e) {

                try {
                    xmlHttp = new ActiveXObject("Microsoft.XMLHTTP");
                } catch (e) {
                    alert("您的浏览器不支持AJAX！");
                }
            }
        }
        return xmlHttp;
    }
</script>
</head>
<body>
    <div id="content"></div>
    <!-- 第四种方式：使用ajax的方式请求调用WebService服务 -->
    <script type="text/javascript">
        var xmlHttp = ajaxFunction();
        var wsUrl = "http://localhost:9090/ws";
        var requestMessage = "<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" "
            + "xmlns:q0="http://ws.kdyzm.com/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" "
            + "xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">"
                + "<soapenv:Body>"
                + "    <q0:calculate>"
                + "        <arg0>2</arg0>"
                + "    </q0:calculate>"
                + "</soapenv:Body>"
                + "</soapenv:Envelope>";
        xmlHttp.open("POST", wsUrl, true);
        xmlHttp.setRequestHeader("Content-Type", "text/xml;charset=utf-8");
        xmlHttp.onreadystatechange = _callback;
        xmlHttp.send(requestMessage);
        function _callback() {
            if (xmlHttp.readyState == 4) {
                if (xmlHttp.status == 200) {
                    var retXml = xmlHttp.responseXML;
                    var result = retXml.getElementsByTagName("return")[0];
                    document.getElementById("content").innerHTML = result.firstChild.nodeValue;;
                }
            }
        }
    </script>
</body>
</html>

　　注意，result对象是[Object Element]类型的，需要调用.firstChild.nodeValue方法获取文本值。

　　使用这种方式只适合在IE浏览器中使用，使用谷歌浏览器或者火狐浏览器都失败了，出现的异常情况： xmlHttp.open("POST", wsUrl, true);这句代码设置了请求方式是POST，但是实际上没管用，请求方式变成了OPTION，statckOverFlow上有人解释先使用OPTION的请求方式测试和服务器的连通性，然后才使用POST方式发送请求数据，所以服务器才会报出：

　　

　　不管说法是否正确，该问题在这里暂时没法解决，先存档；在IE中运行正常：

　　

　　服务器控制台打印结果同上。

 注解

　　WebService的注解包括：@WebService，@WebMethod，@WebResult，@WebParam，具体使用方法见下图

　　还有一个最重要的注解，使用该注解能够将服务发布为符合SOAP1.2规范的WebService服务：

　　@BindingType(value=SOAPBinding.SOAP12HTTP_BINDING)

　　客户端使用SOAP1.1可以正常调用服务端1.2的服务，但是反之则不行，所以最好将发布的服务都做成SOAP1.2的。