开发webservice
1. 概述
- 开发手段:使用JDK开发(1.6及以上版本)使用CXF框架开发(工作中)
- 组成:服务器端客户端
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文件的路径
- 借助生成的代码编写请求代码
3. 监听请求: 使用Eclipse的TCP/IP工具
- 将服务器端的WSDL文档保存到客户端本地
- 修改文档: 将端口号从8989改为8080
- 根据本地的wsdl文档生成客户端代码, 并编写客户端的调用代码
- 配置eclipse的TCP/IP,启动监听
5.执行客户端代码发送WebService请求
4. 调用免费的web service(天气预报)
- Google”免费WebService”, 找到提供天气预报Webservice的网络地址http://webservice.webxml.com.cn/WebServices/WeatherWS.asmx
- 使用eclipse的web service浏览器访问
- 客户端编码方式访问借助命令工具自动生成客户端代码借助生成的代码编写请求代码
说明: 直接生成客户端代码会抛异常, 无法生成客户端代码, 解决办法: 1. 将对应的wsdl文档保存到本地 2. 修改wsdl文档的部分内容: 将 <s:element ref=”s:schema” /><s:any /> 替换成 <s:any minOccurs=”2″ maxOccurs=”2″/> 备注: 这个是Java调用net的webservice都有的问题 |
5. 使用CXF开发web service
加入cxf的jar包即可,其它不需要改动
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支持的数据类型
- 基本类型int,float,boolean等
- 引用类型String集合:数1组,List, Set, Map自定义类型 Student
3). 一次Web service请求的流程
一次web service请求的本质:
1) 浏览器向服务器端发送了一个soap消息(http请求+xml片断)
2) 服务器端处理完请求后, 向客户端返回一个soap消息
那么它的流程是怎样的呢?
7. CXF框架的深入使用
1).CXF的拦截器
1.1) 理解
- 为什么设计拦截器?为了在webservice请求过程中,能动态操作请求和响应数据, CXF设计了拦截器.
- 拦截器分类:
- 按所处的位置分:服务器端拦截器,客户端拦截器
- 按消息的方向分:入拦截器,出拦截器
- 按定义者分:系统拦截器,自定义拦截器
- 拦截器API
Interceptor(拦截器接口)
AbstractPhaseInterceptor(自定义拦截器从此继承)
LoggingInInterceptor(系统日志入拦截器类)
LoggingOutInterceptor(系统日志出拦截器类)
1.2) 编码实现拦截器
- 使用日志拦截器,实现日志记录LoggingInInterceptorLoggingOutInterceptor
- 使用自定义拦截器,实现用户名与密码的检验服务器端的in拦截器客户端的out拦截器xfzhang/123456
2). 用CXF编写基于spring的web service
2.1). 编码实现
- Server端创建spring的配置文件xml,在其中配置SEI在xml中,配置上CXF的一些核心组件
- Client端生成客户端代码创建客户端的spring配置文件beans-client.xml,并配置编写测试类请求web service
2.2). 添加自定义拦截器
- Server端在xml中,在endpoint中配置上入拦截器
- Client端通过Client对象设置出拦截器
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
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). 说明
即使是没有修改源代码,只修改了注解,客户端的代码也必须要重新生成, 否则调用将会失败。 |
文章转载链接:http://www.atguigu.com/jsfx/1583.html