axis1.4 HelloWorld

转载：http://www.iteye.com/topic/1121971#

Axis开发WebService 指南

一、 开发环境

l          MyEclipse 6.5

l          Tomcat 6.0.24

l          Jdk 1.6.0_22

l          Axis1.4

 

二、Axis简介:

axis全称Apache EXtensible Interaction System 即 阿帕奇 可扩展交互系统。Axis本质上就是一个SOAP引擎，提供创建 服务器端、客户端和网关SOAP操作的基本框架。Axis目前版本是为Java编写的，不过为C++的版本正在开发中。但Axis并不完全是一个SOAP引擎，它还是一个独立的SOAP服务器和一个嵌入Servlet引擎（例如Tomcat）的服务器。

下载1.4 Final 链接地址:

http://ws.apache.org/axis/

 

三、Java开发Webservice 示例

Axis支持三种WebService 的部署和开发，分别为： 

    1、Dynamic Invocation Interface(DII)方式 

    2、Dynamic Proxy方式 

    3、Stubs方式

Stubs方式是最通用的做法，又因其灵活的特点，建议使用这种方式.

下面是详细的开发步骤:

1)       创建web工程

1、  MyEclipse 6.5创建web project,取名为axistest;

2、  新建文件夹 文件夹名为lib ,然后 将下载下来的axis 其 axis-1_4\lib 目录下的jar 拷贝到ib目录下，将这些jar引入到axistest classpath 下,如图:

2) .编写Server 程序

1、  新建class，包取名：server  类名：HelloServer

声明sayHello方法,具体代码如下:

package Server;  
/** 
 
 * 开发webservice： 服务器端 
 
 * @author lvqing 
 
 * 
 
 */  
  
public class HelloServer {  
  
   
  
public String sayHello(String name){  
  
return "hello:"+name;  
  
}  
  
}

结构图：

 

2、配置web.xml

web.xml文件很容易配置，拷贝axis包里面的WebService示例的web.xml配置到我们的工程中的web.xml中就可以了。

