日本免费高清视频-国产福利视频导航-黄色在线播放国产-天天操天天操天天操天天操|www.shdianci.com

學(xué)無(wú)先后,達(dá)者為師

網(wǎng)站首頁(yè) 編程語(yǔ)言 正文

Android中Protobuf的基本使用介紹_Android

作者:靜水紅陽(yáng) ? 更新時(shí)間: 2022-04-10 編程語(yǔ)言

前言

Protobuf,類(lèi)似于json和xml,是一種序列化結(jié)構(gòu)數(shù)據(jù)機(jī)制,可以用于數(shù)據(jù)通訊等場(chǎng)景,相對(duì)于xml而言更小,相對(duì)于json而言解析更快,支持多語(yǔ)言。

一、Proto文件示例

Protobuf使用.proto文件來(lái)定義數(shù)據(jù)格式,所以我們首先新建立一個(gè)person.proto文件,并在文件中填下如下內(nèi)容:

//指定proto的版本為proto3,不寫(xiě)的話默認(rèn)為proto2.
syntax = "proto3";
//包名
package proto;
//引入包
//import "";
//指定生成類(lèi)所在的Java包名
option java_package = "com.example.demowork1";
//重命名,如果不寫(xiě),默認(rèn)為文件名的首字母大寫(xiě)轉(zhuǎn)化生成,如本文件如果不寫(xiě)則是Person
option java_outer_classname = "PersonProto";

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

這樣我們就定義好了一個(gè)基本的Person對(duì)象,下面我們對(duì)文件中的關(guān)鍵字進(jìn)行一一說(shuō)明:

**syntax:**指定proto的版本,protobuf目前有proto2和proto3兩個(gè)常用版本,如果沒(méi)有聲明,則默認(rèn)是proto2.

**package:**指定包名。

**import:**導(dǎo)入包,類(lèi)似于java的import.

**java_package:**指定生成類(lèi)所在的包名

**java_outer_classname:**定義當(dāng)前文件的類(lèi)名,如果沒(méi)有定義,則默認(rèn)為文件的首字母大寫(xiě)名稱(chēng)

**message:**定義類(lèi),類(lèi)似于java class;可以嵌套

**repeated:**字段可以有多個(gè)內(nèi)容(包括0),類(lèi)似于array

需要注意的是在聲明了屬性之后,需要對(duì)屬性聲明一個(gè)tag(示例代碼中的:1,2,3)。

這個(gè)tag是ProtoBuf編碼是使用來(lái)標(biāo)識(shí)屬性的,因此在定義了一個(gè)message的屬性之后,最好不要再去修改屬性的tag值以免造成舊數(shù)據(jù)解析錯(cuò)誤。

二、在Android中的使用

protobuf可以在Android中進(jìn)行使用,并且集成對(duì)應(yīng)的Gradle Plugin能夠快速的編譯proto文件。

其基本的編譯流程如下:

protobuf基本解析.png

下面我們直接使用上面的person.proto文件來(lái)舉例說(shuō)明。

1、 plugin配置

首先我們需要在工程目錄下的build.gradle文件中引入protobuf,示例代碼如下:

buildscript {
    ext.kotlin_version = "1.3.72"
    repositories {
        google()
        jcenter()
        maven { url "https://jitpack.io" }
        mavenCentral()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:4.1.0"
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
        classpath 'com.google.protobuf:protobuf-gradle-plugin:0.8.8'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

然后我們還需要在Module目錄下的build.gradle文件下添加配置,示例如下:

plugins {
  	...
    id 'com.google.protobuf'
}
android{
	...
        sourceSets {
        main {
            java.srcDirs = ['src/main/java']
            jniLibs.srcDirs = ['libs']
            assets.srcDirs = ['assets']

            proto {
                //指定proto文件位置,你的proto文件放置在此文件夾中
                srcDir 'src/main/proto'
            }
        }
    }
}
dependencies{
	...
	    implementation 'com.google.protobuf:protobuf-java:3.5.1'
    	implementation 'com.google.protobuf:protoc:3.5.1'
}
protobuf {
    protoc {
        artifact = 'com.google.protobuf:protoc:3.5.1' // 也可以配置本地編譯器路徑
    }

    generateProtoTasks {
        all().each { task ->
            task.builtins {
                remove java
            }
            task.builtins {
                java {}// 生產(chǎn)java源碼
            }
        }
    }
}

在完成了上述配置之后,執(zhí)行一下rebuild方法,這樣我們就能夠自動(dòng)生成proto java class文件了。

2.、基本調(diào)用

下面我們?cè)贛odule工程中調(diào)用一下我們生成的文件,我們先首先生成一個(gè)Person對(duì)象,然后把轉(zhuǎn)換的byte[]再解析一下查看結(jié)果是否正確,代碼如下:

        var person1 = PersonProto.Person.newBuilder().setName("Tom")
            .setId(111).setBoo(false).setEmail("123@123.com").setPhone("123456789")
            .build()
        tvData.setOnClickListener {
            var dataTemp = PersonProto.Person.parseFrom(person1.toByteArray())
            LogUtil.instance.d(dataTemp.toString())
//            mHandler.sendEmptyMessage(1)
        }

執(zhí)行運(yùn)行之后,我們能看到正確的輸出結(jié)果:

com.example.demowork1 D/message: name: "Tom"
    id: 111
    email: "123@123.com"
    phone: "123456789"

總結(jié)

原文鏈接:https://blog.csdn.net/cat_is_so_cute/article/details/122729234

欄目分類(lèi)
最近更新