基于wsimport生成代码的客户端

概述

wsimport是jdk自带的命令，可以根据wsdl文档生成客户端中间代码，基于生成的代码编写客户端，可以省很多麻烦。

wsimport命令

wsimport的用法

wsimport [options]

比较常用的[options]有：

1. -d

   在指定的目录生成class文件

2. -clientjar

   在当前目录生成jar文件，结合-d 可以在指定的目录生成jar文件

3. -s

   在指定的目录生成java源文件

4. -p

   指定生成文件的包结构

5. -keep

   在生成class文件，或者jar包时，同时保留java源文件

常用的组合

在指定的目录生成指定包结构的java源文件

假设wsdl文档的uri为http://localhost:6666/service/interpret?wsdl，那么在F:\temp下，生成包结构为cn.ljl.sand.jws.chapter3.client.wsimport的java源文件的命令为：

wsimport -s F:\temp -p cn.ljl.sand.jws.chapter3.client.wsimport http://localhost:6666/service/interpret?wsdl

在指定的目录生成指定包结构的jar文件

假设wsdl文档的uri为http://localhost:6666/service/interpret?wsdl，那么在F:\temp下，生成包结构为cn.ljl.sand.jws.chapter3.client.wsimport的interpret-wsimport.jar的命令为：

wsimport -d F:\temp -clientjar interpret-wsimport.jar -p cn.ljl.sand.jws.chapter3.client.wsimport http://localhost:6666/service/interpret?wsdl

编写客户端

文件分布图

说明：cn.ljl.sand.jws.chapter3.client.wsimport中的是基于wsimport生成的代码；cn.ljl.sand.jws.chapter3.client中的是基于生成代码的客户端。

使用wsimport生成代码

指定-p cn.ljl.sand.jws.chapter3.client.wsimport

核心类介绍

wsimport生成的文件中，有两个是我们需要了解的，一个是以wsdl文档的portType元素的name为名的接口，一个是以wsdl文档的service元素的name为名的类。比如使用上述命令生成的类图如下：

比较一下，这里生成的InterpretService接口，和服务端的接口是一致的。而InterpretServiceImplService的getInterpretServiceImplPort方法，可以让我们获取InterpretService的实例，然后我们就可以像执行本地代码一样请求webservice了。

编写客户端

创建WSIClient.java，基于生成的代码访问服务。

package cn.ljl.sand.jws.chapter3.client;import java.net.MalformedURLException;import java.net.URL;import org.junit.Assert;import org.junit.Test;import cn.ljl.sand.jws.chapter3.client.wsimport.InterpretService;import cn.ljl.sand.jws.chapter3.client.wsimport.InterpretServiceImplService;public class WSIClient {

    @Test

    public void test() {

        InterpretServiceImplService ss = new InterpretServiceImplService();

        InterpretService service = ss.getInterpretServiceImplPort();

        String chnum = service.interpret(112358);

        Assert.assertEquals("一一二三五八", chnum);

    }

    @Test

    public void test2() throws MalformedURLException {

        URL url = new URL("http://localhost:6666/service/interpret?wsdl");

        InterpretServiceImplService ss = new InterpretServiceImplService(url);

        InterpretService service = ss.getInterpretServiceImplPort();

        String chnum = service.interpret(112358);

        Assert.assertEquals("一一二三五八", chnum);

    }

}

说明：

这里提供了两个测试方法：test使用最简单的方式；test2考虑到URL可能的变动，所以单独指定了URL，而这个url，可以根据需要来自配置。