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做什么特别的事情,因为它已经被封装到一个较为底层的类中,而要实现未知文本格式的支持,你就需要提供这样一个类似的底层类。
秘密就在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将义无反顾的继续充当小白鼠,来为大家淌出一条血路
请期待JSON与YAML的到来。
分享到:
相关推荐
* XBlink最NB的反序列方法,生成你需要的对象。 * * * 根据docTypeName与其格式特点,进行反序列化生成对象。 * * @param cs * 字符信息 * @param docTypeName * 任意你想要的文档格式...
NULL 博文链接:https://pangwu86.iteye.com/blog/893887
微信小程序番茄时钟的源码,支持进一步的修改。番茄钟,指的是把工作任务分解成半小时左右,集中精力工作25分钟后休息5分钟,如此视作种一个“番茄”,而“番茄工作法”的流程能使下一个30分钟更有动力。
电子元件 电子行业 行业分析 数据分析 数据报告 行业报告
安享智慧理财测试项目Mock服务代码
【资源说明】 课程设计 基于SparkMLlib的ALS算法的电影推荐系统源码+详细文档+全部数据齐全.zip课程设计 基于SparkMLlib的ALS算法的电影推荐系统源码+详细文档+全部数据齐全.zip 【备注】 1、该项目是高分毕业设计项目源码,已获导师指导认可通过,答辩评审分达到95分 2、该资源内项目代码都经过测试运行成功,功能ok的情况下才上传的,请放心下载使用! 3、本项目适合计算机相关专业(如软件工程、计科、人工智能、通信工程、自动化、电子信息等)的在校学生、老师或者企业员工下载使用,也可作为毕业设计、课程设计、作业、项目初期立项演示等,当然也适合小白学习进阶。 4、如果基础还行,可以在此代码基础上进行修改,以实现其他功能,也可直接用于毕设、课设、作业等。 欢迎下载,沟通交流,互相学习,共同进步!
华中科技大学电信专业 课程资料 作业 代码 实验报告-雷达与信息对抗-内含源码和说明书.zip
私信博主免费获取真题解析以及代码
【资源说明】 基于Bilibili公开的数据,通过Flink实时分析计算,做成需要的动态图表源码+部署文档+全部资料齐全 高分项目.zip基于Bilibili公开的数据,通过Flink实时分析计算,做成需要的动态图表源码+部署文档+全部资料齐全 高分项目.zip 【备注】 1、该项目是个人高分项目源码,已获导师指导认可通过,答辩评审分达到95分 2、该资源内项目代码都经过测试运行成功,功能ok的情况下才上传的,请放心下载使用! 3、本项目适合计算机相关专业(人工智能、通信工程、自动化、电子信息、物联网等)的在校学生、老师或者企业员工下载使用,也可作为毕业设计、课程设计、作业、项目初期立项演示等,当然也适合小白学习进阶。 4、如果基础还行,可以在此代码基础上进行修改,以实现其他功能,也可直接用于毕设、课设、作业等。 欢迎下载,沟通交流,互相学习,共同进步!
Python库是一组预先编写的代码模块,旨在帮助开发者实现特定的编程任务,无需从零开始编写代码。这些库可以包括各种功能,如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库,如NumPy、Pandas和Requests,极大地丰富了Python的应用领域,从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径,而且为经验丰富的开发者提供了强大的工具,以高效率、高质量地完成复杂任务。例如,Matplotlib和Seaborn库在数据可视化领域内非常受欢迎,它们提供了广泛的工具和技术,可以创建高度定制化的图表和图形,帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。
私信博主免费获取真题解析以及代码
Python库是一组预先编写的代码模块,旨在帮助开发者实现特定的编程任务,无需从零开始编写代码。这些库可以包括各种功能,如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库,如NumPy、Pandas和Requests,极大地丰富了Python的应用领域,从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径,而且为经验丰富的开发者提供了强大的工具,以高效率、高质量地完成复杂任务。例如,Matplotlib和Seaborn库在数据可视化领域内非常受欢迎,它们提供了广泛的工具和技术,可以创建高度定制化的图表和图形,帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。
Python库是一组预先编写的代码模块,旨在帮助开发者实现特定的编程任务,无需从零开始编写代码。这些库可以包括各种功能,如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库,如NumPy、Pandas和Requests,极大地丰富了Python的应用领域,从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径,而且为经验丰富的开发者提供了强大的工具,以高效率、高质量地完成复杂任务。例如,Matplotlib和Seaborn库在数据可视化领域内非常受欢迎,它们提供了广泛的工具和技术,可以创建高度定制化的图表和图形,帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。
Python库是一组预先编写的代码模块,旨在帮助开发者实现特定的编程任务,无需从零开始编写代码。这些库可以包括各种功能,如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库,如NumPy、Pandas和Requests,极大地丰富了Python的应用领域,从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径,而且为经验丰富的开发者提供了强大的工具,以高效率、高质量地完成复杂任务。例如,Matplotlib和Seaborn库在数据可视化领域内非常受欢迎,它们提供了广泛的工具和技术,可以创建高度定制化的图表和图形,帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。
Python库是一组预先编写的代码模块,旨在帮助开发者实现特定的编程任务,无需从零开始编写代码。这些库可以包括各种功能,如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库,如NumPy、Pandas和Requests,极大地丰富了Python的应用领域,从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径,而且为经验丰富的开发者提供了强大的工具,以高效率、高质量地完成复杂任务。例如,Matplotlib和Seaborn库在数据可视化领域内非常受欢迎,它们提供了广泛的工具和技术,可以创建高度定制化的图表和图形,帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。
【资源说明】 基于Hadoop的智能购书系统的设计与实现+部署文档+全部资料 高分项目.zip基于Hadoop的智能购书系统的设计与实现+部署文档+全部资料 高分项目.zip 【备注】 1、该项目是个人高分项目源码,已获导师指导认可通过,答辩评审分达到95分 2、该资源内项目代码都经过测试运行成功,功能ok的情况下才上传的,请放心下载使用! 3、本项目适合计算机相关专业(人工智能、通信工程、自动化、电子信息、物联网等)的在校学生、老师或者企业员工下载使用,也可作为毕业设计、课程设计、作业、项目初期立项演示等,当然也适合小白学习进阶。 4、如果基础还行,可以在此代码基础上进行修改,以实现其他功能,也可直接用于毕设、课设、作业等。 欢迎下载,沟通交流,互相学习,共同进步!
Python库是一组预先编写的代码模块,旨在帮助开发者实现特定的编程任务,无需从零开始编写代码。这些库可以包括各种功能,如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库,如NumPy、Pandas和Requests,极大地丰富了Python的应用领域,从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径,而且为经验丰富的开发者提供了强大的工具,以高效率、高质量地完成复杂任务。例如,Matplotlib和Seaborn库在数据可视化领域内非常受欢迎,它们提供了广泛的工具和技术,可以创建高度定制化的图表和图形,帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。
在面对机械装备制造行业日益增长的信息化需求时,本PPT格式的解决方案文档旨在提供一个全面、高效的数字化转型蓝图。这个资料包涵盖了从生产流程自动化到智能数据分析,再到供应链管理优化的各个方面,旨在帮助机械制造企业实现更高层次的生产智能化和运营效率。解决方案中,我们首先强调了制造执行系统(MES)的集成,它能够实时监控工厂的生产线,确保生产过程的透明度和可追溯性。通过与物联网(IoT)设备的结合,可以实现设备状态的远程监控和维护预测,从而减少停机时间并提高生产效率。其次,方案中还包含了一套完整的企业资源规划(ERP)系统,它能够帮助企业管理从原材料采购到成品出库的整个流程,确保物流和信息流的无缝对接。ERP系统的应用不仅提升了资源的使用效率,也为企业决策提供了数据支持。此外,我们还提出了基于大数据和人工智能技术的智能分析模块,该模块能够对生产过程中产生的海量数据进行深度分析,帮助企业发现潜在的生产瓶颈,优化产品设计,提升产品质量,同时也能够根据市场趋势调整生产计划,增强企业的市场响应能力。最后,为了确保整个信息系统的安全性和稳定性,解决方案还包括了先进的网络安全措施和数据备份机制,保障企业
厦门大学软件工程系卓越工程师班算法分析与设计课程实验源码-内含源码和说明书.zip
Python库是一组预先编写的代码模块,旨在帮助开发者实现特定的编程任务,无需从零开始编写代码。这些库可以包括各种功能,如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库,如NumPy、Pandas和Requests,极大地丰富了Python的应用领域,从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径,而且为经验丰富的开发者提供了强大的工具,以高效率、高质量地完成复杂任务。例如,Matplotlib和Seaborn库在数据可视化领域内非常受欢迎,它们提供了广泛的工具和技术,可以创建高度定制化的图表和图形,帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。