Web Service之AXIS（一）

1、Axis 全称是 Apache Extensible Interaction System :阿帕奇可扩展交互系统。是一个开源、基于XML的Web服务框架。包含了Java和C++语言实现的SOAP服务器，以及各种公用服务及API以生成和部署Web服务应用。可创造出可操作的、分布式的计算应用。

 开发环境：Myeclipse、Tomcat、jdk、AXis2

首先可以下载如下两个zip包：
axis2-1.7.6-bin.zip
axis2-1.7.6-war.zip
其中 axis2-1.7.6-bin.zip文件中包含了Axis2中所有的jar文件, 
axis2-1.7.6-war.zip文件用于将WebService发布到Web容器中。
将axis2-1.7.6-war.zip文件解压到相应的目录，将目录中的axis2.war文件放到<Tomcat安装目录>webapps目录中，

并启动Tomcat,在浏览器地址栏中输入如下的URL：

 http://localhost:8080/axis2/

如看到axis2的主页面则安装成功。

将axis2-1.7.6-war.zip压缩包里面的axis2.war包解压到tomcat的webapps目录下，启动tomcat，访问地址http://localhost:8080/axis2/ ，即可访问axis2的Welcome!页面。
访问地址http://localhost:8080/axis2/services/listServices 另可访问服务列表。

http://localhost:8080/axis2/services/Version?method=getVersion  获取版本

使用Axis2方式发布webService的三种方式

1、简单的pojo方式（无需配置）：

在Axis2中不需要进行任何的配置，就可以直接将一个简单的POJO发布成WebService。其中POJO中所有的public方法将被发布成WebService方法。
示例代码如下：(这个POJO的类名必须是XXXService格式，否则报错)

将HelloService.class文件放到tomcatwebappsaxis2WEB-INFpojo目录中【注：若没有pojo目录，则手动新建该目录】。
在浏览器地址栏中输入如下的URL：
http://127.0.0.1:8080/axis2/services/listServices 即可访问刷新后的服务列表。【注：POJO类不能使用package关键字声明包，若使用axis2管理平台发布，则需要修改HelloService类，去掉package字段。】

在浏览器地址栏中输入如下的两个URL来分别测试sayHelloToPerson和sayHello方法：
1.http://localhost:8080/axis2/services/HelloService/sayHello 

2.http://localhost:8080/axis2/services/HelloService/sayHelloToPerson?name=huadi

【注：发布WebService的pojo目录只是默认的，如果想在其他的目录发布WebService，可以打开axis2/WEB-INF/conf/axis2.xml文件，并在<axisconfig>元素中添加如下的子元素：

 <deployer extension=".class" directory="my" class="org.apache.axis2.deployment.POJODeployer"/>

上面的配置允许在<Tomcat安装目录>webappsaxis2WEB-INFmy目录中发布WebService。   例如，将本例中的HelloService.class复制到my目录中也可以成功发布（但要删除pojo目录中的SimpleService.class，否则WebService会重名）。

访问 http://127.0.0.1:8080/axis2/services/HelloService?wsdl 即可访问服务UserService的wsdl描述

 

 2. Axis2在默认情况下可以热发布WebService，也就是说，将WebService的.class文件复制到pojo目录中时，  Tomcat不需要重新启动就可以自动发布WebService。  如果想取消Axis2的热发布功能，可以打开<Tomcat安装目录>webappsaxis2WEB-INFconfaxis2.xml，

找到如下的配置代码：

<parameter name="hotdeployment">true</parameter>

将true改为false即可。要注意的是，Axis2在默认情况下虽然是热发布，但并不是热更新.也就是说，一旦成功发布了WebService，再想更新该WebService，就必须重启Tomcat。这对于开发人员调试WebService非常不方便，因此，在开发WebService时，可以将Axis2设为热更新。
在axis2.xml文件中找到如下的配置代码：

<parameter name="hotupdate">false</parameter>

 将false改为true即可。

3. 在浏览器中测试WebService时，如果WebService方法有参数，需要使用URL的请求参数来指定该WebService方法,参数的值，请求参数名与方法参数名要一致，例如，要测试sayHelloToPerson方法，请求参数名应为name，如上面的URL所示。

