Apache Axis2 安装指南

Apache Axis2 安装指南

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

 

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

 

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

1.下载并解压Axis2 Standard Binary Distribution,设置环境变量AXIS2_HOME

 

 

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

 

 

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

 

 

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

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

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

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

例如,如果想用一个独立的Axis2服务器运行一个service,这么做:复制你的service archiveAXIS2_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

3wsdl2java.{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

4java2wsdl.{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 distributionbinary filesaxis2.war都可以用Maven命令构建出来。

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

 

准备好环境和工具

Maven

Axis2的构建依赖Maven2

用源码分发版构建BinariesWAR File

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

 

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

 

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

猜你喜欢

转载自zsjg13.iteye.com/blog/1720447
今日推荐