xfire框架内部基本结构解析
1 概述
xfire是webservice的一个实现框架,是apache旗下CXF的前身,是一个比较被广泛使用的webservice框架,网上有很多关于如何使用xfire或cxf的hello world案例,但是对于它是如何运行起来的介绍比较少,最近在排查问题时对xfire的代码进行了debug,因而对xfire的运行有了大概了解,在此进行下简单总结。
2 Service
xfire作为webservice的实现框架,首当其冲的要先了解下xfire是如何将系统中的一个个功能各异的interface抽象成了具有共同行为和属性的service。
在xfire中是用org.codehaus.xfire.service.Service这个类来表示抽象出来的结果,我们首先了解下继承结构图,可以看到其主要实现了两个接口:Visitable和HandlerSupport,继承了一个类AbstractContext。下面我们先分别了解下他们所描述的内容,那么他们合起来就会知道Service主要干了什么。
2.1 Visitable
一个webservice肯定是要被外面的系统进行调用,因而一个系统必然是可以被访问的,这个接口的名字很好的解释了实现该接口的类应当具备的功能,就是可以被外界的系统访问。这个接口中也只有一个方法:
2.2 AbstractContext
context的概念是在系统设计中经常会用到的一个概念,用来描述各种操作的上下文信息(注意是上、下文,而不是上文信息、也不是下文信息),在xfire中定义了一个抽象类来描述,其内部是一个map类,并提供了相应的set、get、remove方法来操作上下文信息。其内部实现如下:
2.3 Handler
从HandlerSupport字义上看,其是对Handler提供了支持服务。因而在了解HandlerSupport之前,我们需要对Handler有所了解。xfire将客户端、服务端的各种操作抽象为Handler,并且Handler除了必备的invoke外,还额外定义了其他几个属性:
1) role:表示这个服务应用于那些角色The roles which this service applies to
2) Phase:这个handler处于那个阶段,xfire定义的phase阶段主要有下面几个,并且每个phase还有优先级的定义
3) handleFault:处理在handler执行过程中发生的错误
4) getAfter:返回handler执行后要进行的动作
5) getBefore:返回handler执行前要进行的动作
2.4 HandlerSupport
任何一个service都可以划分为客户端和服务端两部分。对于客户端而言,就是把请求输出到服务端并接收服务端的返回结果;对于服务端而言,就是接收来自客户端的请求,在处理完之后将处理结果返回给客户端。同时还要考虑在处理过程中如果发生异常时应该如何操作。因而xfire将各种handler又划分为3类:
1) InHandler 服务端进行的各项操作,主要是
ServiceInvocationHandler:获取传入的参数(InMessage)、执行service、创建返回结果(OutMessage)
PostInvocationHandler:发送结果到客户端
2) OutHandler 客户端进行的各项操作,主要是
OutMessageSender:根据输出渠道(Channel)发送消息
3) FaultHandler 发生异常时的各项操作,主要是
FaultSender:通过输出channel传输信息
CustomFaultHandler:从异常信息中构建一个定制化的详情
2.5 ServiceInfo
上面介绍的是xfire中Service的主要功能,是比较上层的抽象,给出了一个service的整体模板。对于一个具体的service所表示的interface所具备的方法功能,这些信息都存放在ServiceInfo这个类中,通过反射的方式将interface中method信息、class信息都进行了存放,供之后使用。
至此和Service相关的主要接口和类介绍完了,整体来看就是Service用ServiceInfo描述了这个service表示那个interface及这个interface具有那些方法,这个可以看作其属性。其具体的功能则由继承了各个接口来表示。功能的实现主要包括了两类:客户端的输出和服务端的输入处理及输出。
3 Channel &HttpChannel
作为webservice,客户端和服务端的数据传输需要通过某种渠道来实现,Channel类就是对渠道的抽象(xfire中各个类的命名真是字达其意,一目了然,堪称命名的典范)。doc的介绍是:A channel for communication. This can be a channel on an underlying transport - like HTTP - or wrap another channel and provide additional functions - like reliable messaging。说明channel可以是基于http协议也可以是对消息的封装的形成。Channel的主要功能有下面几个:
1) open
2) receive
3) send
4) close
这几个功能比较好理解,先是open channel,然后进行send或receive,执行完后进行close。在这些基础功能之外,xfire还对ChannelEndpoint进行了设置,ChannelEndpoint是指定了这个channel的终点,由它负责具体对收到的数据进行的处理。HttpChannel中的send简单的讲就是使用一个apache的httpClient包中postMethod将请求发送到服务端。
类图和继承结构如下
4 Phase
在前面介绍过handler中包含多个Phase,这个小节详细介绍下发送请求和接收请求都包含哪些phase,各个阶段对应的handler是什么,主要做的事是什么。首先要说明Phase是有顺序的,因而下面介绍的Phase在执行时是一步步执行的。
4.1 输出时的Phase
顺序 |
phase名称 |
handler |
主要功能 |
1 |
post-invoke |
SoapSerializerHandler |
设置数据序列化器 |
2 |
policy |
默认无 |
权限控制等操作(猜测) |
3 |
user |
默认无 |
用户自定义操作(猜测) |
4 |
transport |
SoapActionOutHandler |
设置soapAction |
5 |
send |
OutMessageSender |
发送请求 |
4.2 输入时的Phase
顺序 |
phase名称 |
handler |
主要功能 |
1 |
transport |
默认无 |
|
2 |
parse |
ReadHeadersHandler |
解析收到的信息,利用XMLStreamReader解析http response中的header、body、Envelope |
3 |
pre-dispatch |
CorrelatorHandler |
添加ClientReceiveHandler处理器 |
4 |
dispatch |
LocateBindingHandler SoapBodyHandler SoapActionInHandler |
进行相应的设置 |
5 |
policy |
默认无 |
权限控制等操作(猜测) |
6 |
user |
默认无 |
用户自定义操作(猜测) |
7 |
pre-invoke |
ValidateHeadersHandler |
校验被标记为“mustUnderstand”header信息 |
8 |
service |
ClientReceiveHandler |
处理最终获得到的http响应中的body信息 |
4.3 phase小结
上面这些phase是在客户端和服务端每一次操作过程中都会执行一遍的,而不是客户端只执行request的phase,服务端只执行resonse阶段的phase。因而对于客户端和服务端而言,每一次操作都包含发请求和接收响应的过程,具体的序列图
转载于:https://www.cnblogs.com/sunzhenchao/p/5073927.html
xfire框架内部基本结构解析相关推荐
- MQTT协议框架MOP代码结构解析
一.MoP是啥 MoP 即MQTT on Pulsar ,是一个在Pulsar基础上实现的MQTT协议,git地址:https://github.com/streamnative/mop 通过MoP可 ...
- iOS开发之Masonry框架源码深度解析
Masonry是iOS在控件布局中经常使用的一个轻量级框架,Masonry让NSLayoutConstraint使用起来更为简洁.Masonry简化了NSLayoutConstraint的使用方式,让 ...
- 【 Vue全家桶 · Vue CLI(四)】Vue项目的详细目录结构解析
文章目录 前言 -- 一级目录解析 一. dist 二. node_modules 三. public 四. src(基础版) 4.1 main.js 4.2 App.vue 4.3 src / as ...
- [转载]深入探索.NET框架内部了解CLR如何创建运行时对象
深入探索.NET框架内部了解CLR如何创建运行时对象 发布日期: 9/19/2005 | 更新日期: 9/19/2005 Hanu Kommalapati Tom Christian 本文讨论: • ...
- 深度学习框架Caffe源码解析
作者:薛云峰(https://github.com/HolidayXue),主要从事视频图像算法的研究, 本文来源微信公众号:深度学习大讲堂. 原文:深度学习框架Caffe源码解析 欢迎技术投稿. ...
- Java熔断框架有哪些_降级熔断框架 Hystrix 源码解析:滑动窗口统计
降级熔断框架 Hystrix 源码解析:滑动窗口统计 概述 Hystrix 是一个开源的降级熔断框架,用于提高服务可靠性,适用于依赖大量外部服务的业务系统.什么是降级熔断呢? 降级 业务降级,是指牺牲 ...
- 智能音箱硬件和软件介绍[上] 硬件结构解析[Soomal]
科大讯飞 VBOX 智能音箱 - 电路板 Google 谷歌 Google Home 智能音箱 从2014年起,我们先后通过自购和合作厂商获得多个智能语音识别"流派"的品牌音箱产品 ...
- skynet框架的设计结构
前言:skynet 是一个为网络游戏服务器设计的轻量框架.当然,它并不只是用于游戏服务器框架,不过,作为一个游戏开发者,自然是把skynet当做一个游戏服务框架来看待,更何况我是一个后台服务器开发的程 ...
- Diffusion扩散模型学习2——Stable Diffusion结构解析-以文本生成图像(文生图,txt2img)为例
Diffusion扩散模型学习2--Stable Diffusion结构解析-以文本生成图像(文生图,txt2img)为例 学习前言 源码下载地址 网络构建 一.什么是Stable Diffusion ...
最新文章
- 吴恩达老师深度学习视频课笔记:构建机器学习项目(机器学习策略)(1)
- vs2015 Preprocessor
- Leetcode 746. Min Cost Climbing Stairs
- 硬编码学习笔记(二)—— 经典变长指令
- simulink快捷键_从EPB模型谈谈Simulink代码生成
- 视觉SLAM-显示相机的位姿
- SpringCloud工作笔记049---nginx的安装及配置为简单的文件服务器
- 伤感网络验证系统_网络攻防演练中弱密码安全治理的几点建议
- jQuery checkbox全选问题
- 高斯正反算 java_高斯投影正反算的代码
- 监控服务器ssh登录,并发送报警邮件
- bcm94352屏蔽第20针脚图_iOS13屏蔽系统更新教程-【转载】
- 【LInux入门手册】目录结构 常用指令与操作 vim与tmux
- DLL和EXE如何读取包含在自身的资源文件
- RN-路由---基础
- Redis的多路复用机制
- 2021高性价比蓝牙耳机榜单,学生党最爱五款平价蓝牙耳机分享
- AUTOCAD——云线命令、滚动条设置
- python 机器学习——特征筛选实现
- 智能电动车无感解锁方案:设备篇