使用axis开发WebService(总结)

?

第二部分：开发热身(先给自己一点自信，快速体验WebService，不过这并不是实际开发中常用的)

言归正传，进入具体开发过程：

1.?下载axis1.4最新版本http://apache.mirror.phpchina.com/ws/axis/1_4/?（我没有打开这个网页，但是谷哥给我提供了下载地址，当然还是咱们的CSDN啦，http://download.csdn.net/download/renyuanchunby/3542767这个网址的网友可是免费提供的哦。）（我是这样理解的：这个东西可以当成一个示例代码，里面有jar包同时配置文件也写好了，可以拿来用）。

2.??将解压后的axis-1_4文件下的webapps目录下的axis目录考到

%TOMCAT_HOME%Webapps/目录下

3.?启动tomcat的.输入路径http://localhost:8080/axis ?打开axis主界面

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

1、Dynamic Invocation Interface ( DII)

2、Stubs方式

3、Dynamic Proxy方式

?=====================================================

我们先来了解一下第一种方式，算是给自己打气，因为以下几步很容易操作，还是拿来主义吧，把网友的东西贴过来看看！！！

第一种Dynamic Invocation InterFace(DII)　开发方式

步骤1:打开eclipse创建一个新项目编写一个类.代码如下:

?????????????? public class SayHello {//这个类没有包,注意了.

?????????????????? public String say(String name){
??????????????????????? return " Hello ~~" + name;
?????????????????? ?}
??????????????? }

步骤2:

编写好上面的类(SayHello.java)后,将源代码copy到%tomcat_home%webapps

/axis/目录下.这里要注意了,只需要把类考备到这个目录下

,然后重命名为:SayHello.jws?（jws就是java webservice的缩写哦）

步骤3:

打开你的浏览器:http://localhost:8080/axis/SayHello.jws?打开页面后你会看到

??Click to see the WSDL??<--点击链接,如果你上面的步骤都正常,类也没有带

包的话,那么就生成了wsdl了.

恭喜你！到这里DII方式的服务器端编写完成了.接下来我们来看一下客户端是怎么调

用的

步骤4:DII方式的客户端的调用.

?首先将axis/web-inf/lib/目录下的axis.jar,commons-discovery-0.2.jar,

comm.ons-logging-1.0.4.jar导入到刚才的项目中,因为编写客户端时

要用到这些包.客户端代码如下:

??package com.huwd.web;

??import org.apache.axis.client.Call;
??????????import org.apache.axis.client.Service;

??public class ToClient {

?????????????? ?public static void main(String args[]) throws Exception {
??
?????????????????????????? String urlname = "http://localhost:8080/axis/SayHello.jws";
??????????????????????????? //这是wsdl的绝对路径.也可以直接写成如下,这个没有区别．

//String urlname=”http://localhost:8080/axis/SayHello.jws?wsdl”
?????????????????????????? Service s = new Service();
??
??????????????????????????? Call call = (Call)s.createCall();
??
????????????????????????? call.setOperationName("say");//注意。这里是要调用的方法名
??
????????????????????????? call.setTargetEndpointAddress(urlname);//设置调用的目标url
??
?????????????????????????? String val = (String)call.invoke(new Object[]{"我是Blue’s Boy!"});????? ????????????//设置调用方法中的参数
??
???????????????????????????System.out.println("这是webservice服务器返回给你的:>>>>"+val);
??
??????????????????? ?}
?????????????? }

运行结果输出:Hello ~~我是Blue’s Boy;

以上几步，我做完后，感觉信心大增，WebService也没想象中的那么难吗，服务器端代码的java文件改名称.jws，发布后就生成了WSDL文件了啊，接着客户端调用一下不就OK了吗，太简单啦。但是有没有发现刚才的作法是把服务器端的java代码改了个后缀名.jws啊,实际开发中，经常是要夸项目调用其他项目的接口的，他们而且也不一定是用java写的吧，或者我们作为客户端也不是java语言吧，总而言之，操作性不强。

