protobuf 编译和使用（C语言）

最新推荐文章于 2024-08-15 22:30:06 发布
最新推荐文章于 2024-08-15 22:30:06 发布
阅读量1.2w 收藏 57
点赞数 8
分类专栏： IOT 文章标签： c语言 java
原文链接：https://www.cnblogs.com/Anker/p/3416541.html
版权

protobuf编译和使用（C语言）

文章目录

前言

本文主要讲述linux下C语言使用protobuf相关说明

一、什么是Protobuf

XML和JSON是目前常用的数据交换格式，它们直接使用字段名称维护序列化后类实例中字段与数据之间的映射关系，一般用字符串的形式保存在序列化后的字节流中。消息和消息的定义相对独立，可读性较好。但序列化后的数据字节很大，序列化和反序列化的时间较长，数据传输效率不高。
Protobuf是Google提供一个具有高效的协议数据交换格式工具库，类似于JSON，Protobuf和XML、JSON序列化的方式不同，采用了二进制字节的序列化方式，用字段索引和字段类型通过算法计算得到字段之前的关系映射，从而达到更高的时间效率和空间效率，特别适合对数据大小和传输速率比较敏感的场合使用。

二、Protobuf有什么

Protobuf 提供了C++、java、python语言的支持（C需要protobuf-c），提供了windows(proto.exe)和linux平台可执行文件及源文件。Protobuf序列化数据时，常常需要一个proto文件，proto文件定义了协议数据中的数据结构，内容举例如下所示： 
syntax = "proto2";  // proto3 必须加此注解
message student
{
    required string id = 1;
    required string name = 2;
    required string gender = 3;
    required int32  age = 4;
    required string object = 5;
    required string home_address = 6;
    required string phone = 7;
}
  • 实体结构（message）: 代表了实体结构，由多个消息字段组成。
  • 消息字段（field）: 包括数据类型、字段名、字段规则、字段唯一标识、默认值
  • 数据类型：常见的原子类型都支持(在FieldDescriptor::kTypeToName中有定义)
  • 字段规则：(在FieldDescriptor::kLabelToName中定义)
    required：必须初始化字段，如果没有赋值，在数据序列化时会抛出异常
    optional：可选字段，可以不必初始化。
    repeated：数据可以重复(相当于java 中的Array或List)
    字段唯一标识：序列化和反序列化将会使用到。
  • 默认值：在定义消息字段时可以给出默认值。

三、如何编译

这里linux下C语言环境使用为例介绍。

3.1 protobuf编译安装

  1. 下载地址
    https://github.com/protocolbuffers/protobuf/releases
  2. 确认安装依赖库：automake ，autoconf ，libtool是否已经安装，未安装的需要安装
  3. 下载 protobuf 安装文件，这里下载protobuf-cpp-3.17.1.zip，解压
  4. 编译 (用于生成编译服务器下可执行程序)：
./autogen.sh
./configure --prefix=/XX/bin/protobuflib/
make
make install
  1. 交叉编译 (用于交叉编译protobuf-c时用到的依赖库)：
./autogen.sh
./configure --host=arm-linux CC=XX CXX=XX --prefix=/XX/bin/protobuflib/
make
make install
  1. 如果你使用的是Java或C++等，完成以上步骤就已经可以使用生成的protobuf可执行程序生产protobuf相关文件了。

3.2 protobuf-c编译安装

由于我的开发环境是linux C语言环境，protobuf仅支持C++，所以这里引入一个其他开源库protobuf-c，解决C语言的支持问题，编译protobuf-c前，需要编译及安装好protobuf。

  1. 下载地址
    https://codechina.csdn.net/mirrors/protobuf-c/protobuf-c/-/releases/v1.4.0?spm=1033.2243.3001.5876
  2. 确认安装依赖库：protobuf, 设置之前protobuf编译出的依赖库资源的环境变量：
