Axis2 web service 开发初学（转）

本文介绍了如何使用tomcat和Axis2开发、部署和使用Web Service，并且开发了一个简单的例子，通过例子开发流程来向大家展示如何创建Axis2的服务端和客户端。该例子与其他例子最大的不同是不是用客户端stub存根方式调用web服务，提供了一种统一的客户端调用方式。希望读者读完本文后能够快速上手Axis2的应用开发。

   一、开发环境和软件下载

  开发环境是：Eclipse3.4 + JDK1.6 + Tomcat6.0 + Axis2 1.3。这些软件都是各个软件最新版本，下载方式由于软件网站的更新，地址也会更新，这里就不再贴出来了，就请读者到相应网站下载。
  软件下载和安装：
    (1) JDK1.6环境变量配置：
    JAVA_HOME: C:\Program Files\Java\jdk1.6.0_07，其中C:\Program Files\Java是我的JDK安装目录。
    Path: %JAVA_HOME%\bin
    Classpath: .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
  
    (2) tomcat6.0环境变量配置：
    CATALINA_HOME：C:\Program Files\Apache Software Foundation\Tomcat 6.0， 其中C:\Program Files\Apache Software Foundation是我的Tomcat 6.0安装目录。
    其实这里tomcat6.0不需要配置环境变量，因为最新版本不需要配置。

    (3) Axis2 1.3下载：从http://apache.justdn.org/ws/axis2/1_4_1/网站上下载axis2-1.3-war.zip 。将其解压，把其中的axis2.war文件复制到tomcat的webapps目录下即可完成Axis2的安装。
  安装完成后，启动tomcate，在地址栏内输入http://localhost:8080/axis2/，打开如下图界面，表明安装正确：



    (4) Eclipse3.4下载：到www.eclipse.org官方网站下载，直接解压后配置Windows/Preference中的JDK即可。

    (5) 下载Eclipse Axis2插件：axis2-eclipse-codegen-wizard-1.4.zip和axis2-eclipse-codegen-wizard-1.4.zip。下载地址是：[url]http://apache.justdn.org/ws/axis2/tools/1_4_1/      [/url] 这两个插件解压到Eclipse安装目录下plugins中即可。打开Eclipse，选择File/New/Other菜单项，看到如下界面表明安装成功：



    安装这两个插件的目的是：方便生成Axis2服务和生成Axis2客户端，这里我使用了无Stub方式的客户端调用服务，因此就不演示生成Axis2客户端的功能了。

  二、构建服务
   
在开发环境及 Axis2 环境搭建好后，我们便可着手 Web Services 服务的开发：
1.建立要发布的Web Service

    (1)在 Eclispse 中添加一个用户库命名为 axis2 ，将 axis2\lib 下的包均添加进来。这一步操作的目的是为了以后工程添加 axis2 所需的 jar 文件方便。
    (2) 建立一个 JavaProject 命名为 ws ，将 axis2 用户库加入到 build path 中。
    (3) 现在开始编写要发布的 WebSevice ，在 src 中建包 briup ，建立 Hello 类如下:
package briup;

public class Hello {
  public String sayHello(String user) {
    return "Hello, " + user;
  }
}

    2.发布Web Service

    打包要发布的 Service ， Eclipse 中 New --> File --> Other --> Axis2 wizards --> Axis2 Services Archiver ，按照向导选择刚建立的类编译后的 class 文件。
    (1)选择 class 文件目录，注意，不是 java 源文件，而是 classes 目录，这里需要注意由于你的类是带包briup的，因此不要选到包这个目录。
(2)连按两次 “Next>” ，选中 “Generate the service xml automatically”
(3)按下一步，输入 service 名称和类名，我这里输入的服务名是:ws；类名是我们刚刚写的类名：briup.Hello，这里需要注意加入完整的包名。
(4) 按下一步，输入 service 文件的保存路径和文件名，完成。
选择生成目录为：C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\axis2\WEB-INF\services，也可以选择其他目录，然后copy到这一目录下。

3.测试Web Service

打开http://localhost:8080/axis2/services/listServices页面，可以看到ws服务，点击进到ws的wsdl页面：http://localhost:8080/axis2/services/ws?wsdl,表明服务部署正确。

三、编写客户端代码调用服务

我的这个例子与其他例子最大的不同就在这里，其他例子一般需要根据刚才的服务wsdl生成客户端stub，然后通过stub来调用服务，这种方式显得比较单一，客户端必须需要stub存根才能够访问服务，很不方面。
本例子的客户端不采用stub方式，而是一种实现通用的调用方式，不需要任何客户端存根即可访问服务。只需要指定对于的web servce地址、操作名、参数和函数返回类型即可。代码如下：

package briup;

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 WsClient {

  private RPCServiceClient serviceClient;
  private Options options;
  private EndpointReference targetEPR;
 
  public WsClient(String endpoint) throws AxisFault {
    serviceClient = new RPCServiceClient();
    options = serviceClient.getOptions();
    targetEPR = new EndpointReference(endpoint);
    options.setTo(targetEPR);
  }
  public Object[] invokeOp(String targetNamespace, String opName,
      Object[] opArgs, Class<?>[] opReturnType) throws AxisFault,
      ClassNotFoundException {
    // 设定操作的名称
    QName opQName = new QName(targetNamespace, opName);
    // 设定返回值
   
    //Class<?>[] opReturn = new Class[] { opReturnType };

    // 操作需要传入的参数已经在参数中给定，这里直接传入方法中调用
    return serviceClient.invokeBlocking(opQName, opArgs, opReturnType);
  }
  /**
    * @param args
    * @throws AxisFault
    * @throws ClassNotFoundException
    */
  public static void main(String[] args) throws AxisFault, ClassNotFoundException {
    // TODO Auto-generated method stub
    final String endPointReference = "http://localhost:8080/axis2/services/ws";
    final String targetNamespace = "http://briup";
    WsClient client = new WsClient(endPointReference);
   
    String opName = "sayHello";
    Object[] opArgs = new Object[]{"Repace中心"};
    Class<?>[] opReturnType = new Class[]{String[].class};
   
    Object[] response = client.invokeOp(targetNamespace, opName, opArgs, opReturnType);
    System.out.println(((String[])response[0])[0]);
  }

}

运行该程序，点击Run As->Java application，可以看到控制台端口的输出是：Hello, Repace中心  表明客户端调用成功。
该例子最大的不同和优势表现在客户端的调用方式，或者说是发起服务调用的方式，虽然比起客户端stub存根的方式，代码稍多，但是这种方式统一，不需要生产stub存根代码，解决了客户端有很多类的问题。如果读者对这些代码进一步封装，我想调用方式很简单，只需要传递相关参数，这更好地说明了服务调用的优势。而且这种方式更加简单明了，一看便知具体含义。而不需要弄得stub类的一些机制。