webService入门到精通

一、WebService概述

参考：https://blog.csdn.net/hgx_suiyuesusu/article/details/88918192

1.1 WebService是什么

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

• Web service是一个平台独立的，低耦合的，自包含的、基于可编程的web的应用程序，可使用开放的XML（标准通用标记语言下的一个子集）标准来描述、发布、发现、协调和配置这些应用程序，用于开发分布式的互操作的应用程序。
• Web Service技术， 能使得运行在不同机器上的不同应用无须借助附加的、专门的第三方软件或硬件， 就可相互交换数据或集成。依据Web Service规范实施的应用之间， 无论它们所使用的语言、 平台或内部协议是什么， 都可以相互交换数据。Web Service是自描述、 自包含的可用网络模块， 可以执行具体的业务功能。Web Service也很容易部署， 因为它们基于一些常规的产业标准以及已有的一些技术，诸如标准通用标记语言下的子集XML、HTTP。Web Service减少了应用接口的花费。Web Service为整个企业甚至多个组织之间的业务流程的集成提供了一个通用机制。

1.2 WebService能做什么

• 不同系统、不同平台、不同语言之间的通信访问和远程调用
• 应用程序的集成，不同业务的整合

1.3 WebService官方定义

• Web服务是一种服务导向架构的技术，通过标准的Web协议提供服务，目的是保证不同平台的应用服务可以互操作。
• 表面上看WebService就是一个应用程序，它向外界暴露出一个能够通过Web进行调用的方法API，能用编程的方法通过Web调用来实现某个功能的应用程序。
• 深层次上看WebService是一种新的Web应用程序分支，它们是自包含、自描述模块化的应用，可以在网络中被描述、发布、查找以及通过Web来调

用。

1.4 WebService的两种类型

• 一种是以SOAP协议风格的Webservice
• 一种是Restful风格的Webservice

1.5 WebService结构(SOAP风格)

1.6 WebService核心组件

• XML和HTTP
• SOAP： 简单对象访问协议
• WSDL： WebService描述语言
• UDDI：统一描述、发现和集成协议

SOAP

Web service建好以后，你或者其他人就会去调用它。简单对象访问协议(SOAP)提供了标准的RPC方法来调用Web
service。实际上，SOAP在这里有点用词不当：它意味着下面的Web
service是以对象的方式表示的，但事实并不一定如此：你完全可以把你的Web
service写成一系列的C函数，并仍然使用SOAP进行调用。SOAP规范定义了SOAP消息的格式，以及怎样通过HTTP协议来使用SOAP。SOAP也是基于XML（标准通用标记语言下的一个子集）和XSD的，XML是SOAP的数据编码方式。

WSDL

你会怎样向别人介绍你的Web
service有什么功能，以及每个函数调用时的参数呢？你可能会自己写一套文档，你甚至可能会口头上告诉需要使用你的Web
service的人。这些非正式的方法至少都有一个严重的问题：当程序员坐到电脑前，想要使用你的Web
service的时候，他们的工具(如Visual Studio)无法给他们提供任何帮助，因为这些工具根本就不了解你的Web service。
解决方法是：用机器能阅读的方式提供一个正式的描述文档。Web service描述语言(WSDL)就是这样一个基于XML（标准通用标记语言下的一个子集）的语言，用于描述Web service及其函数、参数和返回值。WSDL既是机器可阅读的，又是人可阅读的，这将是一个很大的好处。一些最新的开发工具既能根据你的Web service生成WSDL文档，又能导入WSDL文档，生成调用相应Web service的代码。

UDDI

Universal Description, Discovery and Integration
为加速Web Service的推广、加强Web
Service的互操作能力而推出的一个计划,基于标准的服务描述和发现的规范(specification)。
以资源共享的方式由多个运作者一起以Web Service的形式运作UDDI商业注册中心。
UDDI计划的核心组件是UDDI商业注册，它使用XML文档来描述企业及其提供的Web Service。
UDDI商业注册提供三种信息：
White Page包含地址、联系方法、已知的企业标识。
Yellow Page包含基于标准分类法的行业类别。
Green Page包含关于该企业所提供的Web
Service的技术信息，其形式可能是指向文件或URL的指针，而这些文件或URL是为服务发现机制服务的。

