axis2-WebService开发指南

Axis2 eclpise的环境搭建 Axis2的简单WebService示例 复杂对象类型的WebService 用axis2的辅助工具发布、调用WebService WebService会话Session的管理 跨多个WebService管理Session 用Spring创建的JavaBean发布成WebService 异步调用WebService 使用SoapMonitar监视WebService的请求和响应信息 ### Axis2 WebService 开发指南 #### 一、概述与环境搭建 Axis2是一个功能强大的开源Web服务框架，用于构建和服务于SOAP-based的Web服务。它支持多种协议，包括HTTP, HTTPS, JMS等，并且提供了对SOAP 1.1和1.2的支持。 ##### **1.1 开发准备** 为了开始使用Axis2进行Web服务的开发，需要完成以下准备工作： - **下载Axis2相关jar包**：访问Axis2的官方网站下载最新版本的Axis2依赖包，目前最高版本为1.5.4。 - **下载地址**：[http://axis.apache.org/axis2/java/core/download.cgi](http://axis.apache.org/axis2/java/core/download.cgi) - **下载官方提供的Eclipse插件工具**：这些工具能够帮助开发者轻松地打包项目为aar文件以及生成客户端调用代码。 - **下载页面**：[http://axis.apache.org/axis2/java/core/tools/index.html](http://axis.apache.org/axis2/java/core/tools/index.html) - **具体插件**： - ServiceArchiveWizard-EclipsePlug-in - CodeGeneratorWizard-EclipsePlug-in - **安装Eclipse插件**：安装成功后，在Eclipse中将看到相关的工具选项。 - **分析axis2-bin文件目录结构**： - **bin**：包含常用的命令行工具，如`wsdl2java`用于根据WSDL文件生成客户端调用代码。 - **conf**：存放配置文件，如`axis2.xml`。 - **lib**：放置运行所需的依赖库。 - **repository**：存储部署的服务和文件。 - **sample**：示例项目。 - **webapp**：Web应用程序文件和JSP页面等。 - **部署Axis2项目**：将下载的`axis2.war`文件放置到Tomcat的webapps目录下，启动Tomcat后，war文件将自动解压并运行。 #### 二、Axis2简单WebService示例 ##### **2.1 编写简单的WebService服务器端代码** 创建一个简单的WebService，如`HelloWorldService`。需要注意的是，此示例中的`HelloWorldService`没有指定包名。将编译后的`.class`文件手动复制到Tomcat目录下的`webapps/axis2/WEB-INF/pojo`目录中（如果不存在则需手动创建）。之后通过浏览器访问`http://localhost:8080/axis2/`或`http://localhost:8080/axis2/services/listServices`来查看已发布的`HelloWorldService`。 **部署机制说明**：在`[tomcat_home]/webapps/axis2/WEB-INF/conf/axis2.xml`中存在以下配置： ``` <deployer extension=".class" directory="pojo" class="org.apache.axis2.deployment.POJODeployer"/> ``` 这表示以`.class`为后缀的文件将会被部署在`pojo`目录下，并由`POJODeployer`处理。 ##### **2.2 测试WebService方法** 测试已发布的`HelloWorldService`，可以通过URL访问其提供的方法。例如，要调用`sayHello`方法并传入参数`name`： ``` http://localhost:8080/axis2/services/HelloWorldService/sayHello?name=jack ``` URL的组成部分： - `http://localhost:8080/axis2/services/HelloWorldService`：WebService的地址 - `/sayHello`：方法名称 - `?name=jack`：参数名称及值 浏览器中显示的结果将展示返回值及方法名称。方法名称后通常会加上`Response`后缀，例如`ns:sayHelloResponse`。 #### 三、复杂对象类型的WebService 对于更复杂的业务场景，可能需要处理复杂的对象类型。这涉及到序列化和反序列化的实现，Axis2提供了丰富的API和配置选项以支持这种需求。 #### 四、用Axis2的辅助工具发布、调用WebService Axis2提供了多种辅助工具来简化发布和调用WebService的过程，如`ServiceArchiveWizard-EclipsePlug-in`用于打包项目，`CodeGeneratorWizard-EclipsePlug-in`用于生成客户端调用代码。 #### 五、WebService会话Session的管理 对于需要会话管理和状态保持的应用程序，Axis2提供了内置的支持。这包括在单个WebService和跨多个WebService之间的会话管理。 #### 六、使用Spring创建的JavaBean发布成WebService Axis2支持与其他框架（如Spring）的集成，允许使用Spring创建的JavaBean发布为WebService。 #### 七、异步调用WebService Axis2还支持异步调用WebService的功能，这对于提高系统性能和响应性非常有用。 #### 八、使用SoapMonitor监视WebService的请求和响应信息 为了监控WebService的运行情况，可以使用SoapMonitor工具来跟踪和记录请求和响应的信息，这对于调试和性能优化非常重要。 Axis2提供了一个强大而灵活的平台，不仅支持简单的WebService开发，还支持复杂对象类型、会话管理、异步调用等多种高级特性。通过合理利用这些特性，可以有效地提高Web服务的质量和性能。