如何使用axis构建SOAP应用程序

爱拼才会赢1991

关注

原创最新推荐文章于 2026-08-05 17:56:17 发布 2.2k 阅读 AI 写同款· GEO 优化 ›

webservice soap协议 JAX-WS提供了一组用于开发SOAP协议的Web服务的API，可以轻松地创建和部署SOAP Web服务。总的来说，JAX-WS和Axis是用于开发SOAP协议的Web服务的工具和框架，它们可以与HTTP+SOAP协议一起使用，以实现在Web服务中进行结构化的信息交换。HTTP+SOAP：HTTP+SOAP是一种基于HTTP协议的SOAP Web服务。当您使用 JAX-WS 构建 Web 服务时，您实际上是在使用 SOAP 协议，因为 JAX-WS 是 SOAP 协议的一种 Java 实现。阅读详情

本文档的所有源码：http://download.youkuaiyun.com/detail/feichenwangyalin/7911159

你可以根据将其中的SoapServer和SoapClient导入Eclipse，将axis放入tomcat的webapps中。

1.基本概念

1.1 SOAP的概念

SOAP即简单对象访问协议，是交换数据的一种协议规范，是一种轻量的、简单的、基于XML（标准通用标记语言下的一个子集）的协议。简单的说，SOAP也是web service的一种实现形式，是一个系统对外发布的一种服务，但其数据的交换形式是XML。

SOAP的三大重要的部件是：接口程序（即服务端代码）、WSDL（即web servicedescription language）、WSDD（web servicedeploy description），不是很清楚基本概念的读者可以先百度下这些基本概念。

1.2 为什么要使用SOAP

实现webservice的形式的有多重多样，而SOAP也只是实现接口的其中一种形式。首先我们得明白，我们的系统为什么要对外发布接口，就拿电信软件来说吧，我们知道一个电信运行商需要支撑其各种业务需要各种系统，虽然都是一个运行商，但其内的各个系统并不一定是一个软件厂家开发，比如BOSS（运营支撑系统）有A公司开发，而彩铃业务系统有B公司开发，某营销系统有C公司开发，虽然这些系统同属一个公司，但很明显A公司的BOSS系统得源码是不可能对其他系统开放的，因此这些系统之间的交互就需要通过相互调用接口来实现，而这个接口各个系统发布的接口包括HTTP接口、SOAP接口等等。

2.使用axis开发SOAP应用程序

2.1 axis简介

Axis是对Java官方提供的Javawebservice的一种封装，axis最大的优点在于可以根据服务端提供的wsdl直接生成客户端代码，作为调用者可以透明地调用服务端接口，就如同服务器端接口在本地一样。

2.2 服务端接口开发

下面我们将做一个实验，开发一个简单的接口，并描述如何通过ant脚本构建项目，生成服务器端接口代码、wsdl、wsdd以及客户端用jar包，这几个就是我们在1.1中提过的SOAP应用程序的四个要素。

构建过程如下图所示：

下面给出最为重要的build.xml源码，这个构建过程是完全按照上图的构建顺序进行构建的，其中有注解，读者可以查阅理解：

<?xml version="1.0"?>

<project name="SoapServer" basedir=".">
	
	<!-- 定义各种路径 -->
	<property name="srcDir" location="src" />
	<property name="outputDir" location="output" />
	<property name="classDir" location="output/classes" />
	<property name="jarDir" location="output/lib" />
	<property name="srcJarFile" location="${jarDir}/SoapServer.jar" />
	<property name="java2wsdlDir" location="output/wsdl" />
	<property name="genwsddDir" location="output/wsdd" />
	<property name="wsdl2javaDir" location="output/java" />
	
	<property name="wsdl2classDir" location="output/class" />
	<property name="wsdl2jarFile" location="${jarDir}/SoapServer_axis.jar" />
	
	<!-- 定义axis支持包 -->
	<property name="axisHome" location="lib" />
	<property name="name" value="TestSoap" />
	<property name="version" value="1.0" />
	<property name="author" value="author:Martin" />
	
	<!-- 指定axis classpath -->
	<path id="axis.classpath">
		<fileset dir="${axisHome}">
			<include name="**/*.jar" />
		</fileset>
	</path>
	<taskdef resource="axis-tasks.properties" classpathref="axis.classpath" />
	
	<!-- 一些基本信息-->
	<echo message="----------- ${name} ${version} [${author}] ------------" />
	
	<!-- 文件目录初始化 -->
	<target name="init">
		<delete dir="${outputDir}" />
		<delete dir="${classDir}" />
		<delete dir="${jarDir}" />
		<delete dir="${java2wsdlDir}" />
		<delete dir="${wsdl2javaDir}" />
		<delete dir="${wsdl2classDir}" />
        <delete dir="${genwsddDir}" />
		
		<mkdir dir="${outputDir}" />
		<mkdir dir="${classDir}" />
		<mkdir dir="${jarDir}" />
		<mkdir dir="${java2wsdlDir}" />
		<mkdir dir="${genwsddDir}" />
		<mkdir dir="${wsdl2javaDir}" />
		<mkdir dir="${wsdl2classDir}" />
	</target>
	
	<!-- 开始编译,生成classes文件 -->
	<target name="compile" depends="init">
		<javac srcdir="${srcDir}" destdir="${classDir}" />
	</target>
	
	<!-- 根据生成的classes, 打包生成jar -->
	<target name="makeJar" depends="init,compile">
		<jar destfile="${srcJarFile}" basedir="${classDir}" />
	</target>

	<!-- 生成wsdl -->
	<target name="buildJava2Wsdl">
		<axis-java2wsdl classname="com.martin.intrefaces.SoapiSayHello" 
			            location="http://localhost:8080/axis/services/SoapiSayHello" 
			            namespace="http://intrefaces.martin.com" 
			            output="${java2wsdlDir}/SoapiSayHello.wsdl" style="RPC">

			<classpath>
				<pathelement path="${classDir}" />
			</classpath>
		</axis-java2wsdl>
	</target>
	
	<!-- 根据生成的wsdl生成对应的java代码以及wsdd文件 -->
	<target name="buildWsdl2Java">
		<axis-wsdl2java all="true" 
			            url="${java2wsdlDir}\SoapiSayHello.wsdl" 
			            deployscope="Request" 
			            output="${wsdl2javaDir}" 
			            serverside="true"
			            testcase="false" 
			            noimports="false" 
			            typemappingversion="1.2">

		</axis-wsdl2java>
		<!-- 将生成的deploy.wsdd移动至指定位置，并重命名 -->
		<move tofile="${genwsddDir}/SoapiSayHello.wsdd" file="${wsdl2javaDir}/com/martin/intrefaces/deploy.wsdd"></move>
	</target>
	
	<!-- 将wsdl生成的Java代码编译打包 -->
	<target name="compileWsdl2Jar">
		<!--编译成class文件 -->
		<javac srcdir="${wsdl2javaDir}" destdir="${wsdl2classDir}">
			<!-- 编译时 引用axis的jar包 -->
			<classpath>
				<fileset dir="${axisHome}">
					<include name="**/*.jar" />
				</fileset>
			</classpath>
		</javac>
		<!--将class文件打包成jar -->
		<jar destfile="${wsdl2jarFile}" basedir="${wsdl2classDir}" />
	</target>

</project>

构建完毕后，我们来查看构建出来的产物，如下图所示：