WebService服务端与客户端开发

最近客户提出了将我们做的系统接入到他们系统之中，方便他们进行集中管理这个需求，其中主要就是运用了WebService技术来进行系统之间的接入。在此记录一下整个WebService是如何嵌入我们系统的以及具体的开发流程。

服务端开发

添加jar包
我是使用axis2来辅助生成WebService服务端，因此需要添加相应的插件。
首先官网下载axis2-1.6.3，解压到文件夹中，并添加到eclipse中，window->preferences下：

服务端的生成
首先建立服务端包以及需要的服务类，类建好之后右键该类，选择Web Services->create web service.出现如下对话框：

直接点击完成按钮即可生成相应的服务端。
项目结构：

服务端检测
生成服务端之后，运行web项目，在浏览器上访问http://localhost:8080/com.primeton.testws/services/UpdateAppAcctAuthorServices?wsdl ， 出现如下页面即为成功：

发布成功后，客户端即可根据wsdl上的信息进行远程访问。

修改wsdl中的信息
为什么要修改wsdl中的信息呢？
1.因为有时候我们不想暴露有关自己项目的太多信息，例如：项目名称、类名、方法名以及项目的命名空间。这时就要修改相关的配置文件来改变wsdl中的相关信息，达到隐藏的作用。
2.一般客户端与服务端是2个不同的公司做的，若对方公司有要求，则必须改为要求的命名，不然访问不同。（PS:我们当时就是被坑了）
需要修改的文件为：server-config.wsdd
修改项为：

 <ns1:service name="UpdateAppAcctAuthorServices" provider="java:RPC" style="wrapped" use="literal">
  <ns1:operation name="updateAppAcctAuthor" qname="ns2:UpdateAppAcctAuthorServices" returnQName="ns2:UpdateAppAcctAuthorServicesReturn" returnType="xsd:string" soapAction="" xmlns:ns2="http://www.primeton.com/web" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <ns1:parameter qname="ns2:RequestInfo" type="xsd:string"/>
  </ns1:operation>
  <ns1:parameter name="allowedMethods" value="updateAppAcctAuthor"/>
  <ns1:parameter name="wsdlPortType" value="UpdateAppAcctAuthorServices"/>
  <ns1:parameter name="typeMappingVersion" value="1.2"/>
  <ns1:parameter name="schemaQualified" value="http://www.primeton.com/web"/>
  <ns1:parameter name="wsdlServicePort" value="UpdateAppAcctAuthorServices"/>
  <ns1:parameter name="className" value="webserver.UpdateAppAcctAuthorServices"/>
  <ns1:parameter name="wsdlTargetNamespace" value="http://www.primeton.com/web"/>
  <ns1:parameter name="wsdlServiceElement" value="UpdateAppAcctAuthorServicesService"/>
 </ns1:service>

1.修改qname来改变wsdl中显示的方法名
2.修改returnQName来改名wsdl中显示的返回名
3.修改ns1:parameter qname=”ns2:RequestInfo”来改变方法中的参数名。
4.修改 ns1:parameter name=”wsdlTargetNamespace”value=”http://www.primeton.com/web”来改变命名空间。
5.修改后就可以让客户端按照修改后的命名来进行访问了。

---

客户端开发

客户端开发即为调用别人所写的web服务。
所需要的jar包：

import javax.xml.namespace.QName;
import javax.xml.rpc.ServiceException;
import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;

除了引入的这些jar包之外，还需要axis2 下的commons-httpclient-3.1.jar包，通过该包进行webservice通信。

调用方式也有好几种，我这里介绍的是RPC远程调用的方法。具体调用代码及注释如下：

        String requestInfo = createRequestInfo2();

        String serviceUrl = "http://localhost:8080/com.primeton.testws/services/UpdateAppAcctSoap?wsdl";

        RPCServiceClient serviceClient = null;
        String resultString = "";
        try {
            serviceClient = new RPCServiceClient();
        } catch (AxisFault e1) {
            // TODO Auto-generated catch block
            e1.printStackTrace();
        }
        Options options = serviceClient.getOptions();
        EndpointReference targetEPR = new EndpointReference(serviceUrl);
        options.setTo(targetEPR);
        // 服务器端开放的方法名

        String wsFunction = "UpdateAppAcctSoap";

        // 要传给服务器开放方法的参数.
        String xmlStr = requestInfo ;

        /*在创建QName对象时,QName类的构造方法的第一个参数表示WSDL文件的命名空间名，
        也就是<wsdl:definitions>元素的targetNamespace属性值*/
        QName qName = new QName("http://www.primeton.com/web", wsFunction);
        // 参数,如果有多个,继续往后面增加即可,不用指定参数的名称
        Object[] inputArgs = new Object[] {  };
        if(xmlStr != null && !"".equals(xmlStr)){
            inputArgs = new Object[] { xmlStr };
        }
        /*
        返回参数类型，这个和axis1有点区别
        invokeBlocking方法有三个参数，其中第一个参数的类型是QName对象，表示要调用的方法名；
                第二个参数表示要调用的WebService方法的参数值，参数类型为Object[]；
                第三个参数表示WebService方法的返回值类型的Class对象，参数类型为Class[]。
                当方法没有参数时，invokeBlocking方法的第二个参数值不能是null，而要使用new Object[]{}
                如果被调用的WebService方法没有返回值，应使用RPCServiceClient类的invokeRobust方法，
                该方法只有两个参数，它们的含义与invokeBlocking方法的前两个参数的含义相同
        */
        Class[] returnTypes = new Class[] { String.class };
        Object[] response;
        try {
            response = serviceClient.invokeBlocking(qName, inputArgs, returnTypes);
            resultString = (String) response[0];
            System.out.println(resultString);
        } catch (AxisFault e) {
            e.printStackTrace();
        }

    }

requestInfo 是客户端发送的请求报文：

<?xml version="1.0" encoding="UTF-8"?>

<USERMODIFYREQ>
  <HEAD>
    <CODE></CODE>
    <SID></SID>
    <TIMESTAMP></TIMESTAMP>
    <SERVICEID></SERVICEID>
  </HEAD>
  <BODY>
    <OPERATORID>sysadmin</OPERATORID>
    <OPERATORPWD></OPERATORPWD>
    <OPERATORIP></OPERATORIP>
    <MODIFYMODE>add</MODIFYMODE>
    <USERINFO>
      <USERID>111111</USERID>
      <LOGINNO>111111</LOGINNO>
      <USERNAME></USERNAME>
      <ORGID></ORGID>
      <EMAIL>wwwwww@primeton.com</EMAIL>
      <MOBILE>11111111111</MOBILE>
      <PASSWORD>111111</PASSWORD>
      <STATUS></STATUS>
      <EFFECTDATE></EFFECTDATE>
      <EXPIREDATE></EXPIREDATE>
      <REMARK></REMARK>
    </USERINFO>
  </BODY>
</USERMODIFYREQ>

运行客户端，服务端返回的报文如下：

<?xml version="1.0" encoding="UTF-8"?>

<USERMODIFYRSP>
  <HEAD>
    <CODE></CODE>
    <SID></SID>
    <TIMESTAMP></TIMESTAMP>
    <SERVICEID>SHNGDM</SERVICEID>
  </HEAD>
  <BODY>
    <MODIFYMODE>add</MODIFYMODE>
    <USERID>111111</USERID>
    <LOGINNO>111111</LOGINNO>
    <RSP>0</RSP>
    <ERRDESC></ERRDESC>
  </BODY>
</USERMODIFYRSP>