Java WebService

一只懒惰的小虫子

已于 2022-10-24 11:08:10 修改

阅读量3.3k

点赞数

分类专栏： webservice 文章标签： java 1024程序员节

于 2022-10-24 11:01:57 首次发布

本文链接：https://blog.csdn.net/Strange_boy/article/details/127487419

版权

webservice 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

1、WebService简介

Web Service技术，能使得运行在不同机器上的不同应用无须借助附加的、专门的第三方软件或硬件，就可相互交换数据或集成。依据Web Service规范实施的应用之间，无论它们所使用的语言、平台或内部协议是什么，都可以相互交换数据。

简单的说，WebService就是一种跨编程语言和跨操作系统平台的远程调用技术。所谓跨编程语言和跨操作平台，就是说服务端程序采用java编写，客户端程序则可以采用其他编程语言编写，反之亦然。跨操作系统平台则是指服务端程序和客户端程序可以在不同的操作系统上运行。远程调用，就是一台计算机的应用可以调用其他计算机上的应用。例如：支付宝，支付宝并没有银行卡等数据，它只是去调用银行提供的接口来获得数据。还有天气预报等，也是气象局把自己的系统服务以webservice服务的形式暴露出来，让第三方网站和程序可以调用这些服务功能。

2、WebService原理

XML,SOAP和WSDL就是构成WebService平台的三大技术。

WebService采用Http协议来在客户端和服务端之间传输数据。WebService使用XML来封装数据，XML主要的优点在于它是跨平台的。
WebService通过HTTP协议发送请求和接收结果时，发送的请求内容和结果内容都采用XML格式封装，并增加了一些特定的HTTP消息头，以说明HTTP消息的内容格式，这些特定的HTTP消息头和XML内容格式就是SOAP协议规定的。
WebService服务器端首先要通过一个WSDL文件来说明自己有什么服务可以对外调用。简单的说，WSDL就像是一个说明书，用于描述WebService及其方法、参数和返回值。 WSDL文件保存在Web服务器上，通过一个url地址就可以访问到它。客户端要调用一个WebService服务之前，要知道该服务的WSDL文件的地址。WebService服务提供商可以通过两种方式来暴露它的WSDL文件地址：1.注册到UDDI服务器，以便被人查找；2.直接告诉给客户端调用者。

WebService交互的过程就是,WebService遵循SOAP协议通过XML封装数据，然后由Http协议来传输数据。

3、JAVA WebService规范

Java 中共有三种WebService 规范，分别是JAXM&SAAJ、JAX-WS（JAX-RPC）、JAX-RS。

JAX-WS

JAX-WS（Java API For XML-WebService）。早期的基于SOAP 的JAVA 的Web 服务规范JAX-RPC（java API For XML-Remote Procedure Call）目前已经被JAX-WS 规范取代，JAX-WS 是JAX-RPC 的演进版本，但JAX-WS 并不完全向后兼容JAX-RPC，二者最大的区别就是RPC/encoded 样式的WSDL，JAX-WS 已经不提供这种支持。JAX-RPC 的API 从JAVA EE5 开始已经移除，如果你使用J2EE1.4，其API 位于javax.xml.rpc.包。JAX-WS（JSR 224）规范的API 位于javax.xml.ws.包，其中大部分都是注解，提供API 操作Web 服务（通常在客户端使用的较多，由于客户端可以借助SDK 生成，因此这个包中的API 我们较少会直接使用）。

JAXM&SAAJ

JAXM（JAVA API For XML Message）主要定义了包含了发送和接收消息所需的API，相当于Web 服务的服务器端，其API 位于javax.messaging.*包，它是Java EE 的可选包，因此你需要单独下载。

SAAJ（SOAP With Attachment API For Java，JSR 67）是与JAXM 搭配使用的API，为构建SOAP 包和解析SOAP 包提供了重要的支持，支持附件传输，它在服务器端、客户端都需要使用。这里还要提到的是SAAJ 规范，其API 位于javax.xml.soap.*包。

