Java创建WebService服务及客户端实现

WebService是一种服务的提供方式，通过WebService，不同应用间相互间调用变的很方便，网络上有很多常用的WebService服务，如：http://developer.51cto.com/art/200908/147125.htm，不同的语言平台对WebService都有实现，Java的WebService实现，比较流行的有Axis2、Jaxws，本文介绍的是Axis2。

Axis2下载和部署
       Axis2是Apache开发的一个开源项目，再次感叹Apache的伟大！

       下载地址：

       http://mirror.bit.edu.cn/apache//axis/axis2/java/core/1.6.2/axis2-1.6.2-war.zip

       将其内axis2.war解压到<Tomcat安装目录>/webapps下，启动Tomcat，war包会自动解压，

       访问http://localhost:8080/axis2/，如果看到欢迎主页，则说明部署成功。

配置Axis2
       <Tomcat安装目录>/webapps/axis2/WEB-INF/conf/axis2.xml，配置其内两个属性，以便调试。

[html] view plaincopy
<parameter name="hotdeployment">true</parameter><!-- 开启热部署，不需要重启即可部署服务 --> 
<parameter name="hotupdate">true</parameter><!-- 开启热更新，不需要重启即可更新服务 --> 
编写服务
       所谓服务就是编写一个类，写一些方法，方法返回数据，WebService客户端获取数据。
[java] view plaincopy
public class HelloService { 
 
    public String sayHello() { 
        return "hello"; 
    } 
     
} 
0配置POJO发布服务
       服务类创建好后，我们需要发布到服务器上，将HelloService.class放到<Tomcat安装目录>/webapps/axis2/WEB-INF/pojo下，pojo没有需要创建。

       至此，我们已经成功的创建了一个WebService服务了，so easy！

       再次访问http://localhost:8080/axis2/，点击Services，可以发现可用services中多了一个HelloService，其内有一个可用操作sayHello，说明发布成功。

[java] view plaincopy
HelloService 
 
Service Description : No description available for this service 
 
Service EPR : http://localhost:8080/axis2/services/HelloService 
 
Service Status : Active 
 
 
Available Operations 
sayHello 
       访问http://localhost:8080/axis2/services/HelloService，页面输出正是我们的返回值。
[html] view plaincopy
<ns:sayHelloResponse xmlns:ns="http://ws.apache.org/axis2"> 
<return>hello</return> 
</ns:sayHelloResponse> 
       这里有两点需要注意：
       - POJO发布的类不能放在包里，既不能使用package关键字；

       - 默认的发布目录是pojo，可以在<Tomcat安装目录>/webapps/axis2/WEB-INF/conf/axis2.xml中增加目录，

[html] view plaincopy
<deployer extension=".class" directory="<要增加的目录名称>" class="org.apache.axis2.deployment.POJODeployer" /> 
         要注意多个目录见WebService要唯一，否则会重名，重名后，先部署的会成功，后部署的会报错。
services.xml配置文件发布服务
       虽然POJO的方式不需要配置文件，但是其服务类不能放在包内，显然是不符合我们日常开发的，Axis2也允许带包的类发布WebService，如果不允许，估计就没人用了。

       首先写一个较复杂的服务类，多个方法，带参数，有返回值的。

[java] view plaincopy
package webservice.test; 
 
/**
* 计算器运算
* 
* @author gaoshuang
*/ 
public class CalculateService { 
 
    // 加法 
    public float plus(float x, float y) { 
        return x + y; 
    } 
 
    // 减法 
    public float minus(float x, float y) { 
        return x - y; 
    } 
 
    // 乘法 
    public float multiply(float x, float y) { 
        return x * y; 
    } 
 
    // 除法 
    public float divide(float x, float y) { 
        if (y != 0) 
            return x / y; 
        else 
            return -1; 
    } 
} 
       然后编写services.xml，该文件需要放在META-INF文件夹下。
