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 * 任意你想要的文档格式...
基于万能逼近原理的自适应模糊控制算法在多自由度AUV运动控制中的应用与抗干扰补偿Simulink仿真研究,自适应模糊控制算法的万能逼近原理与多自由度AUV运动控制的抗干扰补偿技术——基于Simulink的仿真研究,万能逼近原理自适应模糊控制算法的多自由度AUV运动控制抗干扰补偿simulink仿真 ,核心关键词:万能逼近原理; 自适应模糊控制算法; 多自由度AUV运动控制; 抗干扰补偿; Simulink仿真。,基于万能逼近的模糊控制算法多自由度AUV抗干扰补偿Simulink仿真
deepseek最新资讯、配置方法、使用技巧,持续更新中
deepseek最新资讯、配置方法、使用技巧,持续更新中
结合扩展卡尔曼滤波与滑模观测器的策略:优化电角度估计,反电势波形逼近完美正弦波,结合扩展卡尔曼滤波与滑模观测器的反电势波形优化:正弦波形展现近乎完美精度,电角度估算与实际应用差异微小,扩展卡尔曼滤波与滑模观测器的结合,反电势波形近乎完美的正弦波形,观测器估算转子电角度与实际电角度相差0.3弧度左右,转速跟随效果较好。 ,核心关键词:扩展卡尔曼滤波; 滑模观测器; 反电势波形; 转子电角度估算; 转速跟随效果。,卡尔曼滑模观测器:优化正弦波转子角度与转速估算
毕业设计_基于springboot+vue的**学生公寓管理系统**【源码+sql+可运行】【**50217**】.zip 全部代码均可运行,亲测可用,尽我所能,为你服务; 1.代码压缩包内容 代码:springboo后端代码+vue前端页面代码; 脚本:数据库SQL脚本 效果图:运行结果请看资源详情效果图 2.环境准备: - JDK1.8+ - maven3.6+ - nodejs14+ - mysql5.6+ - redis 3.技术栈 - 后台:springboot+mybatisPlus+Shiro - 前台:vue+iview+Vuex+Axios - 开发工具: idea、navicate 4.功能列表 - 系统设置:用户管理、角色管理、资源管理、系统日志 - **业务管理:业务管理:公寓信息、房间信息、入住记录、学生信息** 3.运行步骤: 步骤一:修改数据库连接信息(ip、port修改) 步骤二:找到启动类xxxApplication启动 4.若不会,可私信博主!!!
1、文件内容:xorg-x11-server-source-1.20.4-29.el7_9.rpm以及相关依赖 2、文件形式:tar.gz压缩包 3、安装指令: #Step1、解压 tar -zxvf /mnt/data/output/xorg-x11-server-source-1.20.4-29.el7_9.tar.gz #Step2、进入解压后的目录,执行安装 sudo rpm -ivh *.rpm 4、更多资源/技术支持:公众号禅静编程坊
1、文件内容:yum-plugin-ps-1.1.31-54.el7_8.rpm以及相关依赖 2、文件形式:tar.gz压缩包 3、安装指令: #Step1、解压 tar -zxvf /mnt/data/output/yum-plugin-ps-1.1.31-54.el7_8.tar.gz #Step2、进入解压后的目录,执行安装 sudo rpm -ivh *.rpm 4、更多资源/技术支持:公众号禅静编程坊
基于模型预测控制(MPC)的无人船与无人车编队一致性协同控制研究(附原文献),基于模型预测控制(MPC)的无人船与无人车编队一致性协同控制研究(附原文献),无人船编队 无人车编队 MPC 模型预测控制 多智能体协同控制 一致性 MATLAB 无人车 USV 带原文献 ,无人船编队; 无人车编队; MPC 模型预测控制; 多智能体协同控制; 一致性; MATLAB; USV; 原文献,无人系统协同控制:MPC模型预测控制下的多智能体编队与一致性研究(原文献支撑)
4套中级通信工程师综合真题及答案(2019,2020,2021,2023),适用于需要考中级通信工程师的人群
deepseek最新资讯,配置方法,使用技巧,持续更新中
基于matlab的锁相环PLL相位噪声拟合仿真代码集合:多个版本建模与仿真,高质量的锁相环PLL仿真代码集合:Matlab与Simulink建模研究,[1]锁相环 PLL 几个版本的matlab相位噪声拟合仿真代码,质量杠杠的,都是好东西 [2]锁相环matlab建模稳定性仿真,好几个版本 [3]锁相环2.4G小数分频 simulink建模仿真 ,PLL; Matlab相位噪声拟合仿真; Matlab建模稳定性仿真; 锁相环2.4G小数分频Simulink建模仿真,MATLAB仿真系列:锁相环PLL及分频器建模仿真
exceptionLogs.zip
基于光伏微网的经济性与并网负荷波动率双目标优化调度策略:蓄电池与V2G协同管理策略仿真研究,MATLAB下光储充微网结合电动汽车V2G的多目标协同调度策略研究:经济性与并网负荷波动性的对比分析,MATLAB代码:考虑V2G的光储充一体化微网多目标优化调度策略 关键词:光储充微网 电电汽车V2G 多目标优化 蓄电池优化 调度 参考文档:《光伏微网下考虑V2G补偿蓄电池容量的双目标优化调度策略》,已经投稿EI会议,中文说明文档可联系我咨询 仿真平台:MATLAB 平台 优势:代码注释详实,适合参考学习,相关成果已经采用,程序非常精品,请仔细辨识 主要内容:过建立光伏微网中以经济性和并网负荷波动率为双目标的蓄电池和V2G的协同调度模型。 采用粒子群算法,对电网、微网调度中心和电动汽车用户三方在无、无序、转移和调度V2G电动汽车负荷四种运行模式下的经济和安全影响进行对比。 最后,根据算例分析,求解四种模式下两级负荷曲线及经济收益表。 对比分析得出,引入V2G可以替代部分容量的蓄电池,使光伏微网在负荷峰谷平抑、三方经济和安全等方面进一步优化。 求解采用的是PSO算法(粒子群算法),求解效果极
javascript 动态网页设计期末大作业(自己手写的,高分期末作业),含有代码注释,新手也可看懂,个人手打98分项目,导师非常认可的高分项目,毕业设计、期末大作业和课程设计高分必看,下载下来,简单部署,就可以使用。该项目可以直接作为毕设、期末大作业使用,代码都在里面,系统功能完善、界面美观、操作简单、功能齐全、管理便捷,具有很高的实际应用价值,项目都经过严格调试,确保可以运行! javascript 动态网页设计期末大作业(自己手写的,高分期末作业)javascript 动态网页设计期末大作业(自己手写的,高分期末作业)javascript 动态网页设计期末大作业(自己手写的,高分期末作业)javascript 动态网页设计期末大作业(自己手写的,高分期末作业)javascript 动态网页设计期末大作业(自己手写的,高分期末作业)javascript 动态网页设计期末大作业(自己手写的,高分期末作业)javascript 动态网页设计期末大作业(自己手写的,高分期末作业)javascript 动态网页设计期末大作业(自己手写的,高分期末作业)javascript 动态网页设计期
混合智能体系统编队控制:分布式优化与15异构混合阶的挑战,异构混合阶智能体系统编队控制的分布式优化策略研究,15异构混合阶多智能体系统编队控制的分布式优化(无参考文献) ,核心关键词:15异构混合阶; 多智能体系统; 编队控制; 分布式优化; 无参考文献。,15混合阶多智能体系统编队分布式优化控制
javascript 动态网页设计期末大作业(自己手写的,很适合期末作业),含有代码注释,新手也可看懂,个人手打98分项目,导师非常认可的高分项目,毕业设计、期末大作业和课程设计高分必看,下载下来,简单部署,就可以使用。该项目可以直接作为毕设、期末大作业使用,代码都在里面,系统功能完善、界面美观、操作简单、功能齐全、管理便捷,具有很高的实际应用价值,项目都经过严格调试,确保可以运行! javascript 动态网页设计期末大作业(自己手写的,很适合期末作业)javascript 动态网页设计期末大作业(自己手写的,很适合期末作业)javascript 动态网页设计期末大作业(自己手写的,很适合期末作业)javascript 动态网页设计期末大作业(自己手写的,很适合期末作业)javascript 动态网页设计期末大作业(自己手写的,很适合期末作业)javascript 动态网页设计期末大作业(自己手写的,很适合期末作业)javascript 动态网页设计期末大作业(自己手写的,很适合期末作业)javascript 动态网页设计期末大作业(自己手写的,很适合期末作业)javascrip
X光安检OPIXray数据集已经转换为VOC格式,可直接转换为为YOLO
DataX--Web:图形化界面简化大数据任务管理_datax-web