webservice 学习资料

### WebService 学习资料详解 #### 一、概述 WebService 是一种跨编程语言和操作系统平台的远程调用技术，允许程序通过 HTTP 协议访问其他应用中的对象，且不考虑其使用的编程语言。本文档将详细介绍如何使用 MyEclipse 和 Tomcat 以及 Axis 发布 WebService 的过程。 #### 二、准备工作 1. **安装 Axis** - 访问官方网址 [http://ws.apache.org/axis/](http://ws.apache.org/axis/) 下载 Axis 包。 - 选择适合当前环境的版本，本文档使用的是 `axis-bin-1_4.tar.gz` 版本，并将其解压至 `E:\axis-bin-1_4\axis-1_4` 目录。 2. **开发环境配置** - 开发工具：MyEclipse 6.0 - Java 库版本：J2EE 1.4 - Web 服务器：Tomcat 6 #### 三、创建 Web 工程 1. **新建 Web 工程** - 在 MyEclipse 中新建一个名为 `testAxis` 的 Web 工程。 - 工程路径设置为 `D:\JavaProject\testAxis`。 - 配置完成后，将 `testAxis` 工程部署到 Tomcat。 2. **引入 Axis 包** - 将 `E:\axis-bin-1_4\axis-1_4\lib\` 下的所有 `.jar` 文件复制到 `testAxis` 工程的 `WebRoot\WEB-INF\lib` 目录下。 - MyEclipse 会自动将这些 `.jar` 文件添加到工程的引用库中。 3. **修改 web.xml** - 使用 Axis 解压包中的 `web.xml` 文件直接替换 `testAxis` 工程原有的 `web.xml` 文件。 - 替换文件路径：`E:\\axis-bin-1_4\axis-1_4\webapps\axis\WEB-INF\web.xml` 替换到 `testAxis` 工程的相应位置。 #### 四、创建 WebService 1. **定义接口** - 在 `testAxis` 工程中创建一个新的接口 `sayHelloToCkp.java`，并放置在 `com.ckp` 包中。 - 接口定义如下： ```java package com.ckp; public interface sayHelloToCkp { public String sayHello(); } ``` 2. **生成 WSDL 文件** - 使用 MyEclipse 执行 Axis 中的 `Java2WSDL` 方法来生成 WSDL 文件。 - 右键点击 `sayHelloToCkp.java` 类文件，选择 `Run As` -> `Open Run Dialog`。 - 新建一个配置，在 `Main` 选项卡中设置 `Main Class` 为 `org.apache.axis.wsdl.Java2WSDL`。 - 在 `Arguments` 选项卡中设置程序参数： ``` -o ckp.wsdl -l "http://localhost:8080/testAxis/services/ckp" -n "urn:ckp" -p "com.ckp""urn:ckp" com.ckp.sayHelloToCkp ``` - 运行后将在工程目录 `D:\JavaProject\testAxis` 下生成 `ckp.wsdl` 文件。 3. **使用 WSDL 生成服务类** - 同样使用 MyEclipse 执行 `WSDL2Java` 方法来生成服务类。 - 新建配置，设置 `Main Class` 为 `org.apache.axis.wsdl.WSDL2Java`。 - 设置参数： ``` -t -B -v -D -s -p com.ckp.server D:\JavaProject\testAixs\ckp.wsdl ``` - 运行后将在项目根目录下生成相关的服务类、`build.xml` 和 `deploy.wsdd`, `undeploy.wsdd` 等文件。 - 将这些文件复制到工程的 `src` 目录下，并确保包的位置正确。 4. **服务的部署和生成 server_config.wsdd** - 启动 Tomcat。 - 打开命令提示符，切换到 Web 服务器中 `deploy.wsdd` 所在的目录，例如 `c:\apache-tomcat-6.0.14\webapps\testAxis\WEB-INF\classes\com\ckp\server`。 - 执行以下命令来生成 `server-config.wsdd` 文件： ```shell java -Djava.ext.dirs=E:\axis-bin-1_4\axis-1_4\lib org.apache.axis.client.AdminClient -l http://localhost:8080/testAxis/services/ckp?wsdl deploy.wsdd ``` - 命令中的路径应根据实际情况进行调整。 - 成功执行后，可以在 `c:\apache-tomcat-6.0.14\webapps\testAxis\WEB-INF\` 目录下看到 `server-config.wsdd` 文件。 #### 五、总结 通过以上步骤，您已经成功使用 MyEclipse 和 Tomcat 以及 Axis 创建并部署了一个简单的 WebService。在整个过程中，了解了如何创建 Web 工程、定义接口、生成 WSDL 文件、使用 WSDL 生成服务类以及部署服务等内容。这为后续更复杂的应用场景提供了坚实的基础。