2、打jar包的方式：

用Axis2实现Web Service，虽然可以将POJO类放在axis2WEB-INFpojo目录中直接发布成Web Service，  这样做不需要进行任何配置，但这些POJO类不能在任何包中。这似乎有些不方便.  为此，Axis2也允许将带包的POJO类发布成Web Service。先实现一个POJO类，代码如下：

package com.axis;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Random;

public class HelloWSDD {
    
    public String getName(String name) {
        return "Welcome " + name;
    }

    public Double getPrice() {
        return Math.random();
    }

    public int getNum() {
        return new Random().nextInt(100);
    }

    public List<String> getList() {
        List<String> list = new ArrayList<String>();
        list.add("num1");
        list.add("num2");
        list.add("num3");
        list.add("num4");
        list.add("num5");
        return list;

    }

    public Map<String, String> getMap() {
        Map<String, String> map = new HashMap<String, String>();
        map.put("NO.1", "Y1");
        map.put("NO.2", "Y2");
        map.put("NO.3", "Y3");
        map.put("NO.4", "Y4");
        map.put("NO.5", "Y5");
        return map;

    }
}

问题解决：

信息: Error parsing HTTP request header
 Note: further occurrences of HTTP header parsing errors will be logged at DEBUG level.
java.lang.IllegalArgumentException: Invalid character found in the request target. The valid characters are defined in RFC 7230 and RFC 3986
        at org.apache.coyote.http11.InternalAprInputBuffer.parseRequestLine(InternalAprInputBuffer.java:238)
        at org.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1028)
        at org.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:637)
        at org.apache.tomcat.util.net.AprEndpoint$SocketProcessor.doRun(AprEndpoint.java:2555)
        at org.apache.tomcat.util.net.AprEndpoint$SocketProcessor.run(AprEndpoint.java:2544)
        at java.util.concurrent.ThreadPoolExecutor$Worker.runTask(ThreadPoolExecutor.java:895)
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:918)
        at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)
        at java.lang.Thread.run(Thread.java:662)

解决方法：

Plan 1：
更换低版本的Tomcat来规避这种问题。

Plan 2：
在conf/catalina.properties中最后添加一行：

org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true

 这个案例整理了半天，才成功。下面讲解一下步骤

1。生成services.xml文档。

<?xml version="1.0" encoding="UTF-8"?>
<service name="HelloWSDDService" targetNamespace="http://ws.apache.org/ax2">
    <schema schemaNamespace="http://sdjxd.com.cn" />
    <description>Web Service实例一</description>
    <parameter name="ServiceClass">com.axis.HelloWSDDService</parameter>
    <messageReceivers>
        <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
            class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
        <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"
            class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />
    </messageReceivers>
</service>   

2.放置同一目录下

3.cmd命令行运行

4.将生成的aws.aar压缩包放置在tomacta安装目录webappsaxis2WEB-INFservices下

5.运行tomact。查看服务

打jar的方式可以借助插件工具：

下载插件http://axis.apache.org/axis2/java/core/download.html

一、new---》other----》Axis

：填写服务器端类的.class文件的地址目录

完成

3、不打jar包的方式：

有一个最简单的方法就是把axis2.war中的内容作为Web Project的基础, 来进行开发.

不过为了更清楚的了解如何在一个已有的Web Project中嵌入axis2, 那就手动来配置。大致分如下几个步骤：

一、新建Web Project，名为“20171030”

二、下载axis2-1.6.1-war.zip包，解压缩

将axis2/WEB-INF/lib 里的jar包拷贝到 WebServiceDemo/WebRoot/WEB-INF/lib/

将axis2.war/axis2-web拷贝至WebServiceDemo/ WebRoot/axis2-web/

三、配置axis2 servlet

打开WebServiceDemo/WebRoot/WEB-INF/web.xml，增加如下配置：

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

 四、写一个简单的web服务类

package com.axis;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Random;

public class HelloWSDDService {
 
 public String getName(String name) {
  return "Welcome " + name;
 }

 public Double getPrice() {
  return Math.random();
 }

 public int getNum() {
  return new Random().nextInt(100);
 }