二、WebService主流框架

2.1 AXIS

• AXIS（Apache eXtensible Interaction System）阿帕奇可扩展交互系统
• AXIS是一款开源的WebService运行引擎，本质上就是一个SOAP引擎，提供创建服务器端、客户端和网关SOAP操作的基本框架。
• AXIS分为1.x系列和2系列，两个系列体系结构和使用上有较大的区别，相对而言，Axis1.x更加稳定，文档也比较齐全。
  官网：http://axis.apache.org/

2.2 XFire

• XFire 是下一代的java SOAP 框架。XFire 提供了非常方便的API，使用这些API 可以
• 开发面向服务(SOA)的程序。它支持各种标准，性能优良（基于低内存的STAX 模型）。
• 官网：http://xfire.codehaus.org/

2.3 CXF

• Apache CXF = Celtix + XFire
• Apache CXF 的前身叫 Apache CeltiXfire，现在已经正式更名为 Apache CXF 了，以下简称为 CXF。CXF 继承了 Celtix 和 XFire 两大开源项目的精华，提供了对 JAX-WS 全面的支持，并且提供了多种 Binding 、DataBinding、Transport 以及各种 Format 的支持，并且可以根据实际项目的需要，采用代码优先（Code First）或者 WSDL 优先（WSDL First）来轻松地实现 Web Services 的发布和使用。Apache CXF已经是一个正式的Apache顶级项目。
• 官网：http://cxf.apache.org/

三 CXF 案例

3.1 Demo

• 3.1.1 Demo概要
• 建工程添Jar包
• 建Demo服务接口(@WebService注解添加)
• 建Demo服务实现类
• 建MainServer服务启动类(JaxWsServerFactoryBean)
• 测试访问有两方法：
  • 1)通过图形化工具直接测试调用
  • 2)建ClientTest调用对外暴露的服务，编码测试(JaxWsProxyFactoryBean)
• （包及工具）下载地址：http://cxf.apache.org/download.html

3.1.2 demo详细（maven项目）

• 项目结构
  
• 用maven创建一个web项目，maven依赖：pom.xml

<dependencies>
    <!-- https://mvnrepository.com/artifact/org.apache.cxf/cxf-rt-frontend-jaxws-->
    <dependency>
      <groupId>org.apache.cxf</groupId>
      <artifactId>cxf-rt-frontend-jaxws</artifactId>
      <version>3.2.7</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/org.apache.cxf/cxf-rt-transports-http-jetty-->
    <dependency>
      <groupId>org.apache.cxf</groupId>
      <artifactId>cxf-rt-transports-http-jetty</artifactId>
      <version>3.2.7</version>
    </dependency> 
</dependencies>
1
2
3
4
5
6
7
8
9
10
11
12
13
14

• demo服务接口（@WebService注解）

import javax.jws.WebService;

@WebService
public interface Demo {
    String sayHello(String name, int age);
}

1
2
3
4
5
6
7

• 建DemoService服务实现类

public class DemoService implements Demo {
    @Override
    public String sayHello(String name, int age) {
        return "Hello!!!" + name + "(" + age + " years old)";
    }
}
1
2
3
4
5
6

• 建MainServer服务启动类

import org.apache.cxf.endpoint.Server;
import org.apache.cxf.jaxws.JaxWsServerFactoryBean;