为此，以下才是我们的重点！！！！

第三部分：进入重点(这一部分才是我们经常用到的，也是网上说的最多的，我通过小例子做成功了，现在总结一下)

很多网友说这里是第二种即Stubs方式，我也这样认为吧。Stubs方式是最通用的做法，又因其灵活的特点，建议使用这种方式.

下面是详细的开发步骤:

?----------------------------------------------------------------------------------------------

（I）服务器端的开发

1)?创建web工程

1、MyEclipse 下创建web project,取名为webserviceServer;

2、新建文件夹 文件夹名为lib,然后 将下载下来的axis 其 axis-1_4lib 目录下的jar 拷贝到lib目录下，将这些jar导入项目中,如图:

2) .编写Server 程序（服务器端代码）

1、? 新建class

import com.cxx.bean.User;

public class HelloServer {
?//服务端,传递的是一个自定义的数据类型 User
?
? ? public String getBeanStr(User bean){
?
? ? ? ?return "You Name:"+bean.getName() + ",You Age:" + bean.getAge();
?
? ? }
}

2、配置web.xml

web.xml文件很容易配置，拷贝axis包里面的示例的web.xml配置到我们的工程中的web.xml中就可以了。正式开发的大项目也很多是直接copy这里的！！

<?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部署工具 将我们的项目部署到Tomcatwebapp目录下

或者直接在%TOMCAT_HOME%conf下的server.xml问文件中加

<Context path="/webserviceServer" docBase="E:projectworkspacewebserviceServerWebRoot" reloadable="true" debug="0" privileged="true">

?????? </Context>

这样就不用每次改动后在redeploy了。。。

?

4、 创建 deploy.wsdd文件

这个文件可以在任意目录下创建，这里我将它放到了WebRoot下:

示例代码：

<deploymentxmlns="http://xml.apache.org/axis/wsdd/"

?

??? xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">

?

??? <!--这里的helloserver为wsdd描述符中的ServiceNamespace?-->

?

??? <servicename="helloserver"provider="java:RPC">

?

??????? <!--这里的ClassName就是我的服务类了，这个服务主要功能就是传递一个自定义的对象?-->

?

??????? <parametername="className"value="com.cpic.server.HelloServer"/>

?

??????? <!--这里描术的意思是，此服务类中的方法全部享出来. value值为*号

?

??????? 如果你只想让你的客户端只能调用其中一个方法时，value值改为方法名就可以了． -->

?

??????? <parametername="allowedMethods"value="*"/>

???????

??????? <!--这个typeMapping是类型映射，使传递的参数序列化用反序列化，一个自定义类型在要网络上传递，那就一定得让他序列化． -->

?<typeMapping

??????? deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"

?

??????? encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"

?

??????? qname="ns1:User"

??????? serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"

?

??????? type="java:com.cpic.bean.User"

?

??????? xmlns:ns1="http://bean.cpic.com"/>

?

</service>

?

?<servicename="SayHello"provider="java:RPC">

? <parametername="className"value="com.cpic.server.SayHello"/>

? <parametername="allowedMethods"value="*"/>

?</service>

?

</deployment>

?

?5、生成 server-config.wsdd?文件

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

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

set AXIS_HOME=WEB-INF

set AXIS_LIB=%AXIS_HOME%lib

set AXISCLASSPATH=%AXIS_LIB%axis.jar;%AXIS_LIB%commons-discovery-0.2.jar;%AXIS_LIB%commons-logging-1.0.4.jar;%AXIS_LIB%jaxrpc.jar;%AXIS_LIB%saaj.jar;%AXIS_LIB%log4j-1.2.8.jar;%AXIS_LIB%wsdl4j-1.5.1.jar;%AXIS_LIB%xml-apis.jar;%AXIS_LIB%xercesImpl.jar;

?java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient -lhttp://localhost:8080/webserviceServer/services/SayHello deploy.wsdd

?