<?xml version="1.0" encoding="UTF-8"?>    
<web-app version="2.5"     
    xmlns="http://java.sun.com/xml/ns/javaee"     
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"     
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee     
    http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">    
  <welcome-file-list>    
    <welcome-file>index.jsp</welcome-file>    
  </welcome-file-list>    
      
    <!-- =============== Axis Webservice =============-->    
    <servlet>    
        <servlet-name>AxisServlet</servlet-name>    
        <servlet-class>org.apache.axis.transport.http.AxisServlet</servlet-class>    
    </servlet>    
    <servlet>    
        <servlet-name>AdminServlet</servlet-name>    
        <servlet-class>org.apache.axis.transport.http.AdminServlet</servlet-class>    
        <load-on-startup>100</load-on-startup>    
    </servlet>    
    <servlet>    
        <servlet-name>SOAPMonitorService</servlet-name>    
        <servlet-class>org.apache.axis.monitor.SOAPMonitorService</servlet-class>    
        <init-param>    
            <param-name>SOAPMonitorPort</param-name>    
            <param-value>5001</param-value>    
        </init-param>    
        <load-on-startup>100</load-on-startup>    
    </servlet>    
    <servlet-mapping>    
        <servlet-name>AxisServlet</servlet-name>    
        <url-pattern>/servlet/AxisServlet</url-pattern>    
    </servlet-mapping>    
    <servlet-mapping>    
        <servlet-name>AxisServlet</servlet-name>    
        <url-pattern>*.jws</url-pattern>    
    </servlet-mapping>    
    <servlet-mapping>    
        <servlet-name>AxisServlet</servlet-name>    
        <url-pattern>/services/*</url-pattern>    
    </servlet-mapping>    
    <servlet-mapping>    
        <servlet-name>SOAPMonitorService</servlet-name>    
        <url-pattern>/SOAPMonitor</url-pattern>    
    </servlet-mapping>    
    <mime-mapping>    
        <extension>wsdl</extension>    
        <mime-type>text/xml</mime-type>    
    </mime-mapping>    
    <mime-mapping>    
        <extension>xsd</extension>    
        <mime-type>text/xml</mime-type>    
    </mime-mapping>    
      
</web-app>

 

3) 部署 web project

利用MyEclipse部署工具 将我们的项目部署到Tomcat\webapp目录下

部署完成后，访问：http://localhost:8080/axistest/servlet/AxisServlet

 

4) 创建 deploy.wsdd文件

这个文件可以在任意目录下创建，但是为了维护方便 ，我将它创建在axistest 项目Src目录下

示例代码：

<deployment xmlns="http://xml.apache.org/axis/wsdd/"   
  
    xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">   
  
    <!-- 这里的helloserver为wsdd描述符中的ServiceNamespace  -->   
  
    <service name="helloserver" provider="java:RPC">   
  
        <!-- 这里的ClassName就是我的服务类了，这个服务主要功能就是传递一个自定义的对象  -->   
  
        <parameter name="className" value="Server.HelloServer" />   
  
        <!-- 这里描术的意思是，此服务类中的方法全部享出来. value值为*号   
  
        如果你只想让你的客户端只能调用其中一个方法时，value值改为方法名就可以了． -->   
  
        <parameter name="allowedMethods" value="*" />   
  
    </service>   
  
</deployment>

  

5） 生成 server-config.wsdd  文件

在这里我们写一个批处理脚本deploy.bat，它会根据deploy.wsdd文件生成server-config.wsdd文件。server-config.wsdd 文件只需要一次生成，以后添加新服务，直接在server-config.wsdd 文件中配置。

server-config.wsdd 文件是WebService的核心配置文件，Web服务能否发布，很大程度上取决于次文件的配置。

这里 我们写个批处理脚本deploy.bat:

set Axis_Lib=D:\workspace\MEE\NMA\axistest\lib   设置axis.jar包所在路径，因为要用到AdminClient
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%      执行java的环境
set Axis_Servlet=http://localhost:8080/axistest/servlet/AxisServlet   注意axistest是你自己的项目名
%Java_Cmd% org.apache.axis.client.AdminClient -l %Axis_Servlet% deploy.wsdd
pause;

接下来，在执行deploy.bat前，请确保Tomcat 服务已运行,否则在Dos命令窗口中看到如下错误:

 

看到如下图运行的结果，表明已经在Tomcat\webapps\axistest\WEB-INF目录下生成了server-config.wsdd文件. (Activation.jar 和 mail.jar这两个包虽然没有加入到CLASSPATH中，但是不影响我们的开发。)

 

好了，大功告成了！webservice 发布成功了，重启Tomcat，我们来测试一下，看是否发布成功.

在IE上输入： http://localhost:8080/axistest/services/helloserver?wsdl

看到如图结果表明发布成功：

并且，当我们再次访问：http://localhost:8080/axistest/servlet/AxisServlet的时候，发现多出了一个服务

 

6) 生成客户端Client wsdl文件

在IE上输入： http://localhost:8080/axistest/services/helloserver?wsdl ，点击文件 → 另存为，存到axistest 项目Src：目录下

7）WSDL2Java

为了方便，我们写个批处理脚本 WSDL2Java.bat

set Axis_Lib=D:\workspace\MEE\NMA\axistest\lib
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%
set Output_Path=D:\workspace\MEE\NMA\axistest\src
set Package=client
%Java_Cmd% org.apache.axis.wsdl.WSDL2Java -o %Output_Path% -p %Package% helloserver.wsdl
pause;

 

解释下此命令：

%Output_Path%是客户端文件输出路径，%Package%是包名

这时 我们可以看到 axistest 工程下已经生成了客户端程序,如图：

 

8） 客户端测试代码：

package client;  
  
import java.net.URL;  
  
/** 
 
 * webservice  客户端 程序 
 
 */  
  
public class ClientTest {  
  
public static void main(String[] args) {  
  
HelloServerService service = null;   
  
        HelloServer helloServer = null;   
  
        try {   
  
            System.out.println("connect......");   
  
            String StrPortAddress = "http://localhost:8080/axistest/services/helloserver";   
  
            URL portAddress = new URL(StrPortAddress);   
  
            // 得到客户端服务   
  
            service = new HelloServerServiceLocator();   
  
            // 得到客户端stub   
  
            helloServer = service.gethelloserver(portAddress);  
  
            // 测试服务方法   
  
            String resultStr = helloServer.sayHello("iteye");  
  
            System.out.println(resultStr);   
  
        } catch (Exception e) {   
  
            e.printStackTrace();   
  
        } finally {   
  
            System.out.println("End.");   
  
        }   
}  
}

终结 ……