上一篇
目    录
下一篇
  Apache Axis2安装指南

这篇文档提供了关于Axis2发行包、系统必备条件和安装环境变量以及工具的信息，另外还有详细的安装方法指导。

发送你的反馈到：axis-dev@ws.apache.org 邮件列表。（订阅细节可以在 Axis2 site 上找到。） 请在每份email的标题前加上[Axis2]。
  目录

  Axis2发行包

Axis2以各种方便的发行包进行发布，并且可以以独立服务器或者作为J2EE兼容的servlet容器的一部分安装。Axis2是在Apache许可协议2.0版下发布的。这篇安装指南将主要讲述用标准二进制发行包来运行Apache Axis2。下载 Apache Axis2 1.3版发行包（最新）。下载 Apache Axis2的所有发行版本。提供的发行包如下所示：

 1. 标准二进制发行包
这是Axis2的完整版本，包括示例和方便的脚本。下载标准二进制发行包。

 2. WAR（Web Archive）发行包
这是Axis2的一个Web应用，它能部署在大多数Servlet容器中。下载 WAR (Web Archive)发行包。

 3. 文档发行包
这个发行包包含了所有的文档。包括xdocs和这个项目的Java API文档。下载文档发行包。

 4. 源码发行包
这个发行包包含了Axis2标准发行包的源码，它主要是提供给高级用户。用户可以通过输入$mvn –Drelease install来用源码生成一个二进制发行包。你必须在运行这个命令前线建立Axis2环境。详细的如何一步一步建立一个二进制发行包的过程可以在高级部分找到。下载源码发行包。

  系统需求

Java Development Kit (JDK) 1.4 或者更新（如果要知道如何在不同的操作系统上安装JDK，请访问http://java.sun.com）
磁盘 大约需要11M独立空间来安装标准二进制发行包
操作系统 在Windows XP, Linux, Mac OS X, Fedora core, Ubuntu, Gentoo上通过测试。
建立工具-Apache Ant 由Axis2二进制发行包运行示例和建立WAR文件。 1.6.5版 或更高 (下载)。
建立工具- Apache Maven 2.x

仅仅在由源码建立Axis2的时候需要。		 2.0.7 或者Maven2.X系列中更高版本(下载)。请下载Maven2.x，Axis2不再支持Maven 1.x的版本。

确认在Axis2安装前以上必备条件都准备好了。

  用标准二进制发行包将Axis2作为独立服务器安装

这个部分提供给您一下信息
  1. 用标准二进制发行包将Axis2作为独立服务器安装。
  2. 启动Axis2独立服务器
  3. 建立axis2.war文件（使用标准二进制发行包），它需要作为与J2EE兼容的servlet容器的一部分。
  4. 运行Axis2快捷脚本

 1. 下载安装Apache Axis2二进制发行包
下载并安装JDK（1.4或更高版本）。 根据该版本中的安装指导安装JDK。在环境变量中添加变量JAVA_HOME，将它设为你安装JDK的目录路径。下载解压Axis2标准二进制发行包到一个方便的位置，使该发行包在自己的目录下。 设置一个环境变量AXIS2_HOME，将它的值设为刚才解压的Axis2目录路径（例如：/opt/axis2-1.3）。Linux用户还可以运行AXIS2_HOME/bin目录下的setenv.sh文件来把AXIS2_HOME环境变量加入到Axis2的classpath。

 2. 启动Axis2独立服务器
独立的Axis2服务器可以通过执行以下命令来启动： $AXIS2_HOME\bin\axis2server.bat (Windows) $AXIS2_HOME/bin/axis2server.sh (Unix) 启动以后，Axis2缺省提供的web services可以通过http://localhost:8080/axis2/services/来访问。

 3. 用标准二进制发行包来建立Axis2 Web应用（axis2.war）
下载安装Apache Ant (1.6.5版或者更新). 根据Ant发行包里的指导来安装Apache Ant。 在webapp目录下找到Ant安装配置文件,这个目录在你的Axis2安装目录下（例如：$AXIS_HOME/webapp）。通过在$AXIS2_HOME/webapps目录下执行“ant create.war”来运行Ant安装。你可以在$AXIS2_HOME/dist目录下找到生成的文件axis2.war。所有在目录AXIS2_HOME/repository下的服务和模块将被打包在axis2.war中，还包括了在$AXIS2_HOME/conf/axis2.xml中Axis2配置。 阅读“在一个Servlet容器中安装Axis2”，了解如何在一个Servlet容器中部署Axis2 Web应用。

 4. 熟悉Axis2快捷脚本
建议在PATH变量中加入$AXIS2_HOME/bin，这样你就可以在任何地方运行以下脚本。

脚本名字 描述
axis2.{bat|sh} 你可以使用这个脚本来运行用Axis2编写的Web services客户端。这个脚本调用“java”命令，运行前会为你添加Axis2依赖库到classpath（在AXIS2_HOME/lib目录下的*.jar文件），设置Axis2存储库位置（AXIS2_HOME/repository）和Axis2配置文件位置（AXIS2_HOME/conf/axis2.xml）。这样你就不用再配置上面这些Axis2参数了。

