Apache Axis2 安装指南

mingche

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。