WebService学习之旅(2):调用WebService服务

WebService能够使运行在不同机器上的不同应用无需借助附加的、专门的第三方软件或引荐，就可相互交换数据或集成。依据WebService的规范实施的应用之间，无论它们所使用的语言、平台或内部协议是什么，都可以相互交换数据。

WebService就是一个部署在web服务器上的应用程序，它向外界暴露出一个能够通过web进行调用的API。这就是说，能用编程的方法通过web来调用这个应用程序。我们把调用这个WebService的应用程序称为客户端，发布这个web服务的机器称为WebService服务器。

架构趋势(WebService架构）：

现在项目可能存在多种类型的终端，例如ipad等终端可能只有页面，需要远程调用控制层或业务逻辑。

一、调用已发布的WebService服务

接下来就以查询手机号码归属地为例，看看程序是如何调用WebService服务。
在开始写代码之前，首先需要添加HttpClient依赖,HttpClient是一款测试工具，可以在java代码中模拟HTTP请求协议。

maven依赖:

<dependency>
    <groupId>commons-httpclient</groupId>
    <artifactId>commons-httpclient</artifactId>
    <version>3.1</version>
</dependency>

登录http://www.webxml.com.cn在最新web services中找到国内手机号码归属地查询WEB服务：

点击进入如下页面：

点击getMobileCodeInfo可以看到有SOAP1.1、SOAP1.2、HTTP GET、HTTP POST四种请求方式，接下来先看看HTTP GET请求。

1.1 get请求

上面一段表示发送请求数据格式、下面一段表示返回的数据格式。

代码清单:

/**
 * 调用第三方ws服务，查询手机号码归属地
 *
 */
public class PhoneClient {

    public static void main(String[] args) throws IOException {
        
        String number = "13888888888";

        get(number);
    }

    public static void get(String number) throws IOException {
        // 创建浏览器对象
        HttpClient httpClient = new HttpClient();

        String url = "http://ws.webxml.com.cn" +
                "/WebServices/MobileCodeWS.asmx/getMobileCodeInfo?mobileCode="+ number +"&userID=";

        // 填写数据，发送请求
        GetMethod getMethod = new GetMethod(url);
        int code = httpClient.executeMethod(getMethod);

        System.out.println("http状态:" + code);

        String result = getMethod.getResponseBodyAsString();
        System.out.println("返回结果为：" + result);
    }
}

【测试结果】：

http状态:200
返回结果为：<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://WebXml.com.cn/">13888888888：云南 昆明 云南移动合家欢卡</string>

1.2 post请求

同样地，上面的部分表示请求的数据格式和响应，下面的部分表示返回数据

代码清单：

/**
 * 调用第三方ws服务，查询手机号码归属地
 *
 */
public class PhoneClient {

    public static void main(String[] args) throws IOException {

        String number = "13888888888";

        post(number);
    }

    public static void post(String number) throws IOException {
        // 创建浏览器对象
        HttpClient httpClient = new HttpClient();

        String url = "http://ws.webxml.com.cn" +
                "/WebServices/MobileCodeWS.asmx/getMobileCodeInfo";

        // 填写数据，发送请求
        PostMethod postMethod = new PostMethod(url);
        postMethod.setParameter("mobileCode", number);
        postMethod.setParameter("userID", "");

        int code = httpClient.executeMethod(postMethod);
        System.out.println("http状态:" + code);

        String result = postMethod.getResponseBodyAsString();
        System.out.println("返回结果为：" + result);
    }
}

【测试结果】：

http状态:200
返回结果为：<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://WebXml.com.cn/">13888888888：云南 昆明 云南移动合家欢卡</string>

上面的两种方式本质上依然是http请求。

1.3 soap方式调用WebService

soap即简单对象访问协议。

从上图中发现用的依然是http post方法，但是请求的数据格式变成了XML，有利于数据的维护。

我们使用流的方式读取请求的数据格式，在resources文件下添加soap.txt文件：

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <getMobileCodeInfo xmlns="http://WebXml.com.cn/">
      <mobileCode>13888888888</mobileCode>
      <userID></userID>
    </getMobileCodeInfo>
  </soap:Body>
</soap:Envelope>

代码清单：

/**
 * 调用第三方ws服务，查询手机号码归属地
 *
 */
public class PhoneClient {

    public static void main(String[] args) throws Exception {

        soap();
    }

    public static void soap() throws IOException {
        // 创建浏览器对象
        HttpClient httpClient = new HttpClient();

        String url = "http://ws.webxml.com.cn" +
                "/WebServices/MobileCodeWS.asmx";

        PostMethod postMethod = new PostMethod(url);

        // 传输XML数据，通过流的方式加载xml数据
        String filepath = "D:\\IDEASpace\\WebService-Sample\\MyClient\\src\\main\\resources\\soap.txt";
        postMethod.setRequestBody(new FileInputStream(filepath));

        int code = httpClient.executeMethod(postMethod);
        System.out.println("http状态:" + code);

        String result = postMethod.getResponseBodyAsString();
        System.out.println("返回结果为：" + result);
    }
}

【测试结果】：

这是因为post请求格式默认为：

Content-Type: application/x-www-form-urlencoded

当使用soap是需要指定：

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

那么，手动设置一下Content-Type的值，添加一行代码：

postMethod.setRequestHeader("Content-Type", "text/xml;charset=utf-8");

二、使用wsimport生成客户端代码并调用ws服务

通过HttpClient工具模拟http请求在java bean调用ws服务获取手机查询功能。调用的方式：get/post/soap。本质上还是通过http方式调用，只是调用的时候可以传输XML数据。HttpClient是java调用http协议的解决方案，这就有了语言瓶颈，只能限于java语言。

WebService推荐的解决方案：wsimport命令

接下来，打开jdk的安装目录，在bin下可以看到这样一个命令：

这个就是java的ws解决方案。

首先，在号码归属地页面找到服务说明。点击进入获取的它网址：
http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?WSDL

1.命令：

wsimport http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?WSDL

解析WSDL(WS描述语言)，解析完成后生成Java Bean

2.命令：

wsimport -s .  http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?WSDL

解析完成后生成class和java源文件

3.命令：

wsimport -s . -p com.xxyh.webservice  http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?WSDL

解析完成后生成class和java源文件，及自定义包结构：

接着，将java源文件添加进项目：

我们在com.xxyh.webservice包下创建一个PhotoMain类：

public class PhoneMain {

    public static void main(String[] args) {
        // 获取一个ws服务
        MobileCodeWS ws = new MobileCodeWS();

        // 获取具体的服务类型get post soap1.1 soap1.2
        MobileCodeWSSoap wsSoap = ws.getMobileCodeWSSoap();
        String address = wsSoap.getMobileCodeInfo("13888888888", null);

        System.out.println("手机归属地信息为:" + address);
    }
}

【测试结果】：

手机归属地信息为:13888888888：云南 昆明 云南移动合家欢卡