公告:
由于googlecode的wiki编辑较为复杂,官网文档还需重新整理格式,这里先写一个1.0.0版的使用手册,让大家先了解下具体的使用。
用户API
对于XBlink作为普通用户只需要了解5或8个类即可,其他的都是内部使用,无需关心细节。
必备的:
两个核心类 XBlink.java XBConfig.java
三个注解类 XBlinkAlias.java XBlinkAsAttribute.java XBlinkOmitField.java
XBlink
提供了序列化反序列方法,还有几个特殊的设置项。
PS:以下提及的输出指File,Ouputstream,Writer,输入指字符串,File,Inputstream,Readrer。
toXml
一种是只需一个参数(序列化的对象),结果返回对应XML字符串。
一种是需要两个参数(序列化的对象,输出),不再返回字符串,直接将结果写到输出。
fromXml
一种是只需一个参数(输入),根据输入将其提供的XML进行反序列化,返回对象。
一种是需要三个参数(输入,参考类,参考对象),其中参考类与参考对象可以二选其一,就是最终你想返回的类型是什么,你就放进去就好了,就会以此为依据,进行反序列操作,返回对象。
toAny 与 fromAny
这是一个扩展点,这个等后续版本实现了再详细讲解。
如果你特别想知道它能做什么
那么这样说吧,下面两个方法是等效的。
// 生成XML文件
XBlink.toXml(obj);
// 生成XML文件
XBlink.toAny(obj, "xml");
setGlobalXBConfig 与 setTransientXBConfig
设置运行时配置项,关于XBConfig请看后面介绍。
setGlobalXBConfig 是设置全局的,一直适用。
setTransientXBConfig 是设置一次性的,用过即抛,跟套套一个性质。
registerClassToBeUsed 与 registerClassesToBeUsed
注册你将要进行序列化的类。
如果不注册,XBlink是可以正常工作的,不过生成的XML会带有一部分类信息,看上去会不那么自然(怎么个不自然法你试一试便知),所以想要XML更合适阅读,推荐在一个static块中一次性注册所有可能要用的类。
例如:
static {
// 注册一次即可
Class<?>[] clzs = { Person.class, PhoneNumber.class };
XBlink.registerClassesToBeUsed(clzs);
}
registerConverter
注册一个自定义转换器。
这个请参考后面的扩展点来理解。
XBConfig
提供了几个选项,可以设定你输出的文档一些特性。
newXBConfig
生成一个新的配置项。
setUseRelativePath
设置是否使用相对路径。默认是相对路径。
如果你序列化的类中存在循环引用的情况,那在写引用对象时,会输出类似下面这样一个节点。
<objA ref="../../objB/objA" />
ref记录的其相对当前节点的位置。
当然如果你设置使用绝对路径,那就会输入下面这样。
<objA ref="/objF/objE/objG/objB/objA" />
反正是可以帮你正确的找到引用对象的。
具体的实现思路可以看ME之前写的一篇文章。
setIgnoreTransient
是否忽略设置为transient类型的字段。
默认忽略,因为JAVA的序列化就是这样认为的。
忽略的意思就是序列化时无视它,不多解释了。
setIgnoreNull
是否忽略值为null的字段。
默认忽略,也就是不输出了,因为反序列化时它也是null,也不用设置回去。
当然如果你非要在XML显示的告诉你这里有个字段并且它是空,那你就设置一下好了。
setCompact
设置生成的文本是否采用紧凑模式。
默认为否,会采用更适合人类阅读的格式,也就是有换行,制表符等标识的文档。
如果设为true,那你就会得到仅一行的文档,当然它的体积会小很多,也会让反序列化更快,所以更适合用在生产环境中。
——————————————————
后续版本中这个类会提供更多的可配置项
XBlinkAlias
可以在类上或字段上设置别名。
至于效果直接看下面,事实胜于雄辩。
定义一个Child类:
@XBlinkAlias("孩子")
public class Child {
@XBlinkAlias("姓名")
private String name;
@XBlinkAlias("年龄")
private int age;
// 省略构造器与其他方法
}
测试用例:
Child child = new Child();
child.setName("Tom");
child.setAge(10);
System.out.println(XBlink.toXml(child));
结果:
<?xml version="1.0" encoding="UTF-8"?>
<孩子>
<姓名>Tom</姓名>
<年龄>10</年龄>
</孩子>
效果很好,有木有!
XBlinkOmitField
忽略的字段,在字段上设置后,序列化时就会无视他,不解释了。
XBlinkAsAttribute
这个应该是XML格式特有的,在一个节点上加上属性。
就用上面那个Child做例子。
修改下:
@XBlinkAlias("孩子")
public class Child {
@XBlinkAlias("姓名")
@XBlinkAsAttribute
private String name;
@XBlinkAlias("年龄")
private int age;
// 省略构造器与其他方法
}
还是那个测试用例,直接看结果:
<?xml version="1.0" encoding="UTF-8"?>
<孩子 姓名="Tom">
<年龄>10</年龄>
</孩子>
—————————邪恶的分割线———————
好了,只要你看懂了以上的内容,了解了这5个类的用法,XBlink在使用上90%的问题你已经可以自己解决了,是不是很简单很好用呢。
下面将讲解剩下的10%,也就是可以自由扩展的地方。
—————————邪恶的分割线———————
扩展API
一个注解类:XBlinkConverter.java
两个转换器基类:Converter.java SingleValueTypeConverter.java
XBlinkConverter
在字段上设置后,该字段在序列化时将采用你提供的转换器进行工作。
举个例子哈。
一个日期类型,默认的转换器,生成的格式是 yyyy-MM-dd HH:mm:ss
你希望能使用另一种格式,比如仅需要日期且年在最后位置,格式是MM-dd-yyyy
那么你就需要实现一个类,并且继承SingleValueTypeConverter
例如下面这样:
/**
* 测试用的一个java.util.Date类型转换器。
*
* @author 胖五(pangwu86@gmail.com)
*/
public class MyDateConverter extends SingleValueTypeConverter {
private static final String DATA_FORMAT_TEMPLATE = "MM-dd-yyyy";
public Class<?>[] getTypes() {
return new Class<?>[] { Date.class };
}
public boolean canConvert(Class<?> type) {
return Date.class == type;
}
public String obj2Text(Object obj) throws Exception {
SimpleDateFormat dateFormat = new SimpleDateFormat(DATA_FORMAT_TEMPLATE);
return dateFormat.format(obj);
}
public Object text2Obj(String text) throws Exception {
SimpleDateFormat dateFormat = new SimpleDateFormat(DATA_FORMAT_TEMPLATE);
return dateFormat.parseObject(text);
}
}
这样要说下前面的XBlink.registerConverter这个方法。
如果你仅仅想在某个日期上使用自定义格式,那么就加注解就可以了
如果你觉得默认的你想替换掉,所有有日期的地方都用你的格式,那就调用XBlink.registerConverter,它会根据替换掉默认实现。
也就是一个控制局部,一个控制全局,任君调遣。
Converter 与 SingleValueTypeConverter
这两个类,你简单看下估计就会明白了。
/**
* 转换器,提供对象<--->文字相互转换的功能。
*
* 注意,这里只负责两者的转换,不要加入输出等操作。
*
* @author 胖五(pangwu86@gmail.com)
*/
public interface Converter {
/**
* 返回当前转换器可以处理的对象类型。
*
* @return class对象
*/
public Class<?>[] getTypes();
/**
* 是否可以转换这种类型。
*
* @param type
* 类类型
* @return 能否成功
*/
public boolean canConvert(Class<?> type);
/**
* 是单值类型吗?
*
* @return 判断结果
*/
public boolean isSingleValueType();
/**
* 将对象转换为文字格式的值。
*
* @param obj
* 转换对象
* @throws Exception
* 异常
* @return 字符结果
*/
public String obj2Text(Object obj) throws Exception;
/**
* 将文字格式的值转换为对象。
*
* @param text
* 文字格式的值
* @throws Exception
* 异常
* @return 对象
*/
public Object text2Obj(String text) throws Exception;
}
/**
* 单值类型的共同基类。
*
* @author 胖五(pangwu86@gmail.com)
*/
public abstract class SingleValueTypeConverter implements Converter {
public boolean isSingleValueType() {
return true;
}
}
再结合下上面的MyDateConverter,相信你一定明白它的作用。
其实本来还提供一个FormValueTypeConverter类,也就是说可以在里面设置格式的转换器,这个更强大,但也更加难以控制,所以当前版本并没有开放出来,等后续版本有了好的解决方案再开放给大家。
—————————邪恶的分割线———————
以上就是ME现在能想到的基本用法了,基本上遵循着简单易用的原则来搞的,希望大家喜欢。
还有就是什么对象可以进行序列化,由于时间紧,默认提供的转换器还不够全面,所以有些类型会报错,不过如果你看懂了上面的自定义转换器这节,相信你可以自己解决的。
目前的版本,可以序列化java中常见的类(String,Date等),八种基本类型,枚举类型,一维数组(多维暂时不支持),List,Set,Map。
也就是说对简单的应用应该是富富有余了。
其他的想起什么再补充吧,欢迎提问或提出意见。
分享到:
相关推荐
* XBlink最NB的反序列方法,生成你需要的对象。 * * * 根据docTypeName与其格式特点,进行反序列化生成对象。 * * @param cs * 字符信息 * @param docTypeName * 任意你想要的文档格式...
NULL 博文链接:https://pangwu86.iteye.com/blog/893887
华中科技大学电信专业 课程资料 作业 代码 实验报告-数据结构-内含源码和说明书.zip
java 制作游戏 飞翔的小鸟
Python库是一组预先编写的代码模块,旨在帮助开发者实现特定的编程任务,无需从零开始编写代码。这些库可以包括各种功能,如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库,如NumPy、Pandas和Requests,极大地丰富了Python的应用领域,从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径,而且为经验丰富的开发者提供了强大的工具,以高效率、高质量地完成复杂任务。例如,Matplotlib和Seaborn库在数据可视化领域内非常受欢迎,它们提供了广泛的工具和技术,可以创建高度定制化的图表和图形,帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。
适用数据结构课程,大学生必备资源。 ALGraphAlgo.h 定义了图数据结构相关的函数,包括无向图的创建、获取顶点数据、邻接边及遍历操作。 ALGraphDef.h 定义了图的邻接列表数据结构,包括顶点、边的结构体和图的数据结构,以及队列结构。 pubuse.h 包含基本的标准库导入,定义了布尔常量、枚举和类型别名,用于项目中的通用操作。 ALGraphUse.cpp 实现了一个交互式应用,允许用户创建、探索并遍历图,使用了上述头文件中定义的数据结构和函数。 整个程序的功能是:提供一个基于命令行的图形数据结构交互式工具,用户可以创建无向图,查询顶点信息和邻接边,并进行深度优先和广度优先遍历。 这些文件整体上构成了一个C++实现的图数据结构库,包含图的定义、算法实现以及一个示例应用,让用户能够创建、操作和遍历无向图。
JAVA+SQL离散数学题库管理系统是一个用Java编程语言和SQL数据库管理系统构建的应用程序,旨在帮助用户管理离散数学题库。该系统主要包括以下功能: 题库管理:允许用户添加、编辑、删除离散数学题目,包括题目内容、选项、答案等信息。用户可以根据需要对题目进行分类、标记或搜索。 用户管理:支持用户注册、登录、注销等功能,保障系统安全性和个性化服务。管理员可以管理用户权限,如分配不同的角色和权限。 练习和测试:用户可以通过系统进行练习和测试,选择特定题目或随机生成题目进行答题。系统会自动批改答案并记录用户的答题历史和成绩。 数据统计和分析:系统可以对用户的答题情况进行统计和分析,包括答题时间、正确率、题目难度等,帮助用户了解自己的学习情况并进行有效的学习计划。 系统设置:提供系统参数设置、题目难度调整、数据备份等功能,保障系统稳定运行和数据安全。 通过以上功能,JAVA+SQL离散数学题库管理系统能够有效地帮助用户管理离散数学学习过程中的题目资源,提高学习效率和成绩。
【资源说明】 毕业设计 基于Python+Django+itemCF和userCF算法音乐推荐系统源码+详细文档+全部数据资料 高分项目 【备注】 1、该项目是高分毕业设计项目源码,已获导师指导认可通过,答辩评审分达到95分 2、该资源内项目代码都经过测试运行成功,功能ok的情况下才上传的,请放心下载使用! 3、本项目适合计算机相关专业(如软件工程、计科、人工智能、通信工程、自动化、电子信息等)的在校学生、老师或者企业员工下载使用,也可作为毕业设计、课程设计、作业、项目初期立项演示等,当然也适合小白学习进阶。 4、如果基础还行,可以在此代码基础上进行修改,以实现其他功能,也可直接用于毕设、课设、作业等。 欢迎下载,沟通交流,互相学习,共同进步!
Python库是一组预先编写的代码模块,旨在帮助开发者实现特定的编程任务,无需从零开始编写代码。这些库可以包括各种功能,如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库,如NumPy、Pandas和Requests,极大地丰富了Python的应用领域,从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径,而且为经验丰富的开发者提供了强大的工具,以高效率、高质量地完成复杂任务。例如,Matplotlib和Seaborn库在数据可视化领域内非常受欢迎,它们提供了广泛的工具和技术,可以创建高度定制化的图表和图形,帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。
概要:本研究基于Hadoop平台对决策树分类算法进行了并行化处理,旨在提高计算效率和扩展性。通过引入MapReduce编程模型,实现了在大规模数据集上的高效处理,显著提升了分类效率。 适用人群:本资源适用于数据科学家、机器学习工程师和对大数据处理有需求的专业人士。同时,也适合对并行算法和分布式计算感兴趣的学术研究者。 使用场景及目标:该资源可应用于大规模数据集上的决策树分类任务,如广告点击率预测、电子商务用户行为分析等领域。通过并行化处理,可以提高分类效率,加快模型训练速度,提升算法性能和准确度。 其他说明:本研究提供了基于Hadoop的决策树分类算法并行化处理的解决方案,适合于需要在大数据环境下进行机器学习任务的应用场景。通过利用分布式存储和计算框架,可以有效地处理大规模数据集,提高算法的实时性和准确性。欢迎对大数据处理和机器学习算法优化感兴趣的专业人士和研究者使用并参考该资源。
Python库是一组预先编写的代码模块,旨在帮助开发者实现特定的编程任务,无需从零开始编写代码。这些库可以包括各种功能,如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库,如NumPy、Pandas和Requests,极大地丰富了Python的应用领域,从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径,而且为经验丰富的开发者提供了强大的工具,以高效率、高质量地完成复杂任务。例如,Matplotlib和Seaborn库在数据可视化领域内非常受欢迎,它们提供了广泛的工具和技术,可以创建高度定制化的图表和图形,帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。
Python库是一组预先编写的代码模块,旨在帮助开发者实现特定的编程任务,无需从零开始编写代码。这些库可以包括各种功能,如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库,如NumPy、Pandas和Requests,极大地丰富了Python的应用领域,从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径,而且为经验丰富的开发者提供了强大的工具,以高效率、高质量地完成复杂任务。例如,Matplotlib和Seaborn库在数据可视化领域内非常受欢迎,它们提供了广泛的工具和技术,可以创建高度定制化的图表和图形,帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。
这是符合GB-7714-2015 Zoetro的csl文件,使用该标准的学校可以使用此csl撰写毕业论文,Zoetro的使用请查询其他博客,本人免费分享,若发现无法下载可以联系本人邮箱。
Python库是一组预先编写的代码模块,旨在帮助开发者实现特定的编程任务,无需从零开始编写代码。这些库可以包括各种功能,如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库,如NumPy、Pandas和Requests,极大地丰富了Python的应用领域,从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径,而且为经验丰富的开发者提供了强大的工具,以高效率、高质量地完成复杂任务。例如,Matplotlib和Seaborn库在数据可视化领域内非常受欢迎,它们提供了广泛的工具和技术,可以创建高度定制化的图表和图形,帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。
私信博主免费获取真题解析以及代码
PySide6:PySide6 是 Qt for Python 的官方绑定,提供了创建图形用户界面所需的所有工具和类。 YOLO 模型:选择一个 YOLO 版本(如 YOLOv3、YOLOv4 或 YOLOv5),并使用预训练的模型或自己训练的模型。 项目结构:设计应用程序的布局,包括菜单栏、工具栏、状态栏以及用于显示视频流和检测结果的窗口。 视频流处理:集成摄像头或视频文件,使用 YOLO 模型进行实时目标检测,并更新GUI以显示带有边界框的图像。 GUI 组件: 播放控制:开始、停止、暂停按钮。 参数调整:允许用户更改 YOLO 模型的参数,如置信度阈值、非极大值抑制(NMS)阈值等。 模型选择:如果支持多个模型,允许用户选择不同的 YOLO 模型。 线程处理:为了不阻塞 GUI,将视频处理和 YOLO 检测放在单独的线程中。 错误处理:确保应用程序能够处理各种潜在错误,如模型加载失败、视频流中断等。 用户文档:提供用户指南或文档,说明如何使用应用程序,包括如何配置和运行检测。 部署:使用 PyInstaller 或其他工具将应用程序打包,以便在没有 Python
随着社会互联网技术的快速发展,每个行业都在努力与现代先进技术接轨,通过科技手段提高自身的优势;对于在线动漫信息平台当然也不能排除在外,随着网络技术的不断成熟,带动了在线动漫信息平台,它彻底改变了过去传统的管理方式,不仅使服务管理难度变低了,还提升了管理的灵活性。这种个性化的平台特别注重交互协调与管理的相互配合,激发了管理人员的创造性与主动性,对在线动漫信息平台而言非常有利。 本系统采用的数据库是Mysql,使用Spring Boot框架开发,Java语言、B/C架构。在设计过程中,充分保证了系统代码的良好可读性、实用性、易扩展性、通用性、便于后期维护、操作方便以及页面简洁等特点。
图王输入法自动切换, ACAD2010~2025命令永行远是英文状态, 免除输入命令时中文干扰
母亲节快乐python14-条件判断结合比较运算符.ev4.rar
Python库是一组预先编写的代码模块,旨在帮助开发者实现特定的编程任务,无需从零开始编写代码。这些库可以包括各种功能,如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库,如NumPy、Pandas和Requests,极大地丰富了Python的应用领域,从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径,而且为经验丰富的开发者提供了强大的工具,以高效率、高质量地完成复杂任务。例如,Matplotlib和Seaborn库在数据可视化领域内非常受欢迎,它们提供了广泛的工具和技术,可以创建高度定制化的图表和图形,帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。