Web service 介绍与简单应用

超、凢脫俗 2022-05-29 05:09 178阅读 0赞

### 一、Web service 介绍 ###

**什么是 Web service**

到目前为止对 Web service 没有统一的定义，这里以一种更容易理解的方式解释。Web service 是一个平台独立的，低耦合的，自包含的、基于可编程的 web 的应用程序，即是一种跨编程语言和操作系统平台的远程调用技术。

Web service 技术， 能使得运行在不同机器上的不同应用无须借助附加的、专门的第三方软件或硬件， 就可相互通信。Web service 可以使你的网站使用其他网站的资源，比如在网页上显示天气、地图的最新动态等等。  
![Image 1][]

**本地服务的缺陷**

"网络服务"是软件开发和使用的趋势，本地服务将越来越少，主要有以下几个原因：

1.本地资源不足。很多数据和资料，本地得不到，只有向其他网站要。

2.成本因素。本地提供服务，往往是不经济的，使用专业网站的服务更便宜。这里面涉及硬件和人员两部分，即使你买得起硬件，专门找一个人管理系统，也是很麻烦的事。

3.可移植性差。如果你想把本机的服务，移植到其他机器上，往往很困难，尤其是在跨平台的情况下。

**Web service 的优势**

1.自包含。意思是客户端不需要包含任何附加的软件或硬件，只要客户端支持 Http 和 XML 就可以完成数据的交换或集成。

2.跨平台与跨语言。无论你使用哪种语言，只要遵循 Web service 的规范就可以互相调用。

3.通过网络进行发布，查找和使用，并且不需要考虑客户端兼容问题，一次性就能完成。

4.可以实现多数据与多种服务聚合。

**Web service 三个核心定义**  
![这里写图片描述][format_png]

WSDL（Web services Description Language）Web services 描述语言。一个 XML 格式文档，用以描述服务端口访问方式和使用协议的细节。通常用来辅助生成服务器和客户端代码及配置信息。

SOAP（Simple Object Access Protocol）简单对象访问协议。它是一种标准化的通讯规范，主要用于 Web 服务 (Web service) 中。这种规范基于两个我们熟知的协议：HTTP 和 XML。  
  
  
UDDI（Universal Description, Discovery, and Integration）一个用来发布和搜索 WEB 服务的协议，应用程序可借由此协议在设计或运行时找到目标 WEB 服务。这些标准由这些组织制订：W3C 负责 XML、SOAP 及 WSDL；OASIS 负责 UDDI。

### 二、使用 Java 原生 API 快速体验 Web service ###

Java 的原生 JDK 对 Web service 作了支持，下面我们通过服务端 (可以理解为其他服务器上的资源) 与客户端 (本地调用) 的实现来模拟中间的调用过程。

**服务端**

服务端项目目录结构 (最基本的 Java Project)：  
![这里写图片描述][format_png 1]  
服务端资源接口`WeatherService`：

/** * 添加@WebService 注解，表明这是一个 Web service 服务 **/
    @WebService
    public interface WeatherService { 
    
        /** * 根据城市名字获得对应的天气信息 * * @param cityName * @return */
         @WebMethod
        String getWeatherInfoByCityName(String cityName);
    }

服务端资源接口实现类`WeatherServiceImpl`：

@WebService(endpointInterface= "com.jas.websevice.server.WeatherService")
    public class WeatherServiceImpl implements WeatherService { 
        @Override
        public String getWeatherInfoByCityName(String cityName) { 
            if("北京".equals(cityName)){ 
                return "晴";
            } else if ("上海".equals(cityName)) { 
                return "小雨";
            }
            
            return "查询不到对应的天气信息";
        }
    }

服务端开启服务：

public class ServerTest { 
        public static void main(String[] args) { 
    		/** * 第一个参数是服务发布的地址 * 第二个参数是设置对应的服务类，注意是接口的实现类 * 配置完成后直接运行该程序即可 */
            Endpoint.publish("http://localhost:8080/weather", new WeatherServiceImpl());
        }
    }

当开启服务后我们可以使用 WSDL 来查看服务端的配置信息，只需要在浏览器输入`http://localhost:8080/weather?wsdl`即可访问，`http://localhost:8080/weather`是我们在上面设置的服务发布地址。  
![这里写图片描述][format_png 2]  
上面这个 XML 的格式文档中描述了服务端口访问方式和使用协议的细节，但是只依靠这个文档是不能完成服务调用的，上面我们也提到了可以根据这个文档来生成客户端的代码。在配置了 jdk 环境变量的情况下，我们可以使用`wsimport`命令把上面的文档信息生成 Java 代码。

**客户端**

首先先创建一个普通的 Java 工程，在命令模式下进到新建 Java 工程的`src`目录下，执行`wsimport -s . http://localhost:8080/weather?wsdl`，其中 `-s .` 表示把代码生成在当前的目录。生成代码的过程中，会把包名也连带一起生成。  
![这里写图片描述][format_png 3]

客户端生成的代码：  
![这里写图片描述][format_png 4]

根据客户端生成的代码我们就可以调用服务端的服务了 (服务端的程序在开启的情况下)。

public class ClientTest { 
        public static void main(String[] args) { 
    
            WeatherServiceImplService factory = new WeatherServiceImplService();
            // 为 WeatherService 生成代理对象 
            WeatherService weatherService = factory.getWeatherServiceImplPort();
            // 调用 WeatherService 代理对象的方法来获得对应的天气信息
            String weatherInfo = weatherService.getWeatherInfoByCityName("上海");
            
            System.out.println(weatherInfo);
        }
    }

控制台输出：  
![这里写图片描述][format_png 5]

### 三、总结 ###

到这里我们应该知道什么是 Web service 了，服务端与客户端可以是两个不同的工程，不管使用什么语言与什么平台 (PS：上面这个例子使用的都是 Java)，它们之间都可以通过 HTTP 协议进行通信。因此你可以用任何你喜欢的语言，在任何你喜欢的平台上写 Web service ，只要我们可以通过 Web service 标准对这些服务进行查询和访问即可。

参考资料：  
[http://www.cnblogs.com/Leo\_wl/archive/2010/05/20/1740205.html][http_www.cnblogs.com_Leo_wl_archive_2010_05_20_1740205.html]  
[http://www.ruanyifeng.com/blog/2009/08/what\_is\_web\_service.html][http_www.ruanyifeng.com_blog_2009_08_what_is_web_service.html]  
[http://blog.csdn.net/feinifi/article/details/77780151][http_blog.csdn.net_feinifi_article_details_77780151]

[Image 1]: 
[format_png]: /images/20220529/e49ebf5143c544d58318d44a8023f541.png
[format_png 1]: /images/20220529/b440ec9090924fc38d60a5a8cd68c5ce.png
[format_png 2]: /images/20220529/df93c630983a4a1fa5a8b14c3f0c4e4f.png
[format_png 3]: /images/20220529/c10192a50270476daf878f4cb5047199.png
[format_png 4]: /images/20220529/99889c6947264b41a813933fa65b6759.png
[format_png 5]: /images/20220529/6dd3f891f0874491a540f9ec767a0e01.png
[http_www.cnblogs.com_Leo_wl_archive_2010_05_20_1740205.html]: http://www.cnblogs.com/Leo_wl/archive/2010/05/20/1740205.html
[http_www.ruanyifeng.com_blog_2009_08_what_is_web_service.html]: http://www.ruanyifeng.com/blog/2009/08/what_is_web_service.html
[http_blog.csdn.net_feinifi_article_details_77780151]: http://blog.csdn.net/feinifi/article/details/77780151