WSDL文件生成

1. 背景

有过WEB开发的读者，相信对什么是B/S结构并不会陌生。在B/S结构下，应用的逻辑完全在应用服务器实现，用户表现完全在web服务器上实现，客户端只需要浏览器即可进行业务处理。对，客户一般都是通过浏览器来操作的。但是随着科技的发展，我们现在要想访问应用的服务器，不仅可以用浏览器，还可以用POS机、ATM机等。使用这些不是浏览器的工具，那么在开发中，可能最头痛的无非就是如何测试了。总不可以，真的用POS机来测试吧，不过测试价格还行，可行；要是ATM机呢？那该怎么办？所以，我们需要借助其它工具来帮助测试。笔者知道的也就是SoapUI的工具，这个也是笔者在工作中要用的测试工具。可是，笔者就是好奇，SoapUI是工作的呢？也就是客户发起了一笔交易，是通过SoapUI(假设)是怎样进入到系统后端的呢？带着这样的疑惑我们进入今天的博客。

2. 例子说明

这里笔者将通过一个例子来说明如何生成WSDL的文件 ，及如何用SoapUI的工具来测试。这样的话同，读者就可以知道SoapUI如何来模拟第三方的系统测试了。这里，笔者会创建一个User类，由于是例子，所以笔者没有使用数据库，只是规定好了，用户名要为”owen”,密码要为”1234”来实现用户的登录测试。记住，用户的登录不再使用浏览器，而是用SaopUI工具来实现。(源码下载：git@github.com:owenwilliam/WSDL.git)

3. 生成WSDL文件

笔者这里规定UserLogin类作为用户登录时的接口类，也就是SoapUI发起请求，最先调用的就是这个类了。下面，我们就用这个类生成一个WSDL文件。

1)        右击类，选择Create Web Service

2)        选择服务的环境和服务工程，我们都采用默认的。

3)        输入我们要生成WSDL文件的名称，这里可以自己命名，或是使用默认的。

4)        如果Tomcat的服务器没有启动的话，那么就要执行下面那步了。

5)        最后这一步，我们不用勾选，直接Finish就可以了。

6)        查看我们的工程，发现生成了下面的文件。其中有一个就是我们所关心的UserLogin.wsdl文件了。同时，笔者兴趣的话，可以打开web.xml、server-config.wsdd、undeploy.wsdd文件去看个究竟。这里笔者就不给出解析了。

4. 理解WSDL文件

1)        查看生成的wsdl的文件，我们看到的是<element name=”userLogin”>下面有几个参数就是我们在UserLogin类的方法中定义的。也就是说，客户要发起对我们系统请求时，这两个字段是必填的字段；并且要对应于我们规定规定的string的类型。

 <wsdl:types>
  <schema elementFormDefault="qualified" targetNamespace="http://client.owen.com" xmlns="http://www.w3.org/2001/XMLSchema">
   <element name="userlogin">
    <complexType>
     <sequence>
      <element name="name" type="xsd:string"/>
      <element name="password" type="xsd:string"/>
     </sequence>
    </complexType>
   </element>
   <element name="userloginResponse">
    <complexType/>
   </element>
  </schema>
 </wsdl:types>

2)        wsdl文件中的有<wsdl:message>的标签分别是**Request和**Responser,这是我们再熟悉不过的B/S构架了，就是请求与响应的信息提示。

<wsdl:message name="userloginRequest">

      <wsdl:part element="impl:userlogin" name="parameters">

      </wsdl:part>

   </wsdl:message>

   <wsdl:message name="userloginResponse">

      <wsdl:part element="impl:userloginResponse" name="parameters">

      </wsdl:part>

   </wsdl:message>

3)        最后是重要的一个<wsdl:service/>的标签，这个是我们需要请求服务时的url的地址，也就是我们要写在SoapUI的地址栏那个地方。

<wsdl:service name="UserLoginService">

      <wsdl:port binding="impl:UserLoginSoapBinding" name="UserLogin">

         <wsdlsoap:address location="http://localhost:8888/UserLogin/services/UserLogin"/>

      </wsdl:port>

   </wsdl:service>