 public List<String> getList() {
  List<String> list = new ArrayList<String>();
  list.add("num1");
  list.add("num2");
  list.add("num3");
  list.add("num4");
  list.add("num5");
  return list;

 }

 public Map<String, String> getMap() {
  Map<String, String> map = new HashMap<String, String>();
  map.put("NO.1", "Y1");
  map.put("NO.2", "Y2");
  map.put("NO.3", "Y3");
  map.put("NO.4", "Y4");
  map.put("NO.5", "Y5");
  return map;

 }
}

五、配置Web Service.

由于axis2已嵌入到20171030项目中，所以web service就不用打包成aar，而是直接在/WEB-INF目录下创建相应的文件夹和services.xml，目录结构如下图：

六、services.xml

<?xml version="1.0" encoding="UTF-8"?>
<service name="HelloWSDDService" targetNamespace="http://ws.apache.org/ax2">
 <schema schemaNamespace="http://sdjxd.com.cn" />
 <description>Web Service实例一</description>
 <parameter name="ServiceClass">com.axis.HelloWSDDService</parameter>
 <messageReceivers>
  <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
   class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
  <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"
   class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" />
 </messageReceivers>
</service>

七、在浏览器中访问http://localhost:8080/20171030/services/listServices

可以看到myService服务，说明服务已部署成功

       输入http://localhost:8080/20171030/services/HelloWSDDService?wsdl

    可以查看到该Web服务的描述文件

 

以上是Axis2的发布方式，你查看资料也会发现将.java转变成.jws进行发布的。这里要说明一下。Axis1和Axis2发布方式是有所不同的，希望大家不要混淆。这里我也给出axis-1_4的发布方式。

环境 tomcat、myeclipse、axis-1_4

　下载地址：　http://www.apache.org/dist/axis/axis/java/1.4/

解压axis-bin-1_4.zip。进入axis-1_4webapps目录下。复制文件夹axis到Tomact的webapps目录下。启动Tomcat，在浏览器测试一下Axis是否成功，如出现如下页面表示成功。地址：http://localhost:8080/axis

1、即时发布

①、将java文件扩展名.java重命名为.jws文件，并放在Web应用程序的根目录下，如下所示：

②、在浏览器中运行http://localhost:8080/axis/HelloService.jws，出现下面界面：

点击链接，可查看wsdl文件

测试代码，编写客户端：

