WebService Axis 快速开发

WebService Axis 快速开发

一、开发环境
  •Myeclipse8.0
  •Tomcat6.0
  •Axis1.4
  •Jdk1.6
Axis下载：
  Google：”Axis”，很容易找到Apache Axis的链接地址：http://ws.apache.org/axis/，下载最新的1.4Final。
（好了准备工作做好了，现在我们来开发WebService！）

二、用Java 开发 WebService Axis简单实例
Axis支持三种WebService 的部署和开发，分别为：
    1、Dynamic Invocation Interface(DII)方式
    2、Dynamic Proxy方式
    3、Stubs方式
Stubs方式是最通用的做法，又因其灵活的特点，所以我建议使用这种方式。下面，我主要讲述这种方式的开发。
1）创建Web工程
    1、在Myeclipse上创建web工程，名为Test；
    2、将jar包拷贝到WEB-INF/lib目录下；
2）编写wsdd发布web服务
    1、在src目录下创建服务端程序HelloDateServer.java，包名为：
src/mypackage.server/HelloDateServer.java

package mypackage.server;
	
import java.util.Date;
	
//WebService服务端类
public class HelloDateServer {
   /**
    * 服务方法
     * @param yourName
    * @return
    */
    public String helloDate(String yourName){
        String rtStr = "Hello ,"+yourName+" ,it's: " + new Date();
        return rtStr;
    }

    //Add method here......

}

在Tomact环境发布一个WebService 只需要写两个配置文件：
web.xml 、 server-config.wsdd
web.xml文件是用来声明Webserver的，即声明server-config.wsdd文件（我个人的理解）。
server-config.wsdd是Web服务的发布配置文件

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

WEB-INF/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>

server-config.wsdd 文件是WebService的核心配置文件。Web服务能否发布，很大程度上取决于次文件的配置。可以说有了此文件，就有了Web服务。
有两种方式可以配置此文件：
   1、手写；
    2、用Axis工具生成。
我采用Axis工具生成（偷懒是其次,主要原因是不容易出错，也很容易开发）。
用Axis的工具，我们必须为Axis搭建一个环境，因为刚才我们下载下来的都是jar包，在windows下要想应用这下jar包，必须将其添加到系统的CLASSPATH中。否则系统无法找到这些功能。

将所有的jar包都添加到CLASSPATH;
创建环境变量，设置AXIS的环境变量.

变量名：AXIS_LIB
变量值：C:\axis-1_4\lib[color=red]（我是直接将下载下来的包解压到C盘）[/color]
将以下变量值加入CLASSPATH
%AXIS_LIB%\axis.jar;
%AXIS_LIB%\axis-ant.jar;
%AXIS_LIB%\commons-discovery-0.2.jar;
%AXIS_LIB%\commons-logging-1.0.4.jar;
%AXIS_LIB%\jaxrpc.jar;
%AXIS_LIB%\log4j-1.2.8.jar;
%AXIS_LIB%\saaj.jar;
%AXIS_LIB%\wsdl4j-1.5.1.jar;

编写deploy.wsdd文件
在任意路径下创建。我是在myeclipse工程中WEB-INF下创建的。部署时便于生成server-config.wsdd同时也便于工程修改时，修改此文件。

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

(简单吧!)
接下来就是生成server-config.wsdd文件！
生成server-config.wsdd配置文件
第一步：用Myeclipse部署Test工程并运行Tomcat


第二步：（关键的一步）打开命令与提示符，进入Test工程目录的WebRoot/WEB-INF目录下。
C:\>cd C:\apache-tomcat-6.0.20\webapps\Test\WEB-INF (我的Tomcat直接解压到c盘)
>java org.apache.axis.client.AdminClient –l http://localhost:8080/Test/services/stubs deploy.wsdd (这句话就是生成server-config.wsdd文件的命令，记住，保持Tomact是运行的，不然会报错！)
运行结果：

- Unable to find required classes (javax.activation.DataHandler and javax.mail.i
nternet.MimeMultipart). Attachment support is disabled.
Processing file deploy.wsdd
<Admin>Done processing</Admin>

(Activation.jar 和 mail.jar这两个包我们没有加入到CLASSPATH中，但是不影响我们的开发。)在此路径下就生成了server-config.wsdd文件了。（哈，这就是我们想要的文件）
将其拷贝到我们的eclipse工程中，以便我们以后部署。
好了大功告成！WebService发布了。重启Tomcat
我们来测试一下，发布是否成功。
Myeclipse给我们提供了Soap工具。打开SOAP Web Services Explorer

然后点击WSDL Page

点击WSDL Main
输入URL：http://localhost:8080/Test/services/stubs?wsdl
接下来就可以测试了！ 我按照刚刚写的代码，没有问题。

3）生成客户端client stub文件打开浏览器，输入http://localhost:8080/Test/services/stubs?wsdl点击文件->另存为。存到任何目录。我是存在C:\apache-tomcat-6.0.20\webapps\Test\WEB-INF 这样，我的命令提示符就不用换路径了。

stubs.xml重命名为stubs.wsdl

在命令提示符输入如下命令：

java org.apache.axis.wsdl.WSDL2Java –o ./ -p mypackage.client stubs.wsdl

解释一下此命令：

java org.apache.axis.wsdl.WSDL2Java –o %Output_Path% -p %Package% stubs.wsdl

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

将生成的client文件拷贝到myeclipse中。



接下来，在mypackage.client中添加客户端测试代码。

src/mypackage/StubsClient.java

package mypackage.client;

import java.net.URL;

public class StubsClient {

	/**
	 * @param args
	 */
	public static void main(String[] args) {
		// TODO Auto-generated method stub
		// 定义的service和stub
		HelloDateServerService service = null;
		HelloDateServer stub = null;
		try {
			System.out.println("connect......");
			String StrPortAddress = "http://localhost:8080/Test/services/stubs";
			URL portAddress = new URL(StrPortAddress);
			// 得到客户端服务
			service = new HelloDateServerServiceLocator();
			// 得到客户端stub
			stub = service.getstubs(portAddress);
			// 测试服务方法
			String resultStr = stub.helloDate("Google");
			System.out.println(resultStr);
		} catch (Exception e) {
			e.printStackTrace();
		} finally {
			System.out.println("End.");
		}
	}
}

现在所有的都做完了。试试看吧。一定成功！

用Axis发布Web服务就这么简单。
我这个简单的Web服务的服务类方法的参数是简单的String类型。如果你的工程要求服务类方法传递自定义参数比如UserInfo等等，就需要你研究一下怎么传递自定义类型参数。其实也不难。可以参考http://blog.csdn.net/kay5804/archive/2008/05/04/2382428.aspx。这个人写的很不错！

刚打球回来，又做电脑旁边这么久，脖子疼，感觉自己得颈椎病了。

我要讲的就这么多，旨在，帮助大家快速入手Web Service。如果有什么问题，可以给我留言，有什么错误请指出。谢谢！