文档库 最新最全的文档下载
当前位置:文档库 › AXIS官方文档中文版

AXIS官方文档中文版

AXIS官方文档中文版
AXIS官方文档中文版

此文档根据官方说明整理

原文地址:https://www.wendangku.net/doc/a011903315.html,/axis2/java/core/docs/installationguide.html

一、准备工作:

1.Apache axis2

下载地址:https://www.wendangku.net/doc/a011903315.html,/axis2/java/core/download.cgi

可以看到四个文件的介绍,正下方有下载链接,每个版本包括四个文件,全部下载下来。

这里选择目前最新版本

2.Apache ant

下载地址:https://www.wendangku.net/doc/a011903315.html,/axis2/java/core/download.cgi

3.Apache maven

下载地址:https://www.wendangku.net/doc/a011903315.html,/download.html

4.JDK版本在1.5以上,环境变量要设置好,环境变量的设置请百度。

二、Apache Axis2安装向导

1. 解压下载好的Standard Binary Distribution文件到指定的目录。设置AXIS2_HOME环境变量到Standard Binary Distribution解压的位置。

例如:我将Standard Binary Distribution解压到了D:\work下

2.启动AXIS2独立服务器

在命令提示行,键入以下命令:%AXIS2_HOME%\bin\axis2server.bat。

启动以后,在浏览器地址栏中输入http://localhost:8080/axis2/services/,可以看到默认的webservices已经启动。

点击version可以看到默认web services的WSDL文件。

3.使用Standard Binary Distribution构建Axis2 web应用程序(axis2.war)

首先要保证Ant能够正常使用。Ant配置方法请去百度。这里不进行说明。

在命令提示行定位到%AXIS2_HOME%\webapp,使用ant命令:ant create.war 创建axis2.war。

看到BUILD SUCCESSFUL 证明构建成功。

这时可以在%AXIS2_HOME%\dist 文件夹下看到axis2.war。所有在%AXIS2_HOME%\repository 的services 和modules 以及%AXIS2_HOME%\conf\axis2.xml的文件都被打包到axis2.war中。

4.在servlet 容器中安装Axis2

War包生成以后将其赋值到容器(如:tomcat)的webapp文件加夹下,启动容器。如果容器已经开启,某些容器可能需要重启。这里使用tomcat6。在浏览器中输入下面的地址:http://localhost:8080/axis2/看到下面的页面,证明部署成功。

5.用Validate链接验证目前所作一切是否正确

注意:即使这页的所有检测点都正确,也不能保证你的Axis Service能正常工作。因为有许多配置没有被检测。这个测试是必要不充分条件。

如果验证失败,可能是war包没有正确安装或者是相关jar包丢失。这时可以参考所使用容器的文档去找到问题。

6.上传service

Axis2提供了一个上传服务的接口,一旦符合service 规范的service archive被创建。.aar 文档可以使用上传页上传。

进入http://localhost:8080/axis2/axis2-admin/指向的页面。第一次登录会使用用户名和密码,如果不知道也没有关系,可以在tomcat的webapps\axis2\WEB-INF\conf下的axis2.xml 中找到。

点击Upload Service,进入下面的页面。

上传的.aar文件默认存到webapps\axis2\WEB-INF\services文件夹中。一旦服务上传,马上就会安装。因为Axis2支持热部署,你可以通过文件系统将service archive 上传到上面提到的文件夹。无需容器重启,即可自动部署。使用Services下的link检查服务是否正确安装。成功安装的可用服务和服务的可用操作都会显示在可用服务页中。

如果服务发生部署时间错误,以错误的服务将会列出。点击链接可以看到错误信息。

错误信息

三、高级(不建议使用,构建失败)

1.使用Axis2 Source Distribution

Binary distribution和war distribution都可以用maven命令构建,在开始之前,保证maven 运行环境正常。

2.Maven安装

略。

3.使用Axis2 Source Distribution构建Binary distribution和war distribution

解压axis2-1.6.2-src.zip,在命令提示行,定位到axis2-1.6.2文件夹,运行mvn install。

第一次使用maven时需要等待一会,因为maven会将项目所依赖的jar包下载下来。至此一切都正常。

当构建项目时将发生异常,目测原因为Apache axis2源码包中有许多不同的modules,在开发时肯定是分开独立开发的,错误的主要原因是Junit的版本问题,可能是因为不同开发人员使用不通版本的junit 。这就给我们使用源码构建二进制文件和war文件造成麻烦。

图中4个版本的junit包都是在构建项目是自动下载的。证明了上面的猜想。在构建项目时为了保证maven能够正常运行,应当将高版本的junit包放到jdk的扩展包中。

路径: %JAVA_HOME%\jre\lib\ext

然后在命令提示行运行mvn clean install 命令。至此只是解决了部分问题。在构建过程中还可能出现内存溢出问题。

内存溢出问题的解决方法是:

修改mvn.bat。在这行

下加上set MAVEN_OPTS= -Xms128m -Xmx512m

至此还不能解决问题。使用mvn clean install命令时会出现test failed错误,根据错误提示信息找到错误产生的目录,找到对应modules的pom文件,将下面的代码“复制”进去。

目的是忽略test failed对构建项目造成的影响。在复制是要检查pom.xml文件跟上图内容是否有相同部分。如:pom.xml中已经存在maven-surefire-plugin了这是只需加入原文件中没有的部分即可,节点应该放在文件中节点上方。

再次运行mvn clean install,祈祷吧!!又溢出了,估计Apache组织开发用的机器配置相当之高。等待高人出现,我是没办法了。

相关文档