public class CallService {
    public static void main(String[] args) {
        // 请求地址 指明服务所在位置
        String url = "http://localhost:8080/axis/HelloService.jws";
        // 创建服务 创建一个Service实例，注意是必须的！
        Service service = new Service();
        try {
            // 调用服务 创建Call实例，也是必须的！
            Call call = (Call) service.createCall();
            // 服务地址 为Call 设置服务的位置
            call.setTargetEndpointAddress(url);
            // 请求方法 注意方法名与 HelloWorld.java中一样
            call.setOperationName(new QName(url, "sayHelloToPerson"));
            // 执行调用
            String result = (String) call.invoke(new Object[] { "huadiyatou" });
            System.out.println(result);

            // 请求方法
            call.setOperationName(new QName(url, "sayHello"));
            // 执行调用
            String result1 = (String) call.invoke(new Object[] {});
            System.out.println(result1);
        } catch (ServiceException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (RemoteException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }
}

结果如下，即时发布完成。

即时发布的特点：只能使用原始数据类型和非常普通的Java类如Date，作为方法参数和返回类型，不能使用自定义的类。不支持带package包的出现

2、定制发布（WSDD ：Web Service Deployment Descriptor）

步骤一、编写服务器端代码，并编译该程序

package com.axis;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Random;

public class HelloWSDD {
    public String getName(String name) {
        return "Welcome " + name;
    }

    public Double getPrice() {
        return Math.random();
    }

    public int getNum() {
        return new Random().nextInt(100);
    }

    public List<String> getList() {
        List<String> list = new ArrayList<String>();
        list.add("num1");
        list.add("num2");
        list.add("num3");
        list.add("num4");
        list.add("num5");
        return list;

    }

    public Map<String, String> getMap() {
        Map<String, String> map = new HashMap<String, String>();
        map.put("NO.1", "Y1");
        map.put("NO.2", "Y2");
        map.put("NO.3", "Y3");
        map.put("NO.4", "Y4");
        map.put("NO.5", "Y5");
        return map;

    }
}

 步骤二、把编译后的文件（带包路径）拷贝到 （本地服务器）apache-tomcat-7.0.42webappsaxisWEB-INFclasses下

步骤三、编写发布文件.wsdd，并复制到tomact的webappsaxisWEB-INF目录下，通常命名为deploy.wsdd,即SOAP服务发布描述文件

<!-- deployment元素：指定wsdd所用的XML名字空间。deployment是其根元素，可以定义多个Service元素 -->

<deployment
    xmlns="http://xml.apache.org/axis/wsdd/"
    xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
  <!-- Services from VisualWebService WSDL service -->　　

<!-- service元素：定义一项SOAP服务，他有name和provider两个属性，name代表这项服务的唯一标示符，即服务的名字。SOAP 会根据name属性访问该SOAP服务，provider指定了实现这项服务的语言及服务方式。-->

  <service name="HelloWS" provider="java:RPC">
    <!--parameter元素：包含name和value属性，如果name值为className，则指定该服务的类名，如果name为allowedMethods，则指定该项服务包含的方法-->
      <parameter name="className" value="com.axis.HelloWSDD"/> <!--接口文件位置-->
      <parameter name="allowedMethods" value="*"/>
   </service>
</deployment>

步骤四、控制台，进入目录F:apache-tomcat-7.0.82webappsaxisWEB-INF下。键入:java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient wsdd全名,一般wsdd的名字为deploy.wsdd（注：服务器Tomcat必须已经启动）

你会发现目录下多了一个server-config.wsdd文件，这就是AXIS的配置文件，以后所有的服务发布描述都会在里面找到。（当然，你可以直接修改它，不用再写deploy.wsdd。但server-config.wsdd文件应该存放在apache-tomcat-7.0.42webappsaxisWEB-INF 下）

得到结果<Admin>Doneprocessing</Admin>表示部署成功。或者查看 http://localhost:8080/axis/servlet/AxisServlet 是否发布成功

步骤五、

浏览器访问：http://localhost:8080/axis/services/HelloWS?method=getName&name=hahaha

java程序访问：

package com.axis;

import java.rmi.RemoteException;
import java.util.Map;
import java.util.Map.Entry;
import javax.xml.namespace.QName;
import javax.xml.rpc.ServiceException;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
public class CallHelloWSDD {
    public static void main(String[] args) {
        // 请求地址
        String url = "http://localhost:8080/axis/services/HelloWS";
        // 创建服务
        Service service = new Service();
        try {
            // 调用服务
            Call call = (Call) service.createCall();
            // 服务地址
            call.setTargetEndpointAddress(url);
            // 请求方法
            call.setOperationName(new QName(url, "getName"));
            // 执行调用
            String result = (String) call.invoke(new Object[] { "Mswangg" });
            System.out.println(result);
            // 请求方法
            call.setOperationName(new QName(url, "getPrice"));
            // 执行调用
            double result1 = (Double) call.invoke(new Object[] {});
            System.out.println(result1);
            // 请求方法
            call.setOperationName(new QName(url, "getNum"));
            // 执行调用
            int result2 = (Integer) call.invoke(new Object[] {});
            System.out.println(result2);
            // 请求方法
            call.setOperationName(new QName(url, "getList"));
            // 执行调用
            Object result3 = call.invoke(new Object[] {});
            System.out.println(result3);
            System.out.println("***********************");
            // 请求方法
            call.setOperationName(new QName(url, "getMap"));
            // 执行调用
            Map<String, String> result4 = (Map<String, String>) call
                    .invoke(new Object[] {});
            for (Entry<String, String> e : result4.entrySet()) {
                System.out.println(e.getKey() + ":" + e.getValue());
            }
        } catch (ServiceException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (RemoteException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }
}

 即时发布和定制发布的客户端代码区别在于：

即时发布：String url = "http://localhost:8080/axis/HelloService.jws";

定制发布：String url = "http://localhost:8080/axis/services/HelloWS";