public class MainService {
    public static void main(String[] args) {
        JaxWsServerFactoryBean jaxWsServerFactoryBean = new JaxWsServerFactoryBean();
        jaxWsServerFactoryBean.setAddress("http://localhost:8080/demo");
        jaxWsServerFactoryBean.setServiceClass(DemoService.class);
        Server server = jaxWsServerFactoryBean.create();
        server.start();
        System.out.println("demo服务启动 。。。。");
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13

• 客户端MainClient

import com.hgx.web.service.demo.Demo;
import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;

public class MainClient {
    public static void main(String[] args) {
        JaxWsProxyFactoryBean jaxWsProxyFactoryBean = new JaxWsProxyFactoryBean();
        jaxWsProxyFactoryBean.setAddress("http://localhost:8080/demo");
        jaxWsProxyFactoryBean.setServiceClass(Demo.class);
        Demo demo = (Demo) jaxWsProxyFactoryBean.create();
        System.out.println(demo.sayHello("hgx", 24));
    }
}
1
2
3
4
5
6
7
8
9
10
11
12

四 Soap协议+TCP/IPMoniter监控

4.1 SOAP协议是什么？

• 简单对象访问协议（Simple Object AccessProtocol，SOAP）是一种轻量的、简单的、基于XML的协议，它被设计成在WEB上交换结构化的和固化的信息。
• SOAP 是基于 XML 的简易协议，可使应用程序在 HTTP 之上进行信息交换。

4.2 SOAP协议什么样？

一条 SOAP 消息就是一个普通的 XML 文档，包含下列元素：

• Envelope 元素，必有，可把此 XML 文档标识为一条 SOAP 消息
• Header 元素，可选，包含头部信息
• Body 元素，必有，包含所有的调用和响应信息
• Fault元素，可选，提供有关在处理此消息所发生错误的信息

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
	<soap:Body>
		<soap:Fault>
			<faultcode>soap:Server</faultcode>
			<faultstring>
				No binding operation info while invoking unknown method with params unknown.
			</faultstring>
		</soap:Fault>
	</soap:Body>
</soap:Envelope>
1
2
3
4
5
6
7
8
9
10

4.3 SOAP消息的调试抓取

• request

<soapenv:Envelope 
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:q0="http://test.cxf.hgx.com/" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soapenv:Body> 
     <q0:sayhello>
         <arg0>Jack</arg0> 
         <arg1>16</arg1> 
     </q0:sayhello>
  </soapenv:Body>
</soapenv:Envelope>

1
2
3
4
5
6
7
8
9
10
11
12
13

• response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ns2:sayhelloResponse xmlns:ns2="http://test.cxf.hgx.com/">
      <return>Hello, Jack(16 years old)</return>
    </ns2:sayhelloResponse>
  </soap:Body>
</soap:Envelope>
1
2
3
4
5
6
7

五 WSDL文件解析

5.1 WSDL报文总体概述

<definitions>
	<types>
	  	定义 web service 使用的数据类型
	</types>
	<message>
		每个消息均由一个或多个部件组成。可以把它当做java中一个函数调用的参数。
	</message>

	<portType>
		它类似Java中的一个函数库（或一个模块、或一个类）
	</portType>

	<binding>
		为每个端口定义消息格式和协议细节。
    </binding>
</definitions>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

5.2 WSDL报文之wsdl:definitions

<wsdl:definitions 
		xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
		xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" 
		xmlns:tns="http://service.hgx.com/" 
		xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" 
		xmlns:ns1="http://schemas.xmlsoap.org/soap/http" 
		name="HelloWorldImplService" 
		targetNamespace="http://service.hgx.com/">
</wsdl:definitions>
1
2
3
4
5
6
7
8
9

5.4 WSDL报文之wsdl:types

• 我们java定义的服务接口中某方法的输入参数和返回值。
  

5.5 WSDL报文之wsdl:message

• 通信消息的数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构。
  
• WebService中每个方法包含两部分：
  • 一个是方法的输入参数；另一个是方法的输出参数。
  • 其实质都是基于SOAP协议将其封装为消息，所以每一个方法对应有两个消息，一个输入一个输出回应。简单而言，就是方法和Message的关系是N:2N的关系。一对二。
  • Message中的具体内容是part,结合前面可知，message中的part内容请到前面定义过的types中去看，它会引用之前的type相关内容

5.6 WSDL报文之wsdl:portType

• portType = 接口
• operation = 接口中定义的方法
  

5.7 WSDL报文之wsdl:binding

• 特定端口类型的具体协议和数据格式规范的绑定
  

5.8 WSDL报文之wsdl:service

• 负责将网络通信地址赋给一个具体的绑定