XBlink在1.0.0版开始编码前,想过究竟怎么才能做成一个比较灵活易于扩展的框架。(毕竟之前的太不灵活
)
灵活易于扩展,即是指很多地方可以让用户去决定,给用户更大的选择权。
序列化最终是生成可阅读的文本格式,所以只有在这上面下文章了。
经过几个朋友的讨论与个人思考,确定了至少有两点要做到。
一,对于一个对象转换生成的文字与其格式,用户可以设定。
二,对于一个用户自己定义的文本格式(或是XBlink默认没有支持的格式),用户可以有办法实现。
第一点,生成的文字与格式。
比如日期型,用人需要日月年信息就好,有人还要加上时间,这种个性化需求,就很常见。
还比如一个list,有人喜欢正常的XML格式,有人想把他们作为一行数据展示出来,例如下面这样:
<list>
<int>1</int>
<int>2</int>
<int>3</int>
</list>
<list>{1,2,3}</list>
甚至还有对于这个list,用户还有自己觉得更合理的展示方式,那能不能也实现呢。
第二点,未知的文本格式。
最初的XBlink只关注XML,没有其他想法。
直到后来Nutz的作者灰灰看了XBlink后,提出能不能支持下Yaml格式的想法。
经过思考,发现其实做成一个通用性框架也不是那么困难。
首先序列化XML,就是pojo-->xml的过程,而序列化yaml,也就是pojo-->yaml,两者除了输出格式不同,其他没有什么大的区别。
在序列化XML的时候,就是一个分析对象,拿到对象值,将值转换成文字,再按照XML格式写到文本的过程。那么想要支持yaml的话,就把最后一步,按照XML格式写到文本变成按照yaml格式写到文本就好了。
有了上面的思路,下面说下XBlink是如何实现这两点的。
第一点,生成的文字与格式。
如果你看过了这篇使用手册,那么扩展API这部分的讲解,就是对于第一点的实现。
个性化日期与只有一行的list那种要求已经可以实现了,但是用户自定义格式的问题,还有待解决。
如果用户在转换器里可以定制格式,那么序列化与反序列化必须一起写才行,必须达到一个平衡,就是你定义的格式,反序列化必须能正确解析。
这样对用户的要求就比较高了,因为本来仅仅是对象与文字之间的转换,基本没有什么难度,但加入了格式的制定与解析,用户需要了解的内容就大幅增加,而且及其容易错误。
目前想到的解决方案就是,一定要把这部分的文档写好,让用户了解这个格式到底是如何解析的,他才会正确的使用。同时更重要的,要实现一个工具,可以帮助用户检查写出的转换器是否能正常工作。这样才能保证其可用性。
第二点,未知的文本格式。
如果你看过源码,你会发现,在大部分代码里,没有针对XML做什么特别的事情,因为它已经被封装到一个较为底层的类中,而要实现未知文本格式的支持,你就需要提供这样一个类似的底层类。
![](/upload/picture/pic/100397/21710290-f132-3caa-8c79-3af700dbbffa.jpg)
秘密就在org.xblink.core.doc包下。
DocReader封装了对于文本格式的读操作。
DocWriter封装了对于文本格式的写操作。
而具体是什么格式,怎么个写法,你只要搞一个实现类,放到impl包下就好了。
/**
* 定义了读取文本文件的几个动作。
*
* @author 胖五(pangwu86@gmail.com)
*/
public interface DocReader {
/**
* 是否还存在子节点。
*
* @return
*/
public boolean hasMoreChildren();
/**
* 进去下一个节点。
*/
public void moveDown();
/**
* 退到上一个节点。
*/
public void moveUp();
/**
* 获得当前节点的名称。
*
* @return
*/
public String getNodeName();
/**
* 获得当前节点文字值。
*
* @return
*/
public String getTextValue();
/**
* 获得当期节点的属性数量。
*
* @return
*/
public int getAttributeCount();
/**
* 获得当前节点所有属性名称的迭代器。
*
* @return
*/
public Iterator<String> getAttributeNames();
/**
* 根据指定名称获得当前节点的属性值。
*
* @param name
* @return
*/
public String getAttribute(String name);
/**
* 根据指定名称获得当前节点的属性值(通过索引值)。
*
* @param index
* @return
*/
public String getAttribute(int index);
/**
* 关闭输入流。
*/
public void close();
/**
* 获得内容的Reader。
*
* @return
*/
public Reader getReader();
}
/**
* 定义了书写文本文件的几个动作。
*
* @author 胖五(pangwu86@gmail.com)
*/
public interface DocWriter {
/**
* 设置XBlink运行时设置项,可以对文本格式进行部分调整。
*
* @param xbConfig
*/
public void setXBConfig(XBConfig xbConfig);
/**
* 编写文档开头。
*
* @throws Exception
* 异常
*/
public void writeStartDocument() throws Exception;
/**
* 编写文档结尾。(一定要先调用writeStartDocument)
*
* @throws Exception
* 异常
*/
public void writeEndDocument() throws Exception;
/**
* 编写开始标签。
*
* @param tagName
* 标签名称
* @throws Exception
* 异常
*/
public void writeStartTag(String tagName) throws Exception;
/**
* 编写结束标签。(一定要先调用writeStartTag)
*
* @param tagName
* 标签名称
* @throws Exception
* 异常
*/
public void writeEndTag(String tagName) throws Exception;
/**
* 编写属性。(一定要先调用writeStartTag)
*
* @param name
* 属性名称
* @param value
* 属性值
* @throws Exception
* 异常
*/
public void writeAttribute(String name, String value) throws Exception;
/**
* 编写内容。
*
* @param text
* 内容
* @throws Exception
* 异常
*/
public void writeText(String text) throws Exception;
/**
* 编写元素。
*
* @param tagName
* 元素名称
* @param text
* 内容
* @throws Exception
* 异常
*/
public void writeElementText(String tagName, String text) throws Exception;
/**
* 编写引用节点。(一定要先调用writeStartTag)
*
* @param tagName
* 元素名称
* @param refName
* 引用属性名称
* @param text
* 引用路径
* @throws Exception
* 异常
*/
public void writeReference(String tagName, String refName, String text) throws Exception;
/**
* 关闭当前Writer。
*
* @throws Exception
* 异常
*/
public void close() throws Exception;
/**
* 输出当前内容。
*
* @throws Exception
* 异常
*/
public void flush() throws Exception;
/**
* 返回生成的文本。
*
* @return 文本内容
*/
public String getString();
/**
* 获得内部的Writer。
*
* @return
*/
public Writer getWriter();
}
通过上面的代码你可以看到,这里的操作基本没有针对某个文本格式(除了对Attribute的操作)。
这样你就很容易写出一个JSON的实现,一个YAML的实现,一个你自己的实现。
理论上,对于一个新的文本格式的支持,例如这个文本格式叫做OOXX,那么你只要写两个类,一个OOXXReader,一个OOXXWriter,足以。
当时这只是理论上的,能不能像ME想的这样简单,还要用代码用事实来证明。
毕竟暂时还没有第二个格式的Reader与Writer诞生。
所以ME将义无反顾的继续充当小白鼠,来为大家淌出一条血路![](/images/smiles/icon_biggrin.gif)
请期待JSON与YAML的到来。
分享到:
相关推荐
* XBlink最NB的反序列方法,生成你需要的对象。 * * * 根据docTypeName与其格式特点,进行反序列化生成对象。 * * @param cs * 字符信息 * @param docTypeName * 任意你想要的文档格式...
JESD79-2F DDR2 JESD79-3F DDR3 JESD79-4D DDR4 JESD79-5C DDR5 JESD209-2F LPDDR2 JESD209-3C LPDDR3 JESD209-4E LPDDR4 JESD209-4-1A LPDDR4X JESD209-5C LPDDR5(X)
COMSOL二维光子晶体角态研究:单胞与超胞能带计算及边界态与角态特性分析,COMSOL二维光子晶体角态研究:单胞与超胞能带计算及边界态与角态特性分析,comsol二维光子晶体角态。 单胞能带,超胞能带,边界态以及角态计算。 ,comsol;二维光子晶体;角态;单胞能带;超胞能带;边界态计算,基于Comsol的二维光子晶体角态及能带边界计算研究
六自由度机械臂抓取动作仿真与代码解析:抓取动画、关节参数变化及轨迹图解详解,六自由度机械臂抓取动作仿真指南:掌握两套代码实现动画与轨迹图模拟学习攻略,六自由度机械臂抓取动作仿真-8 两套关于抓取动作的代码,包括抓取动画、关节角、角速度、角加速度的变化仿真、以及抓取轨迹图 简单易懂好上手~ ,六自由度机械臂;抓取动作仿真;抓取动画;关节角变化;角速度角加速度;抓取轨迹图;两套代码;简单易懂好上手,六自由度机械臂抓取动作仿真演示:代码与轨迹图解
ITC网络广播工具软件
Multisim四位密码锁电路仿真设计:设定、开锁与声光报警功能演示资料包,Multisim四位密码锁电路仿真设计:设定、输入、开锁与报警功能详解,附源文件、原理说明书与演示视频,multisim四位密码锁电路仿真设计 功能: 1.通过拨码开关1进行初始密码设定。 2.通过拨码开关2输入密码,实现开锁判断。 3.如果密码正确,LED绿灯亮,表示开锁。 4.如果密码不正确,LED红灯亮,蜂鸣器鸣叫,声光报警。 资料包含:仿真源文件+原理说明书+演示视频 ,四位密码锁电路、Multisim仿真设计、初始密码设定;拨码开关输入;开锁判断;LED灯显示;声光报警;仿真源文件;原理说明书;演示视频,Multisim四位密码锁电路仿真设计:初始密码设置与智能解锁功能的声光报警展示
俗话说,摸鱼摸的好,上班没烦恼,毕竟谁能拒绝带薪拉屎呢(手动狗头) 这是一个云开发职场打工人专属上班摸鱼划水微信小程序源码,没有后台 直接导入微信开发者工具即可运行,UI简约大气漂亮,只需登录微信公众平台配置完合法域名即可轻松上线。 用户进入摸鱼小程序,可以自由设置薪资,上班时间、下班时间、发薪日、 月工作天数以提醒自己摸鱼,全民打酱油,让自己成为摸鱼冠军,《商鞅摸鱼哲学》 摸鱼不是自我放纵,而是个人实力的积蓄,我们的小目标是晚睡晚起 小程序中的今日待办会提醒用户带薪拉屎和闲逛,下方展示的是距离休息日的天数,距离下一次发工资的天数和节日的天数。
【毕业设计】基于Java的开发的一个集合校园二手交易、拼车、失物招领等功能的app_pgj
个人记录:PICkit3离线烧录流程 使用软件:MPLAB X IDE v5.30 记录时间:20250215
基于Matlab代码的电力系统状态估计与实验仿真研究:扩展卡尔曼滤波和无迹卡尔曼滤波在电力系统动态状态估计中的应用及效果分析,Matlab仿真实验研究:基于扩展卡尔曼滤波器与无迹卡尔曼滤波器对电力系统状态估计的影响及验证,状态估计 电力系统状态估计 Matlab代码 实验仿真研究 电力系统由于测量值和传输误差,还有测量噪声的影响,会对状态估计产生影响。 因此,需要对嘈杂的测量进行滤波,以获得准确的电力系统运行动态。 本文使用扩展卡尔曼滤波器(EKF)和无迹卡尔曼滤波器(UKF)来估计电力系统的动态状态。 扩展卡尔曼滤波EKF、无迹卡尔曼滤波UKF 利用扩展的无迹卡尔曼滤波器估计了动力系统的动态状态。 对WECC 3机9总线系统和新英格兰10机39总线系统进行了案例研究。 结果表明EKF和UKF都能准确地估计电力系统的动态状态。 ,核心关键词:状态估计; 电力系统状态估计; Matlab代码; 实验仿真; 测量值误差; 测量噪声; 扩展卡尔曼滤波器(EKF); 无迹卡尔曼滤波器(UKF); 动力系统; 动态状态估计; WECC 3机9总线系统; 新英格兰10机39总线系统。,Matlab
springboot在线考试--
台达DVP EH3与MS300 PLC&变频器通讯程序的全面解决方案,台达DVP EH3与MS300通讯程序:稳定可靠的频率控制与启停管理系统,台达DVP EH3与台达MS300通讯程序(TDEH-9) 可直接用于实际的程序,程序带注释,并附送触摸屏程序,有接线方式和设置,通讯地址说明等。 程序采用轮询,可靠稳定 器件:台达DVP EH3系列PLC,台达MS300系列变频器,昆仑通态7022Ni 功能:实现频率设定,启停控制,实际频率读取,加减速时间设定。 资料:带注释程序,触摸屏程序,接线和设置说明,后续有技术咨询。 ,核心关键词:台达DVP EH3; 台达MS300; 通讯程序(TDEH-9); 轮询; 稳定; 频率设定; 启停控制; 实际频率读取; 加减速时间设定; 触摸屏程序; 接线方式; 设置说明; 技术咨询。,台达PLC与变频器通讯程序(带注释、触摸屏控制)
项目资源包含:可运行源码+sql文件 适用人群:学习不同技术领域的小白或进阶学习者;可作为毕设项目、课程设计、大作业、工程实训或初期项目立项。项目具有较高的学习借鉴价值,也可拿来修改、二次开发。 个人账户管理:支持用户注册、登录与个人信息编辑;提供密码找回及账号安全保护措施。 声纹采集:利用麦克风设备录制用户的声纹样本;支持多种录音格式和质量调整,确保采集到清晰、准确的声纹数据。 声纹模板库管理:建立和维护一个安全的声纹模板库;支持声纹模板的添加、删除、更新和查询操作。 声纹比对与识别:运用深度学习算法对输入的声纹数据进行特征提取和匹配;实现快速、准确的声纹身份验证。 多场景应用支持:适用于多种场景,如门禁系统、移动支付、远程登录等;可根据实际需求定制开发相应的应用场景。 实时监控与报警:实时监控系统运行状态,包括声纹识别成功率、处理速度等指标;当出现异常情况时,及时发出报警信息。 数据分析与报告生成:收集并分析声纹识别过程中的数据,如识别准确率、处理时间等;根据用户需求输出包含详细图表说明的专业级文档供下载打印保存。 社区互动交流:设立论坛版块鼓励用户分享心得体会讨论热点话题;定期邀请行业专家举办线上讲座传授实用技巧知识。 音乐筛选与推荐:集成音乐平台API,根据用户的浏览习惯和情绪状态推荐背景音乐,增强用户体验。 数据可视化:提供交互式的数据可视化面板,使非技术用户也能轻松理解复杂的数据集,从而做出更明智的决策。
三相与多相开绕组永磁同步电机仿真模型的先进控制策略探讨与实现,三相与多相开绕组永磁同步电机的Simulink仿真模型与先进控制策略研究,开绕组电机,开绕组永磁同步电机仿真模型、simulink仿真 共直流母线、独立直流母线,两相容错,三相容错控制,零序电流抑制,控制策略很多 三相开绕组永磁同步电机,六相开绕组永磁同步电机 五相开绕组永磁同步电机,五相开绕组电机 ,开绕组电机; 永磁同步电机仿真模型; simulink仿真; 共直流母线; 独立直流母线; 两相容错; 三相容错控制; 零序电流抑制; 控制策略; 六相开绕组永磁同步电机; 五相开绕组永磁同步电机,开绕组电机仿真研究:共直流母线与独立直流母线的容错控制策略
【毕业设计】基于Java的开发的网上汽车租赁管理系统_pgj
csv 模块是 Python 的标准库,无需额外安装。 运行结果如下图: ['姓名', '年龄', '城市'] ['张三', '25', '北京'] ['李四', '30', '上海'] ['王五', '22', '广州']
【毕业设计】基于Java+Springboot+Vue的宠物领养系统_pgj
让前端开发者学习“机器学习”!
【毕业设计】基于Java的实现的以宠物为主体的论坛式的APP