下来，在执行deploy.bat（注意该文件的AXISCLASSPATH和java命令要写到一行，建议b不要再记事本中编辑）前，请确保Tomcat服务已运行，运行bat文件，或者通过CMD来运行，（建议后者）

看到如上图的运行的结果 Done processing，表明已经在%TOMCAT_HOME%webappswebserviceServerWEB-INF目录下生成了server-config.wsdd文件.

在第一次发布service的情况下，需用bat文件生成server- config.wsdd，后续开发过程中，使用手工直接修改server- config.wsdd文件。

?

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

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

就能够看到WSDL文件了（XML类型的文件）。

?--------------------------------------------------------

（II）客户端的开发

?1）使用axis的Wsdl2Java命令生成一个客户端

新建一个Java项目testforepolicy，模拟客户端

为了方便，我们写个脚本WSDL_SERVERTEST.CMD,将其放到src下

set AXIS_HOME=E:projectworkspacetestforepolicy

set CLASSPATH=.;%AXIS_HOME%libaxis.jar;%AXIS_HOME%libaxis-ant.jar;%AXIS_HOME%libcommons-discovery-0.2.jar;%AXIS_HOME%libcommons-logging-1.0.4.jar;%AXIS_HOME%libjaxrpc.jar;%AXIS_HOME%libwsdl4j-1.5.1.jar

java org.apache.axis.wsdl.WSDL2Java -p com.cpic.sertest http://localhost:8080/webserviceServer/services/helloserver?wsdl

?

同上面第5步一样，执行这个脚本

这时就会在E:projectworkspacetestforepolicysrccomcpicsertest生成

或者还有一种方式，先创建项目，然后在项目所在目录下（跟src同级），创建一个bat文件：

set Axis_Lib=E:projectworkspacetestProjectlib
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%
set Output_Path=%cd%src
set Package=com.service.test.services.impl
rem set Package=test.axis
rem %Java_Cmd% org.apache.axis.wsdl.WSDL2Java -o%Output_Path% --skeletonDeploy true SoapApplyBusiness.wsdl
%Java_Cmd% org.apache.axis.wsdl.WSDL2Java -Nurn:SoapBusiness com.service.test.services.impl?-o%Output_Path%http://localhost:8080/webserviceServer/services/helloserver?wsdl

pause

?

其中上面的

set Package=com.cpic.b2bi.service.newhyx.services.impl是用来分包的，把javaBean和Service分开的

rem是注释的意思

2）调用服务器端接口方法

package test.first;

?

import java.rmi.RemoteException;

import javax.xml.rpc.ServiceException;

import com.cpic.sertest.HelloServerService;

import com.cpic.sertest.HelloServerServiceLocator;

import com.cpic.sertest.HelloserverSoapBindingStub;

import com.cpic.sertest.User;

/**

?* 存根(Stubs)

?* @author Administrator

?*

?*/

publicclass HelloServerInterClientStub {

???

??? publicstaticvoid main(String[] args) {

?????? HelloServerService service =new HelloServerServiceLocator();

??????

?????? User user = new User();

??????

?????? user.setAge(25);

?????? user.setName("mys");

??????

?????? try {

?????????? HelloserverSoapBindingStub soap = (HelloserverSoapBindingStub) service.gethelloserver();

??????????

?????????? System.out.println("服务器返回："+soap.getBeanStr(user));???

??????????

?????? } catch (ServiceException e) {

?????????? //TODO Auto-generated catch block

?????????? e.printStackTrace();

??? ??? } catch (RemoteException e) {

?????????? //TODO Auto-generated catch block

?????????? e.printStackTrace();

?????? }

??????

??? }

?

}

?注意：

服务器端的代码中如果传入或者返回的是一个自定义的对象类型，这时需要对deploy.wsdd做修改，详见上面的

? 2) .编写Server 程序（服务器端代码）-----4 创建 deploy.wsdd文件，中helloserver部分的详细解释

此处可以仿照上面的步骤做出helloserver这个service。。。。