Protobuf在Android上面的应用

背景

平时移动端和端之间的数据传输基本都是用的json或者xml,对于Protobuf之前一直有听说过,相比于json和xml有诸多好处,例如数据量小,序列化和反序列化速度快等,所以我们也来尝试一下Protobuf。

Quick Start

在系统的根目录的build.gradle中添加插件

dependencies {
        classpath 'com.google.protobuf:protobuf-gradle-plugin:0.8.2'
}
  • 踩坑tips
    这里有个坑,AndroidStudio3.0以上一定要采用0.8.2及以上的版本,否则编译阶段会报错

接下来是模块中的build.gradle的配置,首先添加插件

apply plugin: 'com.google.protobuf'

然后添加配置

android {
  protobuf {
        protoc {
            artifact = 'com.google.protobuf:protoc:3.0.0'
        }
        plugins {
            javalite {
                artifact = 'com.google.protobuf:protoc-gen-javalite:3.0.0'
            }
        }

        generateProtoTasks {
            all().each { task ->
                task.builtins {
                    remove java
                }
                task.builtins {
                    java { }
                    cpp { }
                }
            }
        }
    }
}

还有一个代码目录的配置

sourceSets {
        main {
            java {
                srcDir 'src/main/java'
            }
            proto {
                srcDir 'src/main/proto'
            }
        }
    }

我们的.proto文件就放在这个目录下就好了
最后添加依赖

compile 'com.google.protobuf:protobuf-java:3.5.1'
  • 踩坑tips
    这里也有个很有意思的问题,之前我用的是protobuf-lite版本
    compile "com.google.protobuf:protobuf-lite:3.0.0"
    然而当我使用的时候发现找不到proto实例转化为字节流的方法toByteArray()等方法,google了一下,也有不少人遇到同样的问题。最后通过这个问题的答案中找到灵感 protobuf找不到toByteArray()方法 应该是依赖有问题,然后就到了还是不要用精简版,最后问题解决。

至此,protobuf的运行环境已经完全搭建好了。网上有一些文章讲的是自己编译protobuf然后进行依赖,这种方式当然也可以,读者有兴趣的可以自行尝试。

Demo

那么该如何写呢,我们先来个最简单的Pojo类的例子。在上面定义好的proto目录下面创建一个.proto文件,内容如下

syntax = "proto3";
  option java_package = "com.xxx.xxx";
  option java_outer_classname = "BaseProto";

message Person {
    string name = 1;
    int32 id = 2;
    string email = 3;
    string phone = 4;
}

看起来还是比较容易理解的,如果上面环境搭建没有问题的话,同步一下项目之后,我们就会生成这个Person类了,下面以一个最简单的序列化和反序列化过程来说明一下这个类的使用方法

       try {
            BaseProto.Person.Builder builder = BaseProto.Person.newBuilder();
            builder.setEmail("xxxxx@qq.com");
            builder.setName("xx");
            builder.setId(1);
            builder.setPhone("13xxxxxxxxx");

            File file = new File(Environment.getExternalStorageDirectory() + 
                                 File.separator + "proto_persion");
            if(!file.exists()) {
                file.createNewFile();
            }
            //序列化
            FileOutputStream outputStream = new FileOutputStream(file);
            builder.build().writeTo(outputStream);
           
            //反序列化
            InputStream inputStream = new FileInputStream(file);
            BaseProto.Person person1 = BaseProto.Person.parseFrom(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }

BaseProto就是上面.proto中定义的java_outer_classnamePerson类通过构建者模式来完成实例化,可以通过writeTo(OutputStream output)方法来讲字节流写入到对应的文件,然后通过parseFrom即可完成反序列化,总得来说,用起来还是比较方便的。

后记

protobuf从一个google内部使用的工具,发展到今天,肯定还是有其可取的优点的。只不过现在泛用性肯定还是比不上json和xml,不过作为一个项目可优化的点,学习一下还是可以的。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,560评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,104评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,297评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,869评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,275评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,563评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,833评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,543评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,245评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,512评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,011评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,359评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,006评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,062评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,825评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,590评论 2 273
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,501评论 2 268

推荐阅读更多精彩内容