PKG_CONFIG_PATH=/XX/bin/protobuflib/
export PKG_CONFIG_PATH
  1. 下载protobuf-c，这里下载protobuf-c-1.4.0.zip解压
  2. 编译 (用于生成编译服务器下可执行程序)：
./autogen.sh
./configure --prefix=/XX/bin/protobufc/
make
make install
  1. 交叉编译 (用于实际项目可执行程序的依赖库)：
./autogen.sh
./configure --host=arm-linux CC=XX CXX=XX --prefix=/XX/bin/protobufc/  
make
make install
  1. protobufc下生成的文件，即为编译生成的依赖库、protobuf-c可执行程序，使用protobuf-c可执行程序可以根据proto文件生成.c和.h文件

四、如何使用

编写一个学生信息的proto，proto文件内容如下所示：

syntax = "proto2";  // proto3 必须加此注解

message Student
{
    required string id = 1;
    required string name = 2;
    required string gender = 3;
    required int32  age = 4;
    required string object = 5;
    required string home_address = 6;
    required string phone = 7;
}

使用如下命令生成student.pb-c.c 和 student.pb-c.h文件。

protoc-c --c_cout=.  student.proto

编写测试程序：

#include <stdio.h>
#include <errno.h>
#include <stdlib.h>
#include <string.h>
#include "student.pb-c.h"

#define ID_LEN         11
#define NAME_LEN       32
#define GENDER_LEN     10
#define OBJECT_LEN     20
#define HOME_ADDR_LEN  96
#define PHONE_LEN      12

static int malloc_student_info(Student *stu)
{
    stu->id = (char*)malloc(ID_LEN);
    if (!stu->id)
    {
    	goto FAILED;
    }
    stu->name = (char*)malloc(NAME_LEN);
    if (!stu->name)
    {
	   	goto FAILED;
    }
    stu->gender = (char*)malloc(GENDER_LEN);
    if (!stu->gender)
    {
    	goto FAILED;
    }
    stu->object = (char*)malloc(OBJECT_LEN);
    if (!stu->object)
    {
    	goto FAILED;
    }
    stu->home_address = (char*)malloc(HOME_ADDR_LEN);
    if (!stu->home_address)
    {
    	goto FAILED;
    }
    stu->phone = (char*)malloc(PHONE_LEN);
    if (!stu->phone)
    {
    	goto FAILED;
    }
    return 0;
FAILED:
    fprintf(stdout, "malloc error.errno:%u,reason:%s\n",
        errno, strerror(errno));
    return -1;
}

static void free_student_info(Student *stu)
{
    if (stu->id)
    {
    	free(stu->id);
    	stu->id = NULL;
    }
    if (stu->name)
    {
    	free(stu->name);
    	stu->name = NULL;
    }
    if (stu->gender)
    {
    	free(stu->gender);
    	stu->gender = NULL;
    }
    if (stu->object)
    {
    	free(stu->object);
    	stu->object = NULL;
    }
    if (stu->home_address)
    {
    	free(stu->home_address);
    	stu->home_address = NULL;
    }
    if (stu->phone)
    {
    	free(stu->phone);
    	stu->phone = NULL;
    }
}

static void set_student_info(Student *stu)
{
    const char *id = "2013111011";
    const char *name = "Anker";
    const char *gender = "male";
    const char *object = "computer";
    const char *address = "shen zheng";
    const char *phone = "0102345678";

    strncpy(stu->id, id, ID_LEN);
    strncpy(stu->name, name, NAME_LEN);
    strncpy(stu->gender, gender, GENDER_LEN);
    stu->age = 23;
    strncpy(stu->object, object, OBJECT_LEN);
    strncpy(stu->home_address, address, HOME_ADDR_LEN);
    strncpy(stu->phone, phone, PHONE_LEN);
}

void print_student_info(Student *stu)
{
    printf("id: %s\n",stu->id);
    printf("name: %s\n",stu->name);
    printf("age: %d\n",stu->age);
    printf("gender:%s\n",stu->gender);
    printf("object: %s\n",stu->object);
    printf("home address: %s\n",stu->home_address);
    printf("phone: %s\n",stu->phone);
}