[html] view plaincopy
<?xml version="1.0" encoding="UTF-8"?> 
<!-- 服务名称 --> 
<service name="CalculateService"> 
    <!-- 服务描述 --> 
    <description> 
        加减乘除计算服务 
    </description> 
    <!-- 设置服务类 --> 
    <parameter name="ServiceClass"> 
        com.runqianapp.webservice.test.CalculateService 
    </parameter> 
    <!-- 方法 --> 
    <operation name="plus"> 
        <!-- 方法处理器，RPCMessageReceiver为带返回值的处理器， 
                     RPCInOnlyMessageReceiver为不带返回值的处理器 --> 
        <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" 
            class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /> 
    </operation> 
    <operation name="minus"> 
        <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" 
            class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /> 
    </operation> 
    <operation name="multiply"> 
        <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" 
            class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /> 
    </operation> 
    <operation name="divide"> 
        <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" 
            class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /> 
    </operation> 
</service> 
       最后将这两个文件打成jar包，不论用工具还是手动打，打的都是最外层的文件夹。

      
       我打的名字是server.jar，更改后置为aar，所以最后是server.aar，Axis2建议使用aar发布WebService，

       将server.aar放到<Tomcat安装目录>/webapps/axis2/WEB-INF/services下，访问http://localhost:8080/axis2/services/listServices，

       多出了一个CalculateService，说明发布成功。

[java] view plaincopy
CalculateService 
 
Service Description : CalculateService 
 
Service EPR : http://localhost:8080/axis2/services/CalculateService 
 
Service Status : Active 
 
 
Available Operations 
divide 
plus 
minus 
multiply 
       分别访问
       http://localhost:8080/axis2/services/CalculateService/plus?x=1&y=2

       http://localhost:8080/axis2/services/CalculateService/divide?x=1&y=2

       http://localhost:8080/axis2/services/CalculateService/minus?x=1&y=2

       http://localhost:8080/axis2/services/CalculateService/multiply?x=1&y=2
       也可以发布多个WebService，可以使用serviceGroup标签。

[html] view plaincopy
<serviceGroup> 
<service name="myService1"> 
    ... 
</service> 
<service name="myService2"> 
    ... 
</service> 
</serviceGroup> 
客户端实现
       以上介绍的都是WebService服务创建及发布，那么有了一个WebService服务后，我们如何调用呢？只在浏览器上访问是没有意义的。

       下载Axis2客户端压缩包：http://mirror.esocc.com/apache//axis/axis2/java/core/1.6.2/axis2-1.6.2-bin.zip，并解压。

       新建工程WebServiceClientTest，将<Axis2客户端安装目录>/lib下所有jar包添加到工程中；

       编写客户端代码；

[java] view plaincopy
package webservice.client.test; 
 
import javax.xml.namespace.QName; 
 
import org.apache.axis2.AxisFault; 
import org.apache.axis2.addressing.EndpointReference; 
import org.apache.axis2.client.Options; 
import org.apache.axis2.rpc.client.RPCServiceClient; 
 
public class Client1 { 
 
    /**
     * @param args
     * @throws AxisFault
     */ 
    public static void main(String[] args) throws AxisFault { 
        // 使用RPC方式调用WebService 
        RPCServiceClient serviceClient = new RPCServiceClient(); 
        Options options = serviceClient.getOptions(); 
        // 指定调用WebService的URL 
        EndpointReference targetEPR = new EndpointReference( 
                "http://localhost:8080/axis2/services/CalculateService"); 
        options.setTo(targetEPR); 
        // 调用方法的参数值 
        Object[] entryArgs = new Object[] {1, 2}; 
        // 调用方法返回值的数据类型的Class对象 
        Class[] classes = new Class[] { float.class }; 
        // 调用方法名及WSDL文件的命名空间 
        // 命名空间是http://localhost:8080/axis2/services/CalculateService?wsdl中wsdl:definitions标签targetNamespace属性 
        QName opName = new QName("http://test.webservice", "plus"); 
        // 执行方法获取返回值 
        // 没有返回值的方法使用serviceClient.invokeRobust(opName, entryArgs) 
        Object result = serviceClient.invokeBlocking(opName, entryArgs, classes)[0]; 
        System.out.println(result); 
        // out: 3.0 
    } 
 
} 
       以上是实现了一个简单的WebSerivce客户端，调用CalculateService中的plus方法，由代码可见，这种调用方式比较杂乱，代码不太友好。