JAXM&SAAJ 与JAX-WS 都是基于SOAP 的Web 服务，相比之下JAXM&SAAJ 暴漏了SOAP更多的底层细节，编码比较麻烦，而JAX-WS 更加抽象，隐藏了更多的细节，更加面向对象，实现起来你基本上不需要关心SOAP 的任何细节。那么如果你想控制SOAP 消息的更多细节，可以使用JAXM&SAAJ。

JAX-RS

JAX-RS 是JAVA 针对REST(Representation State Transfer)风格制定的一套Web 服务规范，由于推出的较晚，该规范（JSR 311，目前JAX-RS 的版本为1.0）并未随JDK1.6 一起发行。

4、WebService入门案例

服务端的实现

我们来实现一个天气系统的案例，客户端发送城市名称，服务器端回应相应的天气。

(1)、编写SEI(Service Endpoint Interface)

package com.taoke;

/**
 * 1、编写SEI(Service Endpoint Interface)，SEI在webservice中称为portType，在java中就是普通接口
 *
 * @author taoke
 * @date 2022/10/24
 */
public interface WeatherInterface {
    String queryWeather(String cityName);
}

(2)、编写SEI实现类

package com.taoke;

import javax.jws.WebService;

/**
 * 2.  编写SEI实现类，此类作为webservice提供服务类
 *
 * @author taoke
 * @date 2022/10/24
 */
@WebService
public class WeatherInterfaceImpl implements WeatherInterface {

  @Override
    public String queryWeather(String cityName) {
        return cityName + " world!";
    }
}

(3)、发布服务

package com.taoke;

import javax.xml.ws.Endpoint;

/**
 * 3。 第三步：发布服务，Endpoint类发布服务，publish方法，两个参数：1.服务地址；2.服务实现类
 *
 * @author taoke
 * @date 2022/10/24
 */
public class WeatherServer {
    public static void main(String[] args) {
        Endpoint.publish("http://127.0.0.1:12345/weather", new WeatherInterfaceImpl());
    }
}

(4)、测试服务是否发布成功

通过阅读wsdl，确定客户端调用的接口、方法、参数和返回值存在，证明服务发布成功，我们在浏览器输入 http://127.0.0.1:12345/weather?wsdl 来获取wsdl文件进行阅读wsdl,是以XML文件形式来描述WebService的”说明书”,有了说明书,我们才可以知道如何使用或是调用这个服务.现在我们还不知道怎么去阅读，后面我们会详解，只要能获取到，就能确定WebService服务发布成功。

客户端的实现

客户端调用服务有很多种方法，我们先用工具生成客户端代码，后面会详解 wsimport是jdk自带的webservice客户端工具,可以根据wsdl文档生成客户端调用代码(java代码).当然,无论服务器端的WebService是用什么语言写的,都可以生成调用webservice的客户端代码。

(1)、创建一个客户端空项目

cmd命令行进入此项目的src目录使用以下命令生成客户端代码， -s是指编译出源代码文件,后面的.(点)指將代码放到当前目录下，最后面的http….是指获取wsdl说明书的地址。

wsimport -s . http://127.0.0.1:12345/weather?wsdl

(2)、编写客户端

package com.taoke.client;

/**
 * 客户端
 *
 * @author taoke
 * @date 2022/10/24
 */
public class WeatherClient {
    public static void main(String[] args) {
        //创建服务视图，视图是从wsdl文件的service标签的name属性获取
        WeatherInterfaceImplService weatherInterfaceImplService = new WeatherInterfaceImplService();

        //获取服务实现类，实现类从wsdl文件的portType的name属性获取
        WeatherInterfaceImpl weatherInterfaceImpl = weatherInterfaceImplService.getPort(WeatherInterfaceImpl.class);
        //获取查询方法，从portType的operation标签获取
        String weather = weatherInterfaceImpl.queryWeather("hello");
        System.out.println(weather);
    }
}

(3)、运行结果