Apache Axis2 安装指南

Apache Axis2 安装指南

主要关注用“标准的二进制分发版”来运行Apache Axis2

 

安装为一个独立的服务器、安装为J2EE compliant Servlet容器的一部分。

 

使用标准的二进制分发版将Axis2安装为一个独立的服务器：

1．下载并解压Axis2 Standard Binary Distribution，设置环境变量AXIS2_HOME。

 

 

2．启动Axis2独立服务器：运行bin目录中的axis2server.bat。Axis2带的默认web services可以通过http://localhost:端口/axis2/services/来访问。

 

 

3．用标准二进制分发版构建Axis2 Web应用（axis2.war）：在AXIS2_HOME/webapps目录中执行ant create.war，这时可以在dist目录中看到生成的axis2.war文件。AXIS2_HOME/repository目录中所有的services和modules将被打包进axis2.war中，和AXIS2_HOME/conf/axis2.xml中的Axis2配置一起。

 

 

4．熟悉一下Axis2的几个方便的脚本：建议将%AXIS2_HOME%/bin加到PATH环境变量中去，这样从任何位置都可以执行。

1）axis2.{bat|sh}：用它来执行用Axis2编写的web service。

Usage : axis2.{sh.bat} [-options] class [args...]

2）axis2server.{sh|bat}：将启动一个独立的Axis2服务器，它会使用AXIS2_HOME/repository作为Axis2 repository以及将AXIS2_HOME/conf/axis2.xml作为Axis2 configuration file。

例如，如果想用一个独立的Axis2服务器运行一个service，这么做：复制你的service archive到AXIS2_HOME/repository/services目录中，然后到AXIS2_HOME/conf/axis2.xml文件中的Transport Ins部分并配置the transport receivers，（默认simpleHttpServer in port 8080 is listed）。然后调用该脚本。

 

在命令行中添加 –xdebug选项可以让服务器以调试模式启动。A remote debugger can be attached by connecting to port 8000。

3）wsdl2java.{bat|sh}：根据一个WSDL文件生成Java代码，来处理Web service调用（client-side stub）。它还可以根据一个WSDL来生成web service skeletons。

用法：wsdl2java.{sh|bat}[OPTION]… -uri <Location of WSDL>

比如，wsdl2java.sh –uri ../wsdl/Axis2Sample.wsdl

4）java2wsdl.{bat|sh}：为一个java类生成正确的WSDL文件。

用法：java2wsdl.{sh|bat} [OPTION]… -cn <full qualified class name>

比如，java2wsdl.sh –cn ../samples/test/searchTool.Search

 

在一个Servlet容器中安装Axis2:

不管哪个distribution，在一个J2EE compliant servlet容器中安装Axis2都是像下面这样：

1．  用Axis2 标准二进制分发版构建Axis2 WAR文件。（也可以下载axis2.war，或用源码分发版构建axis2.war）

2．  复制该WAR文件到servlet容器的webapps目录中。

3．  一旦WAR成功安装，通过http://localhost:端口/axis2来测试。

4．  用链接“Validate”来确保一切都运行正确。如果验证失败，则WAR安装失败或是一些基本的jars丢失了。

 

上传Services

Axis2 Web应用还提供了一个用来上传Services的接口。一旦一个service archive文件根据service规范被创建，这个.aar文件就可以用上传页面被上传。

 

完成上传的.aar文件保存在默认的service目录中。对于Axis2，是在<webapps>/axis2/WEB-INF/service目录中。一旦一个service上传完，它会立即被安装。

 

由于Axis2支持热部署，因此你也可以直接复制你的.aar文件到service目录中，这样同样会自动安装同时不需要重启容器。

 

用Web Application主页中的“Service”链接来检验service的成功安装。

 

如果service有一些部署时错误，将会列出这些services，作为错误的services。

 

Axis2 Administration是在运行时关于配置Axis2的，因此所有配置将是瞬时的。

 

高级

 

Axis2源码分发版

通过使用source distribution，binary files和axis2.war都可以用Maven命令构建出来。

需要的jar文件在distribution中是没有的，因此他们需要用maven命令来构建。

 

准备好环境和工具

Maven

Axis2的构建依赖Maven2。

用源码分发版构建Binaries和WAR File：

一旦源码分发版已经解压到一个地方，移动到特定的目录中，运行mvn install命令，将会构建Axis2 jar文件。

 

当命令运行结束后，the binaries（我们这里就是jar文件）可以在新创建的target目录中看到。

 

默认的maven build将在mdules/webapp/target目录中生成war。