WebService 入门详解

忘是亡心i 2022-06-15 06:46 292阅读 0赞

# 1、什么是webservice #

**WebService是一种跨编程语言和跨操作系统平台的远程调用技术。**

所谓**跨编程语言和跨操作平台**，就是说服务端程序采用java编写，客户端程序则可以采用其他编程语言编写，反之亦然！跨操作系统平台则是指服务端程序和客户端程序可以在不同的操作系统上运行

所谓**远程调用**，就是一台计算机a上的一个程序可以调用到另外一台计算机b上的一个对象的方法，譬如，银联提供给商场的pos刷卡系统，商场的POS机转账调用的转账方法的代码其实是跑在银 行服务器上。再比如，amazon，天气预报系统，淘宝网，校内网，百度等把自己的系统服务以webservice服务的形式暴露出来，让第三方网站和程 序可以调用这些服务功能，这样扩展了自己系统的市场占有率，往大的概念上吹，就是所谓的SOA应用。

其实可以从多个角度来理解 WebService，从表面上看，WebService就是一个应用程序向外界暴露出一个能**通过Web进行调用的API**，也就是说能用编程的方法通过 Web来调用这个应用程序。我们把调用这个WebService的应用程序叫做客户端，而把提供这个WebService的应用程序叫做服务端。从深层次看，WebService是建立可互操作的分布式应用程序的新平台，是一个平台，是一套标准。它定义了应用程序如何在Web上实现互操作性，你可以用任何 你喜欢的语言，在任何你喜欢的平台上写Web service，只要我们可以通过Web service标准对这些服务进行查询和访问。

WebService平台需要一套协议来实现分布式应用程序的创建。任何平台都有它的数据表示方法和类型系统。要实现互操作性，WebService平台 必须提供一套标准的类型系统，用于沟通不同平台、编程语言和组件模型中的不同类型系统。Web service平台必须提供一种标准来描述 Web service，让客户可以得到足够的信息来调用这个Web service。最后，我们还必须有一种方法来对这个Web service进行远 程调用,这种方法实际是一种远程过程调用协议(RPC)。为了达到互操作性，这种RPC协议还必须与平台和编程语言无关。

## 2.简答实例 ##

### 1.编写服务端 ###

新建web项目TheService

创建类ServiceHello

@WebService
    public class ServiceHello { 
    
        /** * 供客户端调用的方法 * * @param name 名称 * @return 我的名字 */
        public String getValue(String name) {
            return "My name is " + name;
        }
    
        public static void main(String[] args) {
            Endpoint.publish("http://localhost:9999/TheService/serviceHello", new ServiceHello());
            System.out.println("Service success!");
        }
    
    }

*  a) @WebService － 它是一个注解，用在类上指定将此类发布成一个webservice服务.
 *  b) Endpoint – 此类为端点服务类，它的方法publish用于将一个已经添加了@WebService注解对象绑定到一个地址的端口上。Endpoint是jdk提供的一个专门用于发布服务的类，它的publish方法接收两个参数，一个是本地的服务地址，二是提供服务的类。它位于javax.xml.ws.\*包中。  
    static Endpoint.publish(String address, Object implementor) 在给定地址处针对指定的实现者对象创建并发布端点。stop方法用于停止服务。  
    其他注意事项：
 *  1) 给类添加上@WebService注解后，类中所有的**非静态方法**都将会对外公布。**不支持静态方法，final方法**。
 *  2) 如果希望某个方法(非static,非final)不对外公开，可以在方法上添加**@WebMethod(exclude=true)，阻止对外公开。**
 *  3) 如果一个类上，被添加了@WebService注解，则必须此类**至少有一个可以公开**的方法，否则将会启动失败。
 *  4) 服务类中**不能没有方法**
 *  5) @WebMethod(exclude=true)屏蔽方法

使用浏览器打开[http://localhost:9999/TheService/serviceHello][http_localhost_9999_TheService_serviceHello]  
出现下图则发布成功

![这里写图片描述][SouthEast]

### 2. 编写客户端 ###

新建web项目TheClient

使用wsimport命令依据wsdl文件生成相应的类文件

wsimport语法

wsimport -keep -d \[字节码文件目录\] -s \[源文件目录\] -p \[包名\] \[wsdl文档地址\]

命令参数说明：

*  \-d:生成客户端执行类的class文件的存放目录
 *  \-s:生成客户端执行类的源文件的存放目录
 *  \-p:定义生成类的包名

结果如图

![这里写图片描述][SouthEast 1]

编写测试方法：

public class ServiceTest {
        @Test
        public void test() throws Exception {
            ServiceHello serviceHello = new ServiceHelloService().getServiceHelloPort();
            String result = serviceHello.getValue("heqianiqan");
            System.out.println("result: "+result);
        }
    }

输出：

result: My name is heqianiqan

--------------------

[http_localhost_9999_TheService_serviceHello]: http://localhost:9999/TheService/serviceHello
[SouthEast]: /images/20220615/e3f1d129e2bb48bb8b02931d49eb265b.png
[SouthEast 1]: /images/20220615/17117e708df24fce96683c2516dc4752.png