wsdl2java简化客户端
       <Axis2客户端安装目录>/bin目录，其内有两个bat，wsdl2java.bat和java2wsdl.bat，可以实现WSDL文件和Java之间的互相转换。

       考虑到我们以后可能经常使用这些命令，设置环境变量，方便以后调用。在系统变量中加入AXIS2_HOME=<Axis2客户端安装目录>，path中追加;%AXIS2_HOME%\bin。

       启动命令提示符，进入WebServiceTestClient所在目录，运行

[plain] view plaincopy
wsdl2java -uri http://localhost:8080/axis2/services/CalculateService?wsdl -p webservice.client.test -s 
       参数说明：uri - wsdl文件路径，网络路径或本地路径，p - 打包，这里和上一个客户端实现类打在了一个包里，wsdl2java有很多参数，详细可以运行该命令去查看。
       执行后，如果没有报错，说明运行成功，刷新项目，该包下多出了一个CalculateServiceStub类，里面的代码极其复杂，还乱呼呼的，这我们不用管，调用该类。

[java] view plaincopy
package webservice.client.test; 
 
import java.rmi.RemoteException; 
 
import webservice.client.test.CalculateServiceStub.Plus; 
 
public class Client2 { 
 
    /**
     * @param args
     * @throws RemoteException 
     */ 
    public static void main(String[] args) throws RemoteException { 
        CalculateServiceStub stub = new CalculateServiceStub(); 
        Plus plus = new Plus(); 
        plus.setX(1); 
        plus.setY(2); 
        float result = stub.plus(plus).get_return();// 返回值自动转型，这也是强大之处 
        System.out.println(result); 
    } 
 
} 
       如此做的好处就是调用时不需要在去查看WSDL，和正常使用一个类一样，对WebService的封装都由wsdl2java自动生成，代码更优雅、简洁。

利用wsdl2java轻松使用第三方WebService服务
       有了wsdl2java，已知一个WSDL文件我们就可以轻松的生成WebService客户端供我们调用，给我们服务。文章开头给出的链接包含了一些第三方服务，有一个服务是生成随机个数中文，WSDL：http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx?wsdl，同样，启动命令提示符，进入项目路径，执行

[plain] view plaincopy
wsdl2java -uri http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx?wsdl -p webservice.client.test -s 
       调用该类
[java] view plaincopy
package webservice.client.test; 
 
import java.rmi.RemoteException; 
 
import webservice.client.test.RandomFontsWebServiceStub.ArrayOfString; 
import webservice.client.test.RandomFontsWebServiceStub.GetChineseFonts; 
 
public class ThirdClient { 
 
    /**
     * @param args
     * @throws RemoteException 
     */ 
    public static void main(String[] args) throws RemoteException { 
        RandomFontsWebServiceStub stub = new RandomFontsWebServiceStub(); 
        GetChineseFonts getChineseFonts = new GetChineseFonts(); 
        getChineseFonts.setByFontsLength(10);// 免费使用有限制，最多8个 
        ArrayOfString result = stub.getChineseFonts(getChineseFonts).getGetChineseFontsResult(); 
        for(String str : result.getString()) { 
            System.out.println(str); 
        } 
    } 
 
} 
源码下载
       文中代码尽在下面链接中，免积分下载。
       http://download.csdn.net/download/ghsau/6400843

       (完)
原文地址：http://blog.csdn.net/ghsau/article/details/12714965