webservice接口开发经历

ゞ浴缸里的玫瑰 2022-01-17 02:09 237阅读 0赞

1. 复习准备

## 1.1. Schema约束 ##

几个重要知识：

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 
 <ol> 
 <li>namespace</li> 
 </ol>相当于schema文件的id 
 <ol> 
 <li>targetNamespace属性</li> 
 </ol>用来指定schema文件的namespace的值 
 <ol> 
 <li>xmlns属性</li> 
 </ol>引入一个约束, 它的值是一个schema文件的namespace值 
 <ol> 
 <li>schemaLocation属性</li> 
 </ol>用来指定引入的schema文件的位置 &nbsp; schema规范中: &nbsp;&nbsp; 1. 所有标签和属性都需要有schema文件来定义 &nbsp;&nbsp; 2. 所有的schema文件都需要有一个id, 但在这里它叫namespace, &nbsp;&nbsp; 3. namespace的值由什么来指定? &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 由targetNamespace属性来指定, 它的值是一个url(很有可能不存在) &nbsp;&nbsp; 4. 如何引入一个Schema约束? &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 属性? : 用xmlns属性 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 属性值: 对应的schema文件的id(namespace值) &nbsp;&nbsp; 5. 如果引入的schema不是w3c组织定义, 必须指定schema文件的位置 &nbsp;&nbsp; 6. schema文件的位置由什么属性来指定? &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 属性? : schemaLocation &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 属性值: namespace path 7. 如果引入了N个约束, 需要给n-1个取别名 &nbsp;&nbsp; </td> 
 </tr> 
 </tbody> 
</table>

## 1.2. HTTP协议 ##

几个重要知识：

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 1. 请求的组成： &nbsp;&nbsp;&nbsp; 请求行(请求方式&nbsp; path&nbsp; http1.1) 请求头 请求体: 只有post请求有 2. 响应的组成 &nbsp;&nbsp;&nbsp; 响应状态行: 响应头 响应体 : 浏览器解析显示的数据 3. 请求的过程 &nbsp;&nbsp;&nbsp; <img alt="" height="377" src="https://img-blog.csdnimg.cn/20190612173958285.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q=,size_16,color_FFFFFF,t_70" width="355"> </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> &nbsp; </td> 
 </tr> 
 </tbody> 
</table>

## Web service是什么？ ##

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:409.4pt;"> 1. 基于Web的服务：服务器端整出一些资源让客户端应用访问（获取数据） 2. 一个跨语言、跨平台的规范（抽象） 3. 多个跨平台、跨语言的应用间通信整合的方案（实际） &nbsp; 以各个网站显示天气预报功能为例: 气象中心的管理系统将收集的天气信息并将数据暴露出来(通过WebService Server), 而各大站点的应用就去调用它们得到天气信息并以不同的样式去展示(WebService Client). 网站提供了天气预报的服务，但其实它们什么也没有做，只是简单了调用了一下气象中心服务器上的一段代码而已。 </td> 
 </tr> 
 </tbody> 
</table>

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70][]

webservice接口优点

跨平台调用

跨语言调用

远程调用

## 什么时候使用web Service? ##

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:352.7pt;"> 1. 同一家公司的新旧应用之间 2. 不同公司的应用之间 分析业务需求：天猫网与中通物流系统如何交互？ 3. 一些提供数据的内容聚合应用：天气预报、股票行情 </td> 
 </tr> 
 </tbody> 
</table>

Web Service中的几个重要术语

## . WSDL：web service definition language ##

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 直译 : WebService定义语言 &nbsp; 1. 对应一种类型的文件.wsdl 2. 定义了web service的服务器端与客户端应用交互传递请求和响应数据的格式和方式 3. 一个web service对应一个唯一的wsdl文档 </td> 
 </tr> 
 </tbody> 
</table>

SOAP：simple object  access protocal

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 直译: 简单对象访问协议 &nbsp; 
 <ol> 
 <li>是一种简单的、基于HTTP和<a href="http://baike.baidu.com/view/63.htm" rel="nofollow">XML</a>的协议, 用于在WEB上交换结构化的数据</li> 
 <li>soap消息：请求消息和响应消息</li> 
 <li>http+xml片断</li> 
 </ol></td> 
 </tr> 
 </tbody> 
</table>

SEI：WebService EndPoint Interface(终端)

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 直译: web service的终端接口， &nbsp; 1. 就是WebService服务器端用来处理请求的接口 </td> 
 </tr> 
 </tbody> 
</table>

CXF：Celtix + XFire 框架

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 一个apache的用于开发webservice服务器端和客户端的框架 </td> 
 </tr> 
 </tbody> 
</table>

idea根据wsdl文件或者接口wsdl文件生成客户端和服务端代码

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 1][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 2][]

wsdl文件中重要标签

*  **types** - 数据类型(标签)定义的容器，里面使用schema定义了一些标签结构供message引用
 *  **message** - 通信消息的数据结构的抽象类型化定义。引用types中定义的标签
 *  **operation** - 对服务中所支持的操作的抽象描述，一个operation描述了一个访问入口的请求消息与响应消息对。
 *  **portType** - 对于某个访问入口点类型所支持的操作的抽象集合，这些操作可以由一个或多个服务访问点来支持。
 *  **binding** - 特定端口类型的具体协议和数据格式规范的绑定。
 *  **service**\- 相关服务访问点的集合
 *  **port** - 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。

cxf支持的数据类型

1.基本类型

**      int,float,boolean**等

2.引用类型

String,数组，list，set，map，自定义类型

1.  1.  CXF框架的深入使用

### 1).CXF的拦截器 ###

