jax-ws-webservice开发

### JAX-WS WebService开发详解 #### 一、开发环境 为了进行JAX-WS WebService的开发，本文档采用以下开发环境配置： - **操作系统**：Windows XP - **IDE**：MyEclipse 10 - **Web服务器**：Tomcat 7 - **Java版本**：JDK 1.6 这些工具和环境为开发提供了坚实的基础，尤其对于初学者来说非常友好。 #### 二、开发WebService服务步骤 ##### 1. 利用MyEclipse创建Web工程 在MyEclipse中创建一个新的Web项目。创建过程大致如下： - 打开MyEclipse，选择“File” > “New” > “Dynamic Web Project”。 - 输入项目名称（例如：“YogfinwoWebservice”）。 - 选择目标运行时环境为Tomcat 7，并设置Java EE版本为Java EE 6。 - 完成向导，创建项目。 完成以上步骤后，可以在项目视图中看到如下结构： - `src/main/java` - Java源码存放目录。 - `src/main/webapp` - Web资源存放目录。 ##### 2. 在Web工程中建立WebService服务 接下来是在项目中创建一个WebService服务： - **创建服务类**：首先需要创建一个包含WebService方法的Java类。在这个例子中，我们创建了一个名为`YogfinwoWebserviceWS`的服务类，代码如下所示： ```java package com.yogfinwo.ws; import javax.jws.WebMethod; import javax.jws.WebService; @WebService public class YogfinwoWebserviceWS { @WebMethod public String getMessageInfos(String message) { return message; } } ``` 这个类通过使用`@WebService`注解来定义为一个WebService服务，并且其中的方法通过`@WebMethod`注解标记为可以远程调用的方法。 - **生成Web服务相关文件**：在创建了服务类之后，还需要利用MyEclipse自动生成WebService的相关配置文件和服务端点的实现代码。这可以通过右键点击服务类，然后选择“Web Services” > “Create/Update Web Service…”来完成。 完成以上步骤后，项目结构应该如下所示： - `src/main/java/com/yogfinwo/ws/YogfinwoWebserviceWS.java` - 包含WebService的Java类。 - `src/main/resources/META-INF/wsdl/YogfinwoWebserviceWS.wsdl` - WSDL文件定义了服务接口。 - `src/main/java/com/yogfinwo/ws/YogfinwoWebserviceWSImpl.java` - 服务实现类。 ##### 3. 添加必要的JAR包 为了能够在Web容器中正常启动WebService服务，还需要添加JAX-WS相关的JAR包。在MyEclipse中可以通过以下步骤添加： - 右键点击项目，选择“Build Path” > “Configure Build Path…”。 - 在弹出的对话框中，选择“Libraries”选项卡。 - 点击“Add External JARs…”，然后找到JAX-WS的JAR包（例如：`jaxws-api-2.2.jar`），并添加到项目依赖中。 完成以上步骤后，整个WebService服务的代码部分就基本完成了。 ##### 4. 发布WebService服务 最后一步是将WebService服务部署到Web服务器上，并进行测试。 - **部署服务**：通过MyEclipse将项目部署到Tomcat服务器上。 - **启动服务器**：启动Tomcat服务器。 - **测试服务**：通过浏览器访问服务的WSDL文件，验证服务是否正确部署。访问地址如下： ``` http://localhost:8080/YogfinwoWebservice/YogfinwoWebserviceWSPort?wsdl ``` 如果一切正常，将会看到一个XML格式的WSDL文件，证明服务已经被成功发布。 #### 三、创建WebService客户端步骤 ##### 1. 确保WebService服务启动着 在创建客户端之前，必须确保WebService服务已经被正确启动。 ##### 2. 开始创建 创建客户端的过程大致如下： - **生成客户端代码**：在MyEclipse中，选择“Web Services” > “Generate Client Stub…”。 - **输入WSDL URL**：输入上面获取到的WSDL文件URL。 - **生成代码**：MyEclipse会根据WSDL文件生成客户端所需的代码。 完成以上步骤后，就可以使用生成的客户端代码来调用WebService服务了。 通过以上详细的步骤，我们可以看到如何使用MyEclipse来进行JAX-WS WebService的开发和部署。这种开发方式不仅简单易懂，而且能够快速构建出功能完备的WebService应用。