webservice入门实例

### WebService 入门实例详解 #### 一、概述 本文档主要介绍如何将WebService整合到现有的项目中，尤其适用于那些当前还没有Web服务接口的项目。通过本教程，您将学习到如何创建一个简单的WebService，并将其成功部署。本文档详细记录了每一个步骤，并附有必要的代码截图。 #### 二、环境配置 为了确保Web服务能够正常运行，您需要准备以下环境： - **JDK**: 版本 1.6。 - **AXIS2**: 版本 1.6.0。 - **Tomcat**: 版本 6 或 7。 - **开发工具**: Eclipse。 #### 三、部署步骤 ##### 第一步：下载并解压 axis2.war 文件 1. 从官方或其他可靠源下载最新版本的 `axis2.war` 文件。 2. 解压缩该文件，您会看到两个主要的目录：`axis2-web` 和 `WEB-INF` 目录。 3. 将这些目录复制到您的项目目录中对应的路径下，确保它们能够被正确识别。 ##### 第二步：编写 WebService 类 编写 WebService 类时，建议使用简单的基本数据类型进行数据传递，避免复杂的对象传递，这样可以简化操作并且提高效率。下面是一个简单的示例类： ```java package com.jdarray.test; /** * WebService 测试类，包括带参数函数，无参函数，数组返回的例子。 * 尽量使用字符及字符数组。 * @since 2011-07-18 * @author douzq */ public class HelloService { // 全局数组，无特别含义，可以放在方法里面。局部数组。 String[] infoList = null; /** * 无参数方法，仅仅用于掌握基本使用 * @return 返回默认字符返回值 */ public String sayHello() { // 无参方法，常用于传递某些固定参数 return "hello world"; } /** * 参数方法 * @param woo 传递参数 * @return 返回传入参数与已有的字符组合返回值； */ public String sayWoo(String woo) { return "say woo-" + woo; } /** * 带参数返回数组例子 * @param flag 参数标识 * @return 返回所需数组 */ public String[] fetchInfo(String flag) { // 方法可以扩展为，判断参数是否匹配返回数组； // 返回的数组可以扩展为数据库查询结果返回。由于是字符数组传递，可以定义字符顺序。 // 例如： // infoList[0]="id||name||part||time"; // 用分隔符的方式将数据拼接传递。 infoList = new String[]{}; infoList[0] = "1"; infoList[1] = "2"; infoList[2] = "3"; return infoList; } } ``` 这个示例中的 `HelloService` 类包含了三个方法：`sayHello()` 无参方法，用于返回固定的字符串；`sayWoo(String woo)` 带有一个参数，用于返回参数与字符串组合；`fetchInfo(String flag)` 返回一个字符串数组。 ##### 第三步：配置服务文件 接下来，需要在 `WEB-INF` 目录下创建 `services` 目录，并在其中创建相应的子目录（根据业务需求自定义），再在这个子目录中创建 `META-INF` 目录。在 `META-INF` 目录下，创建 `server.xml` 文件，其内容如下： ```xml <?xml version="1.0" encoding="UTF-8"?> <serviceGroup> <service name="HelloService"> <description>HelloWorld Service</description> <parameter name="ServiceClass" locked="false"> com.jdarray.test.HelloService </parameter> <operation name="sayHello"> <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> </operation> <operation name="sayWoo"> <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> </operation> <operation name="fetchInfo"> <messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> </operation> </service> </serviceGroup> ``` 这里的 `service` 元素定义了服务的名称和服务类的全限定名，`operation` 元素则是对类中的方法进行声明。 #### 四、部署 部署Web服务有两种方式： 1. **手动部署**： - 将包含 WebService 的项目打包成 WAR 文件。 - 将 WAR 文件放置到 Tomcat 的 webapps 目录下。 - 启动 Tomcat 服务器，WAR 文件会被自动解压并部署。 2. **自动部署**： - 如果使用 Maven 或其他构建工具，则可以通过配置 pom.xml 文件来自动化部署过程。 - 在构建过程中，构建工具会自动将 WebService 打包并部署到指定的服务器上。 #### 五、总结 通过以上步骤，您可以将 WebService 成功地整合到现有项目中。这种方式不仅方便快捷，而且对于缺乏 Web 服务接口的项目来说，提供了一种有效的解决方案。希望本教程能帮助您更好地理解和应用 WebService 技术。