int main()
{
    Student stu = STUDENT__INIT;
    void *buf = NULL;
    unsigned int len ;
    Student *msg = NULL;

    if (malloc_student_info(&stu) == -1) {
        exit(0);
    }
    set_student_info(&stu);

    //get student packed size
    len = student__get_packed_size(&stu);
    printf("size of student info : %u\n",len);
    buf = malloc(len);
    //put student info pack to buf
    student__pack(&stu, buf);

    //unpack student info from buf
    msg = student__unpack(NULL, len, buf);
    print_student_info(msg);
    //free msg
    student__free_unpacked(msg, NULL);

    free(buf);
    free_student_info(&stu);

    return 0;
}

编译测试：

gcc student.pb-c.c main.c -o main -lprotobuf-c

测试结果：在这里插入图片描述

部分内容摘自以下网址：

http://www.cnblogs.com/dkblog/archive/2012/03/27/2419010.html
https://code.google.com/p/protobuf-c/wiki/Examples
https://www.cnblogs.com/Anker/p/3416541.html

monkeyPerry
关注
专栏目录
protobuf纯C语言实现
wzj_whut的专栏
01-27 1万+
protobuf官方版没有C语言实现, 只有C++的实现. 本文给出一种C语言的极简实现方案. 至于protobuf的编码协议, 读者自己去官方看吧, 不复杂. 一定要看懂, 否则怎么造轮子 无非就是 变长整数编码 TLV编码, 就是Type-Length-Value 以下是我制作的将proto文件转为c文件的代码生成器(Java实现). 以下是我造轮子的过程. 准备工作 下载protobuf源...
protobuf-c编译成c语言,protobuf工程的编译以及使用
weixin_31099497的博客
05-21 1291
一. 获取Protocol Buffer1.1 获得源码Git clone之：git clone https://github.com/google/protobuf.git本例选择从release下载3.7.0版本下载并解压到目录: D:\wzx\protobuf\protobuf-3.7.01.2 编译protoc.exe(Windows平台)准备工具: VS2017(包含C++模块)，提取码...
Protobuf协议C版本（Nanopb）使用方法
weixin_61470035的博客
08-03 539
protobuf协议需要一个.proto的文件，通过Nanopb中的protoc工具就可以根据这个.proto文件分别生成一个.c和.h文件，这样我们就可以在C中使用。（1）把下载的nanopb解压，protoc工具在其generator-bin文件夹中。（3）以上就完成了Nanopb的配置，下面我们演示如果用protoc工具生成.c和.h文件。下面是protoc工具的配置（把改工具的地址添加到环境变量中）点击”环境变量“，之后选中系统变量（S）中的Path,之后点击编辑，会打开。
【protobuf】ProtoBuf——快速上手protobuf、创建.proto文件、编译.proto文件、序列化与反序列化的使用
最新发布
Crocodile1006的博客
08-15 1340
ProtoBuf、快速上手protobuf、创建.proto文件、编译.proto文件、序列化与反序列化的使用
protobuf优缺点、编译与使用
qq_25359343的博客
08-01 4636
protof的描述 首先 protobuf是一个开源项目，是goole内部久经考验的一个东西。主要用于结构化数据串行化的灵活、高效、自动的方法，有如XML，不过他更小，更快，也更简单。你可以定义自己的数据结构，然后使用代码生成器生成的代码来读写这个数据结构。甚至可以在无需重新部署程序的情况下更新数据结构。 一、protobuf的优点： 1、性能好/效率高 时间开销： XML格式化（序列化）的开销还...
protobuf-c
04-24
protobuf-c-1.2.1.zip,C语言编写，可以应用到嵌入式不支持java的平台上，比较遵循Google 的原生态写法，跨平台选择此版本比较好
ProtoBuf编译及使用(2024年亲自测试过，不要拿我跟那些复制粘贴的老文档比)
jax_fanyang的博客
01-30 5645
不要下载官网最新源码，很多人直接按照readme来编译，很难一次性通过。如果直接拉github最新的源码。是没有autogen.sh或者configure文件的，当你跑去cmake里编译，他必然会提示各种变量未定义了，怎么都解决不了。以下我直说一种一定能成功的方法，不对其他版本的错误做特殊说明。
protobuf
HW的博客
08-08 2808
protobuf protobuf 优点 编译安装 syntax basic 字段修饰符 字段类型 varint message存储格式 生成代码 基类::google::protobuf::Message 序列化 反序列化 getter、setter - clear_field()：重置字段 - mutable_filed()：返回字段指针,用于修改 - filed_size(...
protobuf 编译
qq_22207951的博客
10-14 1458
protobuf的github的上下载对应的protobuf版本，我下载的是protobuf3.6.0的版本。然后解压，进入到根目录，执行编译指令： 可能需要安装的一些依赖项： sudo apt-get install autoconf sudo apt-get install automake sudo apt-get install libtool 执行编译指令： bash ./autogen.sh ./configure make -j4 ...
C/C++--ProtoBuf使用
weixin_66828150的博客
01-12 2437
对于使用了枚举类型的字段，包含设置和获取字段的方法，已经清空字段的方法clear_;以上三种序列化的方法没有本质区别，只是序列化之后输出的格式不同，可以提供不同场景使用，序列化的 API 函数均为const成员函数，因为序列化不会改变类对象的内容， 而是将序列化的结果保存到函数入参指定的地址中。上述的例子中，每个字段都有设置和获取的方法，getter 的名称与小写字段完全相同，setter 方法以 set_ 开头，每个字段都有一个clear_的方法，可以将字段设置为empty状态。编译该项目会出现异常。
protobuf编译和使用
08-02
protobuf的编译和使用可以根据不同的操作系统和编程语言环境进行。在Windows下，可以使用protoc.exe执行以下命令来编译protobuf文件： ``` protoc --cpp_out=. example.proto ``` 这将生成example.proto.h和example....
protobuf的c语言版本在嵌入式linux上的测试demo
07-21
移植并测试成功的protobuf在 嵌入式linux上的c语言版本，移植说明参照个人博客。这是一个测试成功的demo,附带makefile文件。
protobuf-c入门例子
06-25
http://blog.csdn.net/gongkongrs/article/details/34420947，在http://blog.csdn.net/menggucaoyuan/article/details/16107201的例子修改了Makefile以适应自己的环境
linux protobuf-c的使用，构建
10-20
安装protobuf ./configure --prefix=/usr/ make sudo make install /sbin/ldconfig -v 安装protobuf-c ./autogen.sh ./configure --prefix=/usr/ make sudo make install
protobuf编译，安装和简单使用文档
01-25
这个文档是我自己实践写的protobuf笔记，可以参考。。。
protobuf封装数据，C语言代码
04-18
接下来，我们可以使用protobuf编译器将.proto文件编译成C语言代码。在命令行中执行以下命令： ``` protoc --c_out=. person.proto ``` 执行上述命令后，会生成一个名为"person.pb-c.h"的头文件和一个名为"person....
C/C++编程：Protobuf 使用
热门推荐
OceanStar的博客
02-21 1万+
概述 前言 在移动互联网时代，手机流量、电量时最为有限的资源，而移动端的即使通讯应用无疑必须的直面这两点 解决流量过大的基本方法是使用高度压缩的通信协议，而数据压缩后流量减少带来的自然结果也就是省电：因为大数据量传输必然需要更久的网络操作、、数据序列化及反序列化操作，这些都是电量消耗过快的根源。 当前即时通讯应用中最热门的通信协议无疑就是Google的Protobuf了，相比于它的前辈xml、json，它的体量更小，解析速度更快，所以在 IM 这种通信应用中，非常适合将 Protobuf 作为数据传输格式
编译protobuf
m0_57370693的博客
07-12 277
编译protobuf遇到的坑（BSP开发）
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值