[NewLife.XCode]导入导出(实体对象百变魔君)

摘要:
NewLife。XCode是一个开源数据中间件,已有10多年的历史。它支持nfx/netcore,并由New Life团队(以下简称XCode)开发和维护。NewLife。Redis优先支持IAccessor接口。因此,在将XCode实体对象写入Redis时,使用二进制高效压缩格式,而不是默认的Json格式。系列教程NewLife。XCode教程系列〔2019版〕添加、删除、修改和查询简介。

NewLife.XCode是一个有10多年历史的开源数据中间件,支持nfx/netcore,由新生命团队(2002~2019)开发完成并维护至今,以下简称XCode。

整个系列教程会大量结合示例代码和运行日志来进行深入分析,蕴含多年开发经验于其中,代表作有百亿级大数据实时计算项目。

开源地址:https://github.com/NewLifeX/X(求star, 864+)

XCode是充血模型,在实体类上附带有大量便捷操作,其中就包括各种目标数据类型的导入导出!

Json序列化

当下最常用的数据通信格式毋容置疑肯定是Json,实体对象可直接转Json作为接口返回值。

下面看看一个普通Role实体对象的Json序列化(ToJson)和Json反序列化(ToJsonEntity)的例程和效果。

[NewLife.XCode]导入导出(实体对象百变魔君)第1张

如上,Role实体对象可通过ToJson转为json字符串,并通过ToJsonEntity把字符串转为另一个Role实体对象。

在XCode v9.0之前,实体基类Entity直接带有ToJson/FromJson。后来因为Json实在太常用了,提升为全局扩展方法。

Json作为最通用的数据传输格式(没有之一),ToJson直接扩展Object,有三个参数:是否换行缩进、是否写空值、是否驼峰命名

[NewLife.XCode]导入导出(实体对象百变魔君)第2张

上文示例中的ToJson(true, false, false)表示采用换行缩进(可读性更好),不写空值(整数的0和字符串的null等),不适用驼峰命名。

Xml序列化

Xml作为曾经的数据传输格式之王,仍然有相当一部分古老接口使用。

[NewLife.XCode]导入导出(实体对象百变魔君)第3张

ToXml/ToXmlEntity也是全局扩展方法,其中参数可以控制序列化为普通Xml或者Xml属性。

从结果来看,Xml可读性非常好,但是占用空间很大,一般比Json还要大一截。

二进制序列化

XCode序列化的绝招是二进制序列化,能够让实体对象和二进制数据互相转换,更小、更快!

[NewLife.XCode]导入导出(实体对象百变魔君)第4张

序列化同样的实体对象,只需要39字节,远小于Json和Xml,并且速度更快(不需要字符串分割操作)。

实体对象没有ToBinary之类的快速方法,而是需要先转化为IAccessor接口,然后Write序列化为数据流,或者Read读取数据流。

数据流是个好东西,最常用的有内存流、文件流、网络流、加密流、压缩流,等等等。

文件流FileStream,可以让实体对象保存为文件,或者文件加载为实体对象,(借助文件缓存实体数据?);

网络流NetworkStream,可以让实体对象在网络中传输;

IAccessor访问器接口,可实现任意对象到数据流的读写访问。

NewLife.Redis优先支持IAccessor接口,因此,把XCode实体对象写入Redis时,采用的是二进制高效精简格式,而不是默认的Json格式

实体类可通过重载 OnWrite来自定义二进制序列化的行为。

/// <summary>二进制序列化到数据流</summary>
/// <param name="stream">数据流</param>
/// <param name="context">上下文</param>
/// <param name="extend">是否序列化扩展属性</param>
protected virtualBoolean OnWrite(Stream stream, Object context, Boolean extend)
{
    var bn = context asBinary;
    if (bn == null) bn = newBinary
    {
        Stream =stream,
        EncodeInt = true
    };
    var fs = extend ?Meta.AllFields : Meta.Fields;
    foreach (var fi infs)
    {
        bn.Write(this[fi.Name], fi.Type);
    }
    return true;
}

从上面代码可以看出,只是调用二进制序列化Binary来把各个数据字段写入流中。

看到这里,你是不是有很多可以大干一场的想法?别急,这只是开胃菜,还有更好的。

示例中看到,二进制序列化最大缺点是可读性极差!一般只能看到其中部分字符串。

实体列表存储

单个实体对象的二进制序列化只适用于简单场合,如写入Redis,实际工程级应用,多以实体列表为主。

实体列表存储以扩展方法提供:

  • Write,写入实体列表到数据流
  • Read,从数据流加载实体列表
  • SaveFile,保存实体列表到文件(可用作数据缓存)
  • LoadFile,从文件加载实体列表

[NewLife.XCode]导入导出(实体对象百变魔君)第5张

以上示例演示了具有4个对象的角色列表如果读写数据流以及文件。

有朋友要问,能否借助实体列表读写文件的功能,实现某些数据表的本地化缓存,即使数据库宕机,仍然能够继续提供服务?

答案显然是可以的,并且我在实际工作中也经常这么干。

数据分析中经常需要用到几十上百台服务器进行分析计算,应用启动时必须把配置数据和常用基础数据一次性载入内存,例如几万行的网点数据;

