5. 开发webservice

5.1. 概述

• 开发手段：
  • 使用JDK开发(1.6及以上版本)
  • 使用CXF框架开发(工作中)
• 组成：
  • 服务器端
  • 客户端

5.2. 使用JDK开发WebService

1).开发服务器端

• Web Service编码：
  • @WebService( SEI和SEI的实现类)
  • @WebMethod(SEI中的所有方法)
• 发布Web Service：
  • Endpoint(终端, 发布webservice)

2). 开发客户端

• 使用eclipse提供的web service浏览器访问
  • 查看对应的wsdl文档：…..?wsdl(一般浏览器)
  • 请求webService并查看请求和响应消息(webservice浏览器)

• 创建客户端应用编码方式访问
  • 借助jdk的exe工具生成客户端代码：

wsimport -keep url   //url为wsdl文件的路径

• 借助生成的代码编写请求代码

5.3. 监听请求: 使用Eclipse的TCP/IP工具

1. 将服务器端的WSDL文档保存到客户端本地
2. 修改文档: 将端口号从8989改为8080
3. 根据本地的wsdl文档生成客户端代码, 并编写客户端的调用代码
4. 配置eclipse的TCP/IP,启动监听

      5.执行客户端代码发送WebService请求

5.4. 调用免费的web service(天气预报)

2. Google”免费WebService”, 找到提供天气预报Webservice的网络地址
   • http://webservice.webxml.com.cn/WebServices/WeatherWS.asmx
3. 使用eclipse的web service浏览器访问
4. 客户端编码方式访问
   • 借助命令工具自动生成客户端代码
   • 借助生成的代码编写请求代码

说明: 直接生成客户端代码会抛异常, 无法生成客户端代码, 解决办法: 1. 将对应的wsdl文档保存到本地 2. 修改wsdl文档的部分内容: 将 <s:element ref="s:schema" /><s:any /> 替换成 <s:any minOccurs="2" maxOccurs="2"/> 备注: 这个是Java调用net的webservice都有的问题

 

5.5. 使用CXF开发web service

加入cxf的jar包即可，其它不需要改动

5.6. WebService请求深入分析

1). 分析WebService的WSDL文档结构

1.1). 实例截图

1.2). 文档结构

<definitions> <types> <schema> <element> </types> <message> <part> </message> <portType> <operation> <input> <output> </portType> <binding> <operation> <input> <output> </binding> <service> <port> <address> </service> </definitions>

1.3). 文档结构图

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

2). 测试CXF支持的数据类型

1. 基本类型
   • int,float,boolean等
2. 引用类型
   • String
   • 集合：数1组，List, Set, Map
   • 自定义类型   Student

3). 一次Web service请求的流程

一次web service请求的本质:

1) 浏览器向服务器端发送了一个soap消息(http请求+xml片断)

2) 服务器端处理完请求后, 向客户端返回一个soap消息

那么它的流程是怎样的呢？

5.7. CXF框架的深入使用

1).CXF的拦截器

1.1) 理解

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

Interceptor(拦截器接口)

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

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

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

1.2) 编码实现拦截器

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

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

2.1). 编码实现

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

2.2). 添加自定义拦截器

1. Server端
   • 在xml中，在endpoint中配置上入拦截器
2. Client端
   • 通过Client对象设置出拦截器

5.8. 其它调用WebService的方式

1). Ajax调用webService

跨域请求问题:

1. 什么是跨域请求? 1. sina.com--=->baidu.com/xxx.jsp 2. localhost----à192.168.42.165 2. 解决ajax跨域请求webservice的问题? 在客户端应用中使用java编码去请求webservice, 在页面中去请求自己的后台

 

2). Jquery调用WebService

3). HttpURLConnection调用WebService

5.9. 通过注解修改wsdl文档

1). JDK中的相关注解

1.1).  @WebService

l 作用在具体类上。而不是接口。 l 一个类只有添加了此注解才可以通过Endpoint发布为一个web服务。 l 一个添加了此注解的类，必须要至少包含一个实例方法。静态方法和final方法不能被发布为服务方法。 l WebService注解包含以下参数：

 

1.2).  @WebMethod

l 此注解用在方法上，用于修改对外暴露的方法。

1.3).  @WebResult

用于定制返回值到WSDL的映射

1.4).  @WebParam 

用于定义WSDL中的参数映射

1.5).  @XmlElement 

用于定义实体类的属性到WSDL中的映射(get/set方法上)

 

2). 说明

即使是没有修改源代码，只修改了注解，客户端的代码也必须要重新生成, 否则调用将会失败。