axis2 搭建webservice

准备工作:

1.下载axis2相关文件
http://www.apache.org/dist//axis/axis2/java/core/1.6.1/
下载: 1.6.1-bin.zip,axis2-1.6.1-war.zip
下载:二个相应的插件
2.解压axis2-1.6.1-war.zip,将axis2.war复制到tomcat/webaps目录下
3.解压axis2-1.6.1-bin.zip,放至相应目录(后边会用到)
4.启动tomcat,输入:http://localhost:8080/axis2

开始搭建:
1.建立web project工程 axis2Demo(jdk1.5以上)
2.导入上步axis2-1.6.1-bin中lib目录下jar包
3.将第一步中axis2.war/WEB-INF下modules、service和conf三个文  件夹复制到当前工程WEB-INF目录下
4.配置web.xml,在web.xml中增加对axis2的支持
<!-- 加载Axis -->
<servlet>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>AxisServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
<!-- 加载Axis 结束 -->

5.创建web project  工程,新建axis2服务类 com.suncf.axis2.server.HelloWorld
public String getHello(String hello){
          return "你好,陌生人:"+hello;
      }
6.在WEB-INF下新建\services\HelloWorld\META-INF 目录.
7.新建services.xml
<?xml version="1.0" encoding="UTF-8"?>
<service name="HelloWorld"> 
    <description> 
        HelloWorld Service Example
    </description> 
    <parameter name="ServiceClass"> 
        com.suncf.axis2.server.HelloWrold
    </parameter> 
    <operation name="getHello"> 
    <!-- 当没有返回值时用 org.apache.axis2.rpc.receivers.
RPCInOnlyMessageReceiver，没有参数还是用RPCMessageReceiver-->
        <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /> 
    </operation> 
</service>

注:如果有多个类实现时可以加上:
<serviceGroup>
<service>
........
</service>
</serviceGroup>

8.发布工程,在浏览器中输入:http://localhost:8080/axis2/services/HelloWorld?wsdl
出现发下画面,则说明service发布成功

9.客户端调用代码(这里例出二种调用方式)
9.1:通过插件升成的客户端代码时这样调用
/**
     * main(这里用一句话描述这个方法的作用)     
     * @作者: suncf
     * @创建时间:2013-1-25下午02:31:51
     * @param args
     * @return  void
     * @throws Exception
     * @since  CodingExample　Ver(编码范例查看) 1.1   
     */
    public static void main(String[] args) throws Exception {
        HitSoftAxis2DemoStub sub = new HitSoftAxis2DemoStub();
        GetMessage mes = new GetMessage();
        mes.setMes("测试消息");
        System.out.println(sub.getMessage(mes).get_return());
       
        PMServiceStub sub1 = new PMServiceStub();
        ServiceClient ser = sub1._getServiceClient();
    }

其中:GetMessage 类为代码自动升成的,此类对应对外接口中的参数名.升成代码请往下边看....
9.2:本机测试时
public static void main(String[] args) {
        String url = "http://localhost:8080/axis2/services/HelloWorld";
        try {
            // 使用RPC方式调用WebService
            RPCServiceClient serviceClient = new RPCServiceClient();
            Options options = serviceClient.getOptions();
            // 指定调用WebService的URL
            EndpointReference targetEPR = new EndpointReference(url);
            options.setTo(targetEPR);
            // 在创建QName对象时，QName类的构造方法的第一个参数表示WSDL文件的命名空间名，也就是<wsdl:definitions>元素的targetNamespace属性值
            // 指定getGreeting方法的参数值，如果有多个，继续往后面增加即可，不用指定参数的名称
            Object[] opAddEntryArgs = new Object[] {};
            // 返回参数类型，这个和axis1有点区别
            // invokeBlocking方法有三个参数，其中第一个参数的类型是QName对象，表示要调用的方法名；
            // 第二个参数表示要调用的WebService方法的参数值，参数类型为Object[]；
            // 第三个参数表示WebService方法的返回值类型的Class对象，参数类型为Class[]。
            // 当方法没有参数时，invokeBlocking方法的第二个参数值不能是null，而要使用new Object[]{}
            // 如果被调用的WebService方法没有返回值，应使用RPCServiceClient类的invokeRobust方法，
            // 该方法只有两个参数，它们的含义与invokeBlocking方法的前两个参数的含义相同
            // 指定getGreeting方法返回值的数据类型的Class对象.....
           
            Class[] classes = new Class[] { String.class };
            QName  opAddEntry = new QName("http://axis2.suncf.com", "getHello");
            opAddEntryArgs = new Object[] {"测试消息"};
            System.out.println(serviceClient.invokeBlocking(opAddEntry, opAddEntryArgs, classes)[0]);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }


插件升成WSDL
1.安装二个插件(这里不在多做说明,请参考其它文档)
2.点击左键,选择new->other->Axis2 Wizards->Axis2 Code Generator->第二项(Generate a WSDL from a java source file)  next>
3.Fully Qualified Class name:中添写当前webservice对外的方法(含包名)如:com.suncf.axis2.HitSoftAxis2Demo
4.在Add Folder 中选择 步骤 3 中,添写文件的class目录.指定目录时指定到 WEB-INF/classes 目录中即可.
5.点击TestClass Loading...出现success 是说明成功.否则下 next>是点不上的.
6.保持默认即可
7.选择一个wsdl输出路径及要输出的wsdl的名字,点击完成
8.查看输出位置,会有一个  升成的wsdl文件
9.查看wsdl文件,如果文件后的sop address 不为当前路径所对应的地址时,请改正过来.比如我现在升成的就为:
http://localhost:8080/axis2/services/HitSoftAxis2Demo  改为:
http://localhost:8080/Axis2Demo/services/HitSoftAxis2Demo
(可能是那里配置不对,先手动改一下吧)

通过wsdl升成客户端代码
1.选择new->other->Axis2 Wizards->Axis2 Code Generator->(第一项)Generate java source code from a wsdl file
2.选择wsdl文件位置 next>
3.一路保持默认即可.
4.选择一个输出路径,点击finish即可.
5.将升成的代码,复制到当前工程中.自己把错误改一下(包名不对什么的)
6.  9.1中,只有通过插件升成了客户端代码后,才可以按9.1中的方法调用.