文档章节

Protostuff 介绍

yaukie
 yaukie
发布于 2016/09/30 11:43
字数 880
阅读 187
收藏 0

1 简介**

Protostuff是一个开源的、基于Java语言的序列化库,
它内建支持向前向后兼容(模式演进)和验证功能。
Protostuff支持的序列化格式包括:
protobuf protostuff graph 即序列化对象图,即带循环引用的protostuff。
详见:http://www.protostuff.io/documentation/object-graphs/
json smile 即二进制json,从protostuff-json模块中使用。Smile数据格式是由Jackson
JSON库开发团队于2010年发布的数据格式,并在Jackson 6版本开始使用此格式。
Smile格式规范:http://wiki.fasterxml.com/SmileFormatSpec
与此相似的有BSON格式,见:http://bsonspec.org/
要注意一点,Smile数据格式和BSON数据格式是互不兼容的。比如BSON定义了日期类型,
而Smile没有日期类型。而且,有时候BSON数据格式占用的空间比原生JSON占用的空间更多。
所以,对于二进制JSON来说,Smile才是更好的选择。
可以参考通用二进制JSON规范《Universal Binary JSON Specification》:http://ubjson.org/
xml yaml 只支持序列化 kvp 即二进制的uwsgi头部(Header),详见:http://projects.unbit.it/uwsgi
2 特征
1、支持protostuff-compiler产生的消息
2、支持现有的POJO
3、支持现有的protoc产生的Java消息
4、与各种移动平台的互操作能力(Android、Kindle、j2me)
5、支持转码
3 模块
3.1 protostuff-api模块
面向消息和POJO(message/pojo)的序列化API,内建了对模式演进的支持。
可以与现有对象一起工作,只需添加模式Schema。可以通过代码生成、
在运行时使用protostuff-runtime生成、或者是手写产生。
3.2 protostuff-core模块
绑定了三种二进制格式:protostuff、graph、protobuf。
protostuff与protobuf的区别:
1)protobuf有一个名为“group”的编码类型域,而protostuff使用它作为嵌套的消息。
2)protostuff可以使用尾部界定符来处理消息流(Stream)。
3)protostuff的一级类在本地格式中支持循环引用。
3、protostuff-runtime模块
自动启用现有的POJO序列化/反序列化为各种格式。
可使用运行时序列化策略,w/c通过系统属性进行配置。
依赖于protostuff-API和protostuff-collectionschema。
3.3 protostuff-json模块
面向消息或POJO的JSON序列化/反序列化。
面向标量域的向前向后兼容。
依赖于protostuff-api、jackson-core-asl-7.9。如果使用了Smile格式,还需jackson-smile-7.9。
3.4 protostuff-parser模块
使用了ANTLR V3、面向.proto文件的词法/语法解析器。
供protostuff-compiler使用。
3.5 protostuff-compiler模块
面向.proto源文件的编译器。
可以从文件系统、类路径或从网络HTTP URL中载入.proto源文件。
可使用参数-Dproto_path=$path告诉编译器从哪里载入源文件。
可扩展/定制编译的输出。
要编译源文件,执行命令:
java -jar protostuff-compiler-0.9.jar
protostuff.properties属性文件定义:
modules = foo
foo.source = path/to/your/foo.proto
foo.output = java_bean
foo.outputDir = generated
foo.options = some_key,key:value,another_key
依赖于protostuff-parser模块。
7、protostuff-me模块
对于j2me应用,无需外部依赖
与api模块和core模块结合一起使用,去掉了Java泛型支持。
4 模式
Schema包含:
1)对象进行序列化的逻辑
2)对象进行反序列化的逻辑
3)对象必填字段的验证
4)对象字段名称到字段编号的映射
5)对象的实例化
对于现有的对象,必须使用protostuff-runtime来生成Schema——可以通过反射来缓存、使用Schema。
开发者更喜欢自定义Schema,比如对必填字段的验证等,那么可以手动编码

© 著作权归作者所有

共有 人打赏支持
yaukie
粉丝 2
博文 30
码字总数 34133
作品 0
济南
程序员
私信 提问
简单 Netty RPC 框架--snrpc

snrpc 是一个简单的 Netty RPC 框架,使用 protostuff 1.07 作为序列化工具,使用 Netty-3.2.1 作为 NIO。 使用方式: 比如: 1. server class; interface and implementor // define an in...

stefanzhlg
2014/11/20
2.5K
0
几种 Java 序列化方案的性能比较

来源:https://github.com/eishay/jvm-serializers/wiki 比较结果: create ser deser total size +dfljava-built-in 62 5608 29649 35257 889 514hessian 65 3812 6708 10519 501 31......

红薯
2013/03/04
17.5K
4
一个基于Netty的RPC框架

利用netty写了一个简单的RPC框架,纯粹是为了理解RPC框架。 使用protostuff 1.07 序列化,以netty 3.2.1 网络框架。 下载地址:https://github.com/stefzhlg/snrpc ##How to use e.g. 1,ser...

stefanzhlg
2014/12/05
0
2
序列化框架比较:kryo & hessian & Protostuff & java

序列化框架性能对比(kryo、hessian、java、protostuff) 简介: 优点 缺点 Kryo 速度快,序列化后体积小 跨语言支持较复杂 Hessian 默认支持跨语言 较慢 Protostuff 速度快,基于protobuf ...

鉴客
2013/03/04
10.6K
0
各种 Java 的序列化库的性能比较测试结果

免责声明 本次测试专注于 cyclefree 数据结构的编码和解码。一些序列化程序支持循环检测/对象共享,一些序列化程序两种模型都支持,一些序列化程序包括了元数据,一些则没有,有的是跨平台的...

孔小菜
2015/06/02
5K
4

没有更多内容

加载失败,请刷新页面

加载更多

OSChina 周二乱弹 —— 哥们之间报恩的想法被上帝实现了

Osc乱弹歌单(2018)请戳(这里) 【今日歌曲】 小小编辑:推荐歌曲《消愁》 《消愁》- 毛不易 手机党少年们想听歌,请使劲儿戳(这里) @过遥 :周一的早上就应该用来补觉,太困了 周末不想...

小小编辑
9分钟前
8
1
MariaDB 服务器在 MySQL Workbench 备份数据的时候出错如何解决

服务器是运行在 MariaDB 10.2 上面的,在使用 MySQL Workbench 出现错误: mysqldump: Couldn't execute 'SELECT COLUMN_NAME, JSON_EXTRACT(HISTOGRAM, '$."number-of-buckets-specified"'......

honeymose
今天
3
0
apache顶级项目(二) - B~C

apache顶级项目(二) - B~C https://www.apache.org/ Bahir Apache Bahir provides extensions to multiple distributed analytic platforms, extending their reach with a diversity of s......

晨猫
今天
7
0
day152-2018-11-19-英语流利阅读

“超级食物”竟然是营销噱头? Daniel 2018-11-19 1.今日导读 近几年来,超级食物 superfoods 开始逐渐走红。不难发现,越来越多的轻食餐厅也在不断推出以超级食物为主打食材的健康料理,像是...

飞鱼说编程
今天
18
1
SpringBoot源码:启动过程分析(二)

接着上篇继续分析 SpringBoot 的启动过程。 SpringBoot的版本为:2.1.0 release,最新版本。 一.时序图 一样的,我们先把时序图贴上来,方便理解: 二.源码分析 回顾一下,前面我们分析到了下...

Jacktanger
昨天
4
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部