如果几十个节点同时启动向数据库请求网点数据,数据库将不堪重负变得非常缓慢,影响计算应用的加载甚至可能导致出错退出;

这种场景,可以在加载一次后,把实体列表数据保存到本地文件中,然后定时(10分钟)更新;

下次启动时,直接使用本地缓存数据,大大提升了应用启动速度,并且降低了数据库负担;

Csv导入导出

Csv格式常用于办公室Excel数据传递,以及数据库数据导入导出等。

[NewLife.XCode]导入导出(实体对象百变魔君)第6张

[NewLife.XCode]导入导出(实体对象百变魔君)第7张

[NewLife.XCode]导入导出(实体对象百变魔君)第8张

XCode支持百万级导出!内部CsvFile支持流式读写,一边构造一边写入文件,而不是一次性在内存生成好再写入!

魔方的 Excel导出、Csv导出、Json导出、Xml导出等功能,都由 XCode实现!

系列教程

NewLife.XCode教程系列[2019版]

  1. 增删改查入门。快速展现用法,代码配置连接字符串
  2. 数据模型文件。建立表格字段和索引,名字以及数据类型规范,推荐字段(时间,用户,IP)
  3. 实体类详解。数据类业务类,泛型基类,接口
  4. 功能设置。连接字符串,调试开关,SQL日志,慢日志,参数化,执行超时。代码与配置文件设置,连接字符串局部设置
  5. 反向工程。自动建立数据库数据表
  6. 数据初始化。InitData写入初始化数据
  7. 高级增删改。重载拦截,自增字段,Valid验证,实体模型(时间,用户,IP)
  8. 脏数据。如何产生,怎么利用
  9. 增量累加。高并发统计
  10. 事务处理。单表和多表,不同连接,多种写法
  11. 扩展属性。多表关联,Map映射
  12. 高级查询。复杂条件,分页,自定义扩展FieldItem,查总记录数,查汇总统计
  13. 数据层缓存。Sql缓存,更新机制
  14. 实体缓存。全表整理缓存,更新机制
  15. 对象缓存。字典缓存,适用用户等数据较多场景。
  16. 百亿级性能。字段精炼,索引完备,合理查询,充分利用缓存
  17. 实体工厂。元数据,通用处理程序
  18. 角色权限。Membership
  19. 导入导出。Xml,Json,二进制,网络或文件
  20. 分表分库。常见拆分逻辑
  21. 高级统计。聚合统计,分组统计
  22. 批量写入。批量插入,批量Upsert,异步保存
  23. 实体队列。写入级缓存,提升性能。
  24. 备份同步。备份数据,恢复数据,同步数据
  25. 数据服务。提供RPC接口服务,远程执行查询,例如SQLite网络版
  26. 大数据分析。ETL抽取,调度计算处理,结果持久化

免责声明:文章转载自《[NewLife.XCode]导入导出(实体对象百变魔君)》仅用于学习参考。如对内容有疑问,请及时联系本站处理。

上篇pycharm 常用设置[洛谷P3321][SDOI2015]序列统计下篇

宿迁高防,2C2G15M,22元/月;香港BGP,2C5G5M,25元/月 雨云优惠码:MjYwNzM=

相关文章

关于H5本部缓存localStorage,sessionStorage

HTML5 提供了两种在客户端存储数据的新方法: localStorage - 没有时间限制的数据存储 一直存在除非用户手动清除缓存;是基于域的,任何该域下的所有页面都可访问localStorage sessionStorage - 针对一个 session 的数据存储 浏览器关闭时清除 之前,这些都是由 cookie 完成的。但是 cookie 不适...

js使用toFixed遇到的问题以及由此引发的小数精度问题

原文链接: https://www.cnblogs.com/yalong/p/15762637.html 项目中使用 toFixed 出现的问题: 一. js报错 Uncaught SyntaxError: Invalid or unexpected token 如下图所示: 就是说对 整数 和 字符串 使用toFixed() 会报错 二. 四舍五入不...

关于Intege.valueOf()的使用

原文链接:https://blog.csdn.net/weixin_37650458/article/details/85212730 1.Integer. valueOf()方法的作用     Integer. valueOf()可以将基本类型int转换为包装类型Integer,或者将String转换成Integer,String如果为Null或“”都会...

VUE 页面缓存2

=============================转载================================== 每天进步一点点~~~ 第一步 在app中设置需要缓存的div //缓存的页面 1 <keep-alive> 2 <router-view v-if="$route.meta.keepAlive">&...

web.config中httpRunTime的属性

配置httpRuntime也可以让FileUpload上传更大的文件,不过设置太大了会因用户将大量文件传递到该服务器而导致的拒绝服务攻击(属性有说明) <httpRuntime> <httpRuntime useFullyQualifiedRedirectUrl="true|false"              maxRequestLe...

java中表示二进制、八进制、十进制、十六进制

1.进制   进制是一种记数方式 ,可以用有限的数字符号代表所有的数值。由特定的数值组成。 2.进制的表现形式     二进制: 由0和1两个数字组成。  八进制: 由0-7数字组成,为了区分与其他进制的数字区别,开头都是以0开始。  十进制: 都是以0-9这九个数字组成,不能以0开头。   十六进制:由0-9和A-F组成。为了区分于其他数字的区别,开头都...