WebService Axis 快速开发

[b][size=x-large]WebService Axis 快速开发[/size][/b]

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

[b]二、用Java 开发 WebService Axis简单实例[/b]
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[/size]

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

}

[img]http://dl.iteye.com/upload/attachment/246583/bd6061bb-3f77-3c1d-adac-d85ce50616e9.png[/img]
[size=large]在Tomact环境发布一个WebService 只需要写两个配置文件：
web.xml 、 server-config.wsdd
web.xml文件是用来声明Webserver的，即声明server-config.wsdd文件[color=red]（我个人的理解）。[/color]
server-config.wsdd是Web服务的发布配置文件

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

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>

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

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

变量名：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;

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

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

[size=large][color=red](简单吧!)[/color]
[color=darkred]接下来就是生成server-config.wsdd文件！[/color]
生成server-config.wsdd配置文件
[b]第一步：用Myeclipse部署Test工程并运行Tomcat
[/b]
[img]http://dl.iteye.com/upload/attachment/246585/319c3439-4aec-3586-b175-c36047562704.png[/img]
[b]第二步：[color=red]（关键的一步）[/color]打开命令与提示符，进入Test工程目录的WebRoot/WEB-INF目录下。[/b]
[b]C:\>cd C:\apache-tomcat-6.0.20\webapps\Test\WEB-INF (我的Tomcat直接解压到c盘)[/b]
[b]>java org.apache.axis.client.AdminClient –l http://localhost:8080/Test/services/stubs deploy.wsdd [color=red](这句话就是生成server-config.wsdd文件的命令，记住，保持Tomact是运行的，不然会报错！)[/color][/b]
[b]运行结果：[/b][/size]

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

[size=large][color=red](Activation.jar 和 mail.jar这两个包我们没有加入到CLASSPATH中，但是不影响我们的开发。)[/color]在此路径下就生成了server-config.wsdd文件了。[color=red]（哈，这就是我们想要的文件）[/color]
将其拷贝到我们的eclipse工程中，以便我们以后部署。
好了大功告成！WebService发布了。重启Tomcat
我们来测试一下，发布是否成功。
Myeclipse给我们提供了Soap工具。打开SOAP Web Services Explorer
[img]http://dl.iteye.com/upload/attachment/246587/45a66d9a-cec6-3eec-a252-063108e61dd9.png[/img]
然后点击WSDL Page
[img]http://dl.iteye.com/upload/attachment/246589/cbfa24e3-823c-3b50-a2eb-f5a1b6aa4b08.png[/img]
点击WSDL Main
输入URL：[url]http://localhost:8080/Test/services/stubs?wsdl[/url]
接下来就可以测试了！ 我按照刚刚写的代码，没有问题。

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

stubs.xml重命名为stubs.wsdl

在命令提示符输入如下命令：[/size]

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

[size=large]%Output_Path%是客户端文件输出路径，%Package%是包名。

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

[img]http://dl.iteye.com/upload/attachment/246591/facd29b1-4249-325f-a25d-c3400fb2a985.png[/img]

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

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.");
		}
	}
}

[size=large]现在所有的都做完了。试试看吧。一定成功！

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

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

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