使用 : axis2.{sh.bat} [-options] class [args...]
axis2server.{sh|bat} 这个脚本将启动一个独立的Axis2服务器，它使用AXIS2_HOME/repository作为Axis2存储库，以及把AXIS2_HOME/conf/axis2.xml 作为Axis2配置文件。它会启动在AXIS2_HOME/conf/axis2.xml 中的所有传输监听。

例如：如果你要用一个独立Axis2服务器部署一个服务，复制你的服务包到AXIS2_HOME/repository/services目录。然后，到AXIS2_HOME/conf/axis2.xml中的“Transport Ins”部分配置传输接收器（缺省列出在8080端口上的simpleHttpServer），最后调用这个脚本。
wsdl2java.{bat|sh} 这个脚本根据提供的WSDL文件来产生Java代码，以此来处理Web services调用（客户端stubs）。这个脚本也能根据WSDL产生web services主要框架。

使用: wsdl2java.{sh|bat} [OPTION]... -uri <WSDL>文件
例如, wsdl2java.sh -uri ../wsdl/Axis2Sample.wsdl
关于此脚本更详细的参考可以在这里找到。
java2wsdl.{bat|sh} 这个脚本根据提供的Java类来生成合适的WSDL文件。

使用: Java2WSDL.{sh|bat} [OPTION]... -cn <完整的类名>
例如, Java2WSDL.sh -cn ../samples/test/searchTool.Search
关于此脚本更详细的参考可以在这里找到。


  在Servlet容器中安装Axis2

无论使用哪个版本的Axis2，要把它安装在一个J2EE兼容的Servlet容器中请参照一下说明：
  1. 用Axis2标准二进制发行包建立Axis2 WAR文件。 (或者你可以下载axis2.war文件以及通过源码发行包建立axis2.war文件)。
  2. 将WAR文件放到servlet容器的webapps目录下。大多数的Servlet容器会自动安装WAR文件（某些Servlet容器可能需要重启来获得新的web应用。更多的信息请参照你的Servlet容器文档。）
  3. 一旦WAR被成功安装，你可以在浏览器中输入http://<host :port>/axis2来测试它。它应该会生成下面这个页面——Axis2 Web应用主页。
  4. 使用链接“Validate”来确认所有的东西都运行正常。如果验证失败那么说明WAR安装不正确或者某些核心jar文件丢失了。在这种情况下，请参考相关的的Servlet容器文档来找到问题所在。下面的页面显示的是一个成功的验证。注意指出Axis2核心库存在的语句。
注意: 需要任何应用服务器详细的安装信息请参考应用服务器详细配置指南。

  上传服务

Axis2 Web应用也提供了一个上传服务的接口。一旦根据高级用户指南中描述的服务说明建立了服务压缩包文件，那么这个以aar为后缀的文件就可以用上传页面来上传。



被上传的aar文件将被保存在缺省的服务目录。对于Axis2来说，这个目录是<webapps>/axis2/WEB-INF/services。一旦服务被上传，它会被立刻安装。
因为Axis2支持热部署，你可以将通过文件系统直接把服务压缩包放到上面提到的服务目录。这样服务就会被自动安装而不会使这个容器重启。
使用链接“Services”来检查服务安装是否成功。被成功安装的服务以及他提供的操作将会在有效的服务页面上显示。



如果服务有部署错误，那么它会将服务作为有错误的服务列举出来。如果你点击了那个链接，你可以看到部署错误信息。



部署错误信息



Axis2管理全部是关于在运行时配置Axis2，这个配置是瞬间完成的。更多的描述可以在Axis2 Web管理指南查到。


  高级
  Axis2源码发行包

使用源码发行包，你可以用Maven命令来建立二进制文件（可以作为标准二进制发行包下载）和axis2.war文件（可以作为WAR发行包下载）。
所需要的jar文件不包含在发行包了，他们也需要运行Maven命令来建立。在我们开始前，有必要安装Maven2和安装它的运行环境，参见下文。

 安装运行环境和工具
Maven
建立Axis2是基于Maven2的。因此用源码建立Axis2唯一的必备条件是安装了Maven。更多的指令指南可以在Maven网站上查找。本篇指南只包括了快速环境变量设置的最简单途径。想要知道更多Maven信息的高级用户可以访问这个网站

 使用源码发行包建立二进制和WAR文件
源码发行包是一个zip压缩包。所有必要的搭建脚本包含其中。一旦源码压缩包被解压到一个选择的目录，进入特定目录并运行mvn install命令，这样就可以建立Axis2 jar文件了。一旦命令完成，二进制（本例中是jar文件）文件可以在新建立的target目录中找到。

注意：第一次安装Maven（如果maven存储库没有先建立）会花费一些时间，因为需要的jar文件需要被下载。然而，这只是一次性的过程而且不会影响任何后续的搭建。

缺省的Maven搭建将在modules/webapp/target目录下产生war文件。


上一篇
目    录
下一篇