webservice

### WebService概述与基本用法 #### 一、WebService简介 WebService是一种标准的跨平台通信方式，它允许在不同技术栈之间进行数据交换和服务交互。通过WebService，可以在不同的应用程序之间共享业务逻辑、数据和功能，这有助于提高软件的可重用性和互操作性。 #### 二、WebService的基本组成部分 WebService主要包括以下几个部分： 1. **服务提供者**：提供WebService的一方，通常是指实现了某些业务逻辑的服务端应用。 2. **服务消费者**：调用WebService的一方，可以是任何类型的客户端应用。 3. **服务描述语言(WSDL)**：一种XML格式的文件，用于描述服务接口、消息格式以及如何与服务交互等信息。 4. **服务注册中心**：如UDDI（Universal Description, Discovery and Integration），用于注册和发现服务的信息。 #### 三、调用外部网站上的Web服务 要调用一个外部网站提供的Web服务，首先需要获取该服务的WSDL文档，该文档包含了服务的所有必要信息。接着，可以使用Java SE平台自带的`wsimport`工具来生成调用服务所需的客户端代码。 ##### 使用`wsimport`命令： - **命令格式**： ```sh wsimport [选项] <WSDL_URL> ``` - **选项说明**： - `-s`：指定生成的客户端代码目录。 - `-p`：指定生成的包名路径。 - `-d`：仅生成`.class`文件。 #### 四、示例：创建并发布WebService 下面是一个简单的WebService示例，该示例展示如何创建一个名为`HelloService`的服务，并将其发布到特定的URL上。 ```java package com.itcast.ws; import javax.jws.WebService; import javax.xml.ws.Endpoint; /** * HelloService 类实现了一个简单的 WebService。 */ @WebService // 标注此类为 WebService public class HelloService { /** * sayHello 方法用于响应客户端的请求。 * * @param name 客户端传递的名字 * @return 返回问候语 */ public String sayHello(String name) { System.out.println("Hello: " + name); return "Hello: " + name; } public static void main(String[] args) { // 创建并发布服务 Endpoint.publish("http://localhost:9090/hello", new HelloService()); System.out.println("服务已启动: newHelloService"); } } ``` 在此示例中，`@WebService`注解标记了`HelloService`类，表示这是一个WebService。`sayHello`方法用于处理客户端的请求，并返回响应信息。`Endpoint.publish`方法用于发布服务到指定的URL上。 #### 五、客户端调用 一旦服务发布成功，客户端可以通过生成的客户端代码来调用服务。 ##### 示例代码： ```java package com.itcast.test; import org.junit.Test; import com.itcast.ws.HelloService; import com.itcast.ws.HelloServiceService; public class Test1 { @Test public void testService() { HelloServiceService helloServiceService = new HelloServiceService(); HelloService service = helloServiceService.getHelloServicePort(); String name = service.sayHello("李四"); System.out.println("成功获取数据包: " + name); } } ``` 在此示例中，`HelloServiceService`是根据WSDL文件自动生成的客户端代理类，用于调用服务端的`sayHello`方法。 #### 六、配置与注意事项 1. **服务类注解**：服务类必须使用`@WebService`注解标记，表明其为一个Web服务。 2. **方法可见性**：为了使服务可用，所有暴露给外部的方法必须是公共的(public)，私有(private)或其他非公开访问级别将导致异常。 3. **部署环境**：在低版本的JDK中可能遇到兼容性问题，建议升级至最新版本的JDK，例如JDK 1.7及以上。 4. **开发工具设置**：如果使用IDE（如MyEclipse）进行开发，需确保项目配置正确，避免出现编译或运行时的错误。 WebService是一种强大的跨平台通信手段，适用于多种应用场景。了解其基本原理和技术细节对于构建高效的分布式系统至关重要。