1.1) 理解

*  **为什么设计拦截器？**
    
    1.  为了在webservice请求过程中,能动态操作请求和响应数据, CXF设计了拦截器.
 *  拦截器分类：
    
    1.  按所处的位置分：服务器端拦截器，客户端拦截器
    2.  按消息的方向分：入拦截器，出拦截器
    3.  按定义者分：系统拦截器，自定义拦截器

**拦截器****API**

Interceptor(拦截器接口)

AbstractPhaseInterceptor(自定义拦截器从此继承)

LoggingInInterceptor(系统日志入拦截器类)

LoggingOutInterceptor(系统日志出拦截器类)

1.2) 编码实现拦截器

*  **使用日志拦截器，实现日志记录**
    
     *  LoggingInInterceptor
     *  LoggingOutInterceptor
 *  **使用自定义拦截器，实现用户名与密码的检验**
    
     *  服务器端的in拦截器
     *  客户端的out拦截器
     *  xfzhang/12345

### 2). 用CXF编写基于spring的web service ###

2.1). 编码实现

1.  **Server****端**
    
     *  创建spring的配置文件beans.xml,在其中配置SEI
     *  在web.xml中，配置上CXF的一些核心组件
2.  **Client****端**
    
     *  生成客户端代码
     *  创建客户端的spring配置文件beans-client.xml,并配置
     *  编写测试类请求web service

2.2). 添加自定义拦截器

1.  **Server****端**
    
     *  在beans.xml中，在endpoint中配置上入拦截器
2.  **Client****端**
    
     *  通过Client对象设置出拦截器
3.  1.  其它调用WebService的方式

### 1). Ajax调用webService ###

**跨域请求问题****:**

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 1. 什么是跨域请求?&nbsp;&nbsp; Host 1. sina.com--=-&gt;baidu.com/xxx.jsp 2. localhost----à192.168.42.165 2. 解决ajax跨域请求webservice的问题? 在客户端应用中使用java编码去请求webservice, 在页面中去请求自己的后台 </td> 
 </tr> 
 </tbody> 
</table>

### 2). Jquery调用WebService ###

### 3). HttpURLConnection调用WebService ###

1.  1.  通过注解修改wsdl文档

### 1). JDK中的相关注解 ###

1.1).  @WebService

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 
 <ol> 
 <li>作用在具体类上。而不是接口。</li> 
 <li>一个类只有添加了此注解才可以通过Endpoint发布为一个web服务。</li> 
 <li>一个添加了此注解的类，必须要至少包含一个实例方法。静态方法和final方法不能被发布为服务方法。</li> 
 <li>WebService注解包含以下参数：</li> 
 </ol></td> 
 </tr> 
 </tbody> 
</table>

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 3][]

1.2).  @WebMethod

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 
 <ol> 
 <li>此注解用在方法上，用于修改对外暴露的方法。</li> 
 </ol></td> 
 </tr> 
 </tbody> 
</table>

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 4][]

1.3).  @WebResult

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 用于定制返回值到WSDL的映射 &nbsp; </td> 
 </tr> 
 </tbody> 
</table>

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 5][]

1.4).  @WebParam

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 用于定义WSDL中的参数映射 这个是接口里面区别名 </td> 
 </tr> 
 </tbody> 
</table>

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 6][]

1.5).  @XmlElement

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 用于定义实体类的属性到WSDL中的映射(get/set方法上) 可以给接口arg1，取别名，这样更好的交互 </td> 
 </tr> 
 </tbody> 
</table>

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 7][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 8][]

![2019061218584786.png][]

![20190612185855406.png][]

![20190612185901943.png][]

![20190612185907132.png][]

![20190612185912171.png][]

![20190612185916860.png][]

### 2). 说明 ###

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 即使是没有修改源代码，只修改了注解，客户端的代码也必须要重新生成, 否则调用将会失败。 </td> 
 </tr> 
 </tbody> 
</table>

# 备注： #

如果之前项目中存在没用cxf框架发布的webservice接口，那么cxf框架和entpoint.publish()发布接口不能共存。

另外接口类和实现类不在一个包下，那么@webservice中命名空间要求一致

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70]: /images/20220117/42ab10de7ae24a3fa3156ead99f1e1f8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 1]: /images/20220117/7620f381e301402fba4467fcdebfde45.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 2]: /images/20220117/25d53b1775c94bc6b53042e2a95ea78a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 3]: /images/20220117/34fc0db3a623425b848adf97e2d2acb2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 4]: /images/20220117/0366bd80afd94e08bf9f0752cb163c71.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 5]: /images/20220117/34498062bd2946118c0fc1307b2c2797.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 6]: /images/20220117/9a0bcebc892c4d379918c082feb326bf.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 7]: /images/20220117/4e10d40f932a4a00adfa9f5720859c9f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pzNTIwY3Q_size_16_color_FFFFFF_t_70 8]: /images/20220117/3e358785292040ee9be8636fa5702e6a.png
[2019061218584786.png]: /images/20220117/5ea2b818c49148d9897cd74d81f47326.png
[20190612185855406.png]: /images/20220117/c1a867ba52d744be90a12c27098e3a3d.png
[20190612185901943.png]: /images/20220117/0e02865e8de64042a3cced92d0a7aadc.png
[20190612185907132.png]: /images/20220117/2aa8152df9d54e08a002c0a8b51cf95e.png
[20190612185912171.png]: /images/20220117/7ef607e089d04fb2b67b14feb5e2d1c8.png
[20190612185916860.png]: /images/20220117/543910fb55b749ab9914d8dcdf3a1c8e.png