如何用Axis2开发WebService服务

Axis2与sap的webservice调用接口指南1、设置环境变量AXIS2_HOME = D:\JAVA\axis2\axis2-1.6.22、下载工具：（1.6.2生成的代理类存在BUG，建议用1.5.1版本）Eclipse：/downloads/Tomcat：/Axis：/axis2/java/core/download.cgiaxis2-war：/axis2/java/core/tools/index.htmlaxis2-eclipse-codegen-plugin：/axis2/java/core/tools/index.htmlaxis2-eclipse-service-plugin：/axis2/java/core/tools/index.html安装JDK不用多说了吧。

3、安装Eclipse插件：axis2-eclipse-codegen-plugin和axis2-eclipse-service-plugin是Eclipse的插件，分别解压在Eclipse的根目录就可以了。

注意：Axis2 1.6.2有个BUG，需要添加两个额外的Jar放在eclipse\dropins目录下：org.apache.axis2.eclipse.codegen.plugin_0.0.0.SNAPSHOT.jarorg.apache.axis2.eclipse.service.plugin_0.0.0.SNAPSHOT.jar下载地址：https:///content/groups/snapshots/org/apache/axis2/axis2.eclipse.serv ice.plugin/SNAPSHOT/https:///content/groups/snapshots/org/apache/axis2/axis2.eclipse.cod egen.plugin/SNAPSHOT/4、在SAP端发布Webservice（之前我写过相关文档，发布Web服务的细节这里就不在赘述了）5、得到WSDL文件的地址，并保存为本地文件以wsdl作为文件扩展名http://r3ids01:8000/sap/bc/srt/wsdl/bndg_534F90D9B51D4480E10080000A3F001C/wsdl1 1/allinone/ws_policy/document?sap-client=8006、在eclispe 的package Explorer 中点击右键，在菜单中选择新建--->other--->Axis2 CodeGenerator7、点击next，进入下一个页面，选择从wsdl文件来产生java文件。

中文原文英文原文概述这个说明文档涉及以下内容：?????如何使用?axis2?创建?web service?和客户端程序?????如何定制一个模块?(Module)?并在?web service?中使用它?????Samples discussion?????Advanced Topics第一部分：简介Axis2?是重新设计的一个架构，它没有基于?Axis1.*?的结构，这种新的架构?much more flexible, efficient and configurable?。

Axis2?的特性有：Speed：采用自己的对象模型，利用?StAX?解析Low memory foot print：Axis2?在设计过程中一直遵循?low memory cost?的理念AXIOM：采用自己的轻量级的对象模型，使得消息处理过程可扩展、性能高，对开发者来说更加简单。

Hot Deployment：Axis2?装备了在系统运行时部署服务和处理器的能力。

也就是说，新的服务新服务的添加不再需要重启服务器。

将服务的发布包放在服务部属文件夹中，部署模型将自动部署该服务。

Asynchronous Web Services：Axis2?现在可以通过?non-blocking clients and transports?支持异步的服务和异步的服务调用。

（？什么是异步的服务???）MEP Support：Axis2?具备良好的伸缩性来支持?MEPs?，因为它内置了对?WSDL2.0?中?MEPs?的支持。

Flexibility：Axis2?的架构使得程序员能自由的对?Axis?添加扩展，这些扩展包括对自定义?Header?的处理，系统管理，甚至是任何一件你可以想象的到的事情Stability：Axis2?定义了一套公共接口，这些接口相对于其他代码而言改动很小Component-oriented Deployment：你可以自定义一些在处理过程中常用的可重用的处理器，并可以将这些处理器发布出来供其它人使用Transport Framework：定义了一个干净、简单的抽象作品来集成任意的传输协议，引擎的核心部分的实现是与传输协议无关的Add-ons：一些?web service?相关的协议也合并了进来。

WebService大讲堂之Axis2（8）：异步调用WebService在前面几篇文章中都是使用同步方式来调用WebService。

也就是说，如果被调用的WebService方法长时间不返回，客户端将一直被阻塞，直到该方法返回为止。

使用同步方法来调用WebService虽然很直观，但当WebService方法由于各种原因需要很长时间才能返回的话，就会使客户端程序一直处于等待状态，这样用户是无法忍受的。

当然，我们很容易就可以想到解决问题的方法，这就是多线程。

解决问题的基本方法是将访问WebService的任务交由一个或多个线程来完成，而主线程并不负责访问WebService。

这样即使被访问的WebService方法长时间不返回，客户端仍然可以做其他的工作。

我们可以管这种通过多线程访问WebService的方式称为异步访问。

虽然直接使用多线程可以很好地解决这个问题，但比较麻烦。

幸好Axis2的客户端提供了异步访问WebService的功能。

RPCServiceClient类提供了一个invokeNonBlocking方法可以通过异步的方式来访问WebService。

下面先来建立一个WebService。

MyService是一个WebService类，代码如下：package service;public class MyService{public String getName(){try{System.out.println("getName方法正在执行");// 延迟5秒Thread.sleep(5000);}catch (Exception e){}return "火星";}}为了模拟需要一定时间才返回的WebService方法，在getName方法中使用了sleep方法来延迟5秒。

下面是MyService类的配置代码：<!-- services.xml --><service name="myService"><description>异步调用演示</description><parameter name="ServiceClass">service.MyService</parameter><messageReceivers><messageReceiver mep="/2004/08/wsdl/in-out"class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/></messageReceivers></service>从上面的配置代码可以看出，MyService的配置方式与前几章的WebService的配置方式完全一样，也就是说，MyService只是一个普通的WebService。

使用axis实现Web Service一、实践过程1、在MyEclipse中新建一个testaxis应用工程，导入11个jar包文件后刷新testaxis应用工程，然后部署testaxis应用工程到Tomcat服务器中，截图如下：2、配置环境变量的信息CATALINA_HOME= C:\Tomcat_5_0AXIS_HOME= %CATALINA_HOME%\webapps\testaxis\WEB-INFAXIS_LIB=%AXIS_HOME%\libAXISCLASSPATH=%AXIS_LIB%\activation.jar;%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-disc overy-;%AXIS_LIB%\commons-logging-;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\log4j-;%AXIS_LI B%\mail.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\wsdl4j-;%AXIS_LIB%\xercesImpl.jar;%AXIS_ LIB%\xml-apis.jar3、确认testaxis应用的lib中包括上述的jar文件，包括文件名必须一样。

4、我要发布的服务是UserManage，待发布的java文件是UserManageInter.java和UserManageSoapBindingImpl.java，发布的方法是addPerson，JA V A代码如下：程序代码1：UserManageInter.javapackage ;import ;import ;public interface UserManageInter extends Remote {public void addUser(UserBean userBean) throws RemoteException;}程序代码2：UserManageSoapBindingImpl.javapackage ;import ;public class UserManageSoapBindingImpl implements UserManageInter{public void addUser( userBean) throws { return;}}//不用加处理代码程序代码3：UserBean.javapackage ;public class UserBean {private String ID;private String name;private String address;public String getAddress() {return address;}public void setAddress(String address) {this.address = address;}public String getID() {return ID;}public void setID(String id) {ID = id;}public String getName() {return name;}public void setName(String name) { = name;}}5、修改testaxis应用的web.xml文件，增加相关内容<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "/web-app_2_3.dtd"><web-app><display-name>Apache-Axis</display-name><listener><listener-class></listener-class></listener><servlet><servlet-name>AxisServlet</servlet-name><display-name>Apache-Axis Servlet</display-name><servlet-class></servlet-class></servlet><servlet><servlet-name>AdminServlet</servlet-name><display-name>Axis Admin Servlet</display-name><servlet-class></servlet-class><load-on-startup>100</load-on-startup></servlet><servlet><servlet-name>SOAPMonitorService</servlet-name><display-name>SOAPMonitorService</display-name><servlet-class></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><!-- uncomment this if you want the admin servlet --><servlet-mapping><servlet-name>AdminServlet</servlet-name><url-pattern>/servlet/AdminServlet</url-pattern></servlet-mapping><session-config><!-- Default to 5 minute session timeouts --><session-timeout>5</session-timeout></session-config><!-- currently the W3C havent settled on a media type for WSDL;/2003/WD-wsdl12-/#ietf-draftfor now we go with the basic 'it's XML' response --><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>6、重启应用，访问，应该可以看到目前系统所提供SOAP服务的列表，应该只有两个，都是自带的，（AdminService和Version），如图：7、根据deploy.wsdd 生成server-config.wsdd。

Web Service面试题：如何搭建Axis2的
开发环境
问题：Web Service面试题：如何搭建Axis2的开发环境回答：
1. 下载和安装Java （JDK1.4以上）。

设置JAVA_HOME环境变量。

2. 下载Axis2并解压到目标文件夹。

3. 拷贝axis2.war文件到你的Servlet引擎的webapps目录。

4. 设置AXIS2_HOME环境变量到步骤3的axis2.war所在文件夹。

大部分情况下还需要为我们的服务建立一个WSDL文件，Axis2的Java2WSDL可以用来生成一个WSDL。

如果要从一个Java类来生成一个WSDL，可按照以下步骤：
a. 建立和编译你的Java类
(Windows)
%AXIS2_HOME% bin java2wsdl -cp . -cn samples.quickstart.service.pojo.StockQuoteService -of StockQuoteService.wsdl
(Linux)
$AXIS2_HOME/bin/java2wsdl -cp . -cn samples.quickstart.service.pojo.StockQuoteService -of
StockQuoteService.wsdl
b. 使用命令行来生成WSDL:
生成命令行以后，你就可以按照你的需要进行修改，例如你可能需要添加一个定制的错误处理，或者改动生成的元素的名字。

一、Axis2简介1.1 介绍Axis2Axis框架来自Apache 开放源代码组织，它是基于JAVA语言的最新的SOAP 规范（SOAP 1.2）和SOAP withAttachments 规范（来自Apache Group ）的开放源代码实现。

有很多流行的开发工具都使用AXIS作为其实现支持Web服务的功能，例如JBuilder以及著名的Eclipse J2EE插件Lomboz。

AXIS的最新版本可以从/axis/index.html下载。

下载下来后直接解压即可用了。

下图是AXIS核心引擎的体系结构图：整个AXIS项目包括以下几个部分：ü消息流子系统消息流子系统提供了灵活的消息传递框架，这个消息传递框架包括处理程序、链、序列化程序和反序列化程序。

处理程序是一个处理请求、响应和故障流的对象。

处理程序可被组合在一起成为链，而且可以使用一个灵活的部署描述符来配置这些处理程序的顺序。

ü传输框架子系统提供了一个传输框架，这个传输框架可以帮助您创建自己的可插式传输发送器和传输侦听器。

ü数据编码子系统AXIS完全按照XML Schema 规范提供各种数据类型的自动序列化，并且提供功能扩展接口来使用您自己定制的序列化器和反序列化器。

ü其他AXIS完全支持WSDL 以及日志记录、出错以及故障处理机制。

它同时提供一些工具用来讲WSDL文档转换成客户端的调用框架以及根据类来产生WSDL定义文档。

AXIS目前版本支持的标准是：W3C SOAP1.1 和1.2；WSDL 1.1；SAAJ 1.1（SUN公司：SOAP with Attachments API for Java）；JAX-RPC（SUN公司：Java APIfor XML-Based RPC）1.0。

1.2 开发项目中如何选择使用Axis2和其它的WebService²如果你的应用程序需要支持多语言即有C++, .net, Java，你应该选择Axis2。

Axix2 webservice 开发教程例子简单易懂，很适合初学者。

开发环境：jdk1.6 tomcate5.0 Myeclipse5.0步骤：1.下载axis2所用包axis2-1.4.1-bin.zip 和axis2-1.4.1-war.zip并解压下载地址：/axis2/2．解压axis2-1.4.1-war.zip 将axis2.war 放到%TOME_HOME%\webapps中.启动Tomcate. IE地址输入：http://localhost:<port>/axis2/ .出现以上表示环境搭建成功。

3.下面开始开发自己的axis2 ws:创建web项目：我的项目工程名为axis2demo;将axis2-1.4.1\lib下所有jar导入。

创建一个HelloWorld.java在META-INF下建一个service.xml文件。

<?xml version="1.0" encoding="UTF-8"?><service><parameter name="ServiceClass" locked="false">com.xwx.demo.HelloWorld<poeration name="sayHello"><messageReceiverclass="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> </poeration></parameter></service>注：关于service.xml的参数配置自己baidu+google4.就开始准备一下axis2的eclispe的插件了。

axis2的eclispe插件分为2个，一个是帮助我们生成aar文件的，另一个是帮我们用wsdl文件生成stub代码的。

一、准备工作1.下载axis2相关jar包目前最新版本为 1.6.2;将axis2-1.6.2-bin.rar,axis2-1.6.2-war.zip一并下载下来,下载地址：/axis2/java/core/download.cgi2.下载axis2插件：axis2-eclipse-codegen-plugin-1.6.2.zip、axis2-eclipse-serv ice-plugin-1.6.2.zip,下载地址：/axis2/jav a/core/tools/index.html3安装Eclipse插件，安装成功如下图：5.新建Web Project（axis2_Serv ice）将axis2-1.6.2-bin\lib下的jar拷贝到axis2_Serv ice\lib下，打开axis2-1.6.2-war.zip\axis2\WEB-INF下的conf、modules、services 解压到项目（axis2_Serv ice）WebRoot\WEB-INF下6.修改web.xml文件，添加如下代码：7.添加两个类：bean类和服务类Bean类：package .zjl.entity;import java.io.Serializable;public class User implements Serializable{/****/private static final long serialVersionUID = 1L;private int id;private String name;public int getId() {return id;}public void setId(int id) {this.id = id;}public String getName() {return name;}public void setName(String name) { = name;}}要发布的服务类：package .zjl.service;import er;public class UserService {public User getUser(User user) {System.out.println("service:"+user.getId());System.out.println("service:"+user.getName());User po2 = new User();po2.setId(1);po2.setName("zjl");return po2;}}8．Axis2插件工具生成aar文件，发布WebService在项目上右击->new->other选择Axis2 Serv ice Archiv er，点击nextClass File Location选择工程路径下的classes文件,点击Next勾选Skip WSDL项，点击next这里没有jar文件，所以默认，点击Next勾选Generate the serv ice xml automatically项，点击NextServ ice Name 随便写记住就行，Class name包名点类名称点击Load会出现这个类下的所有方法名称，点击NextOutput location选择输出文件位置（具体位置根据具体而定），点击Finsh说明成功。

Apache Axis2 插件安装以及实现WebService接口一、Eclipse安装Axis2插件及应用1、环境准备：Eclipse – j2ee需要的Axis2压缩包文件解压后的文件名为 axis2-1.4.1目录解压后的文件结构如图：2、配置EclipseEclipse自带了开发WebService的工具第一步：打开Eclipse-->点击菜单windows-->Preferences-->WebServices-->Axis2Preferences-->设置Axis2 runtimelocation为Axis2下载后并解压的核心包的位置：选择后Eclipse会自动检测包是否正确。

如果successfully提示表示设置正确第二步：在Eclipse创建一个WebProject时，点击Configuration的Modify会出现下图界面：勾选Axis2 Web Services按OK。

回到新建WebProject界面，完成项目创建。

创建成功后会发现在WEB-INF文件夹下会多出一个axis2-web的文件夹，这个是Axis2的项目文件夹。

现在启动服务器会抛出异常，这是因为Eclipse在自动加载生成该项目时有几个问题需要手动修复，下面分别列出：问题一：会抛出异常：ng.ClassNotFoundException:org.apache.axis2.transport.http.AxisAdminServlet 是因为生动生成的web.xml文件中所指定的AxisAdminServlet包路径有错。

自动生成的源码如下：注意红色字体部分，我们可以去看一下所下载的Axis2的源包。

AxisAdminServlet类所在的包路径并不在下列这个路径中org.apache.axis2.transport.http，该类是属于包org.apache.axis2.webapp下。

在eclipse 中创建webservice项目方法一：使用xfire支持1.创建Dynamic Web Project 项目：2.将编译路径改为项目/web-INF/classes；3.将META-INF 文件夹移动到src下面，并在META-INF 中创建xfire文件夹，文件夹内放入services.xml文件；4.添加xfire支持的jar包：5.编写web.xml:7.编写services.xml可以存在多个service；8.访问http://localhost:port/projectName/services/url-pattern?wsdl(蓝色字体均为相应的内容)；方法二：使用Axis2支持1.1Axis2发行包Axis2以多个发行包发行。

你需要哪个视你所需决定。

1.1.1标准二进制发行包如果你正在开发服务和应用程序，你需要Axis2标准二进制发行包。

这个发行包包括所有必要的*.jar文件，以及很多便于开发用的脚本。

它具有以下结构。

Axis2标准二进制发行包目录的结构binaxis2.bataxis2.shaxis2server.bataxis2server.shjava2wsdl.batjava2wsdl.shwsdl2java.batwsdl2java.shsetenv.shlibactivation-1.1.jar...XmlSchema.jarrepositorymodulesmodules.listaddressing-1.1.mar...servicesservices.listversion.aar...samples...webapp...confaxis2.xmlLICENSE.txtREADME.txtNOTICE.txtINSTALL.txtrelease-notes.htmlbin目录包括一些有用的脚本。

它们包括axis2.bat（或者axis2.sh），这个文件可以让你在不手工添加Axis2 jar文件到类路径的情况下方便的执行Java命令；java2wsdl.bat（和.sh）和wsdl2java.bat（和.sh），它可以让你轻易的从一个WSDL文件生成Java代码，反之亦然；axis2server.bat（和sh），一个简易Web服务器，它可以让你早自己的应用程序中搭建Axis2的功能来发送接收消息。