当前位置: 首页 > news >正文

Proto文件相关知识

百度Apollo的数据结构常用proto文件来定义, proto文件允许你以类似于C++结构体或类的方式定义数据结构。你可以在这个文件中定义简单数据类型、枚举、消息类型等。

基于proto文件,Protocol Buffers编译器(protoc)可以自动生成对应的C++类。这些类提供了序列化和反序列化的方法,以及各种数据操作的方法。
本文是对proto用法的一些积累:


Protocol Buffers 的基本用法

  1. 定义数据结构(.proto 文件)

    你需要首先编写一个 .proto 文件,用于定义你的数据结构。例如,定义一个简单的 GraphNode

    syntax = "proto3";message Node {string lane_id = 1;string road_id = 2;// 其他字段...
    }message Graph {repeated Node node = 1;// 其他字段...
    }
    
    • syntax = "proto3"; 指定使用 Protocol Buffers 的第三个版本语法。
    • message 用于定义数据结构。
    • 每个字段都有一个唯一的编号(如 1, 2),用于在序列化时标识字段。
  2. 生成代码

    使用 protoc 编译器,根据 .proto 文件生成目标编程语言的代码。例如,生成 C++ 代码:

    protoc --cpp_out=. graph.proto
    

    这会生成相应的 .pb.h.pb.cc 文件,你可以在项目中包含并使用这些生成的类。

例如Apollo中的node_creator.h中,便引用了以下头文件:

#pragma once
#include <string>
#include "modules/map/proto/map_lane.pb.h"
#include "modules/routing/proto/routing_config.pb.h"
#include "modules/routing/proto/topo_graph.pb.h"
namespace apollo {
namespace routing {
namespace node_creator {
void GetPbNode(const hdmap::Lane& lane, const std::string& road_id,const RoutingConfig& routingconfig, Node* const node);
}  // namespace node_creator
}  // namespace routing
}  // namespace apollo
  1. 使用生成的类

    在代码中,你可以像使用普通类一样使用生成的 Protobuf 类。例如,使用 C++:

    #include "graph.pb.h"
    void Example() {Graph graph;Node* node = graph.add_node();node->set_lane_id("lane_123");node->set_road_id("road_456");// 设置其他字段...// 序列化为二进制std::string binary_data;graph.SerializeToString(&binary_data);// 反序列化Graph new_graph;new_graph.ParseFromString(binary_data);
    }
    

1proto文件中的关键字

在 Protocol Buffers(Protobuf)中,repeated 是一个关键字,用于定义一个可以包含零个或多个指定类型元素的字段。具体到您提到的 repeated Node node,它的含义如下:

repeated Node node 的含义

  • repeated:这是 Protobuf 中的一个修饰符,表示该字段可以出现多次,类似于数组、列表或集合。
  • Node:这是一个自定义的消息类型(即另一个 message 定义),表示每个元素的类型。
  • node:这是字段的名称,用于在代码中访问该字段。

示例 .proto 文件

以下是一个完整的 .proto 文件示例,展示了如何使用 repeated 关键字:

syntax = "proto3";message Node {string lane_id = 1;string road_id = 2;// 其他字段...
}message Graph {repeated Node node = 1; // 这是您提到的行// 其他字段...
}

repeated 字段的作用

使用 repeated 声明的字段允许在一个消息中包含多个相同类型的元素。在上述示例中,Graph 消息可以包含多个 Node 元素。这样设计的好处包括:

  1. 灵活性:可以根据需要添加任意数量的 Node 元素,而不需要预先定义具体的数量。
  2. 动态扩展:在序列化和反序列化过程中,Protobuf 会自动处理这些重复的元素,使得数据交换更加高效和简洁。

生成代码中的 repeated 字段

当使用 protoc 编译器根据 .proto 文件生成代码时,repeated 字段会生成一组专门的方法,用于操作这些重复的元素。以下以 C++ 为例,说明 repeated Node node 会生成哪些方法:

class Graph : public ::google::protobuf::Message {
public:// 获取 node 的数量int node_size() const;// 获取指定索引的 Nodeconst Node& node(int index) const;Node* mutable_node(int index);// 添加一个新的 NodeNode* add_node();// 获取所有 Node 的只读引用const ::google::protobuf::RepeatedPtrField<Node>& node() const;// 获取所有 Node 的可变引用::google::protobuf::RepeatedPtrField<Node>* mutable_node();// 清除所有 Nodevoid clear_node();// 其他 Protobuf 生成的方法...
};

各方法的作用

  1. int node_size() const;

    • 返回 node 字段中 Node 元素的数量。
  2. const Node& node(int index) const;

    • 返回指定索引处的 Node 元素的只读引用。
  3. Node* mutable_node(int index);

    • 返回指定索引处的 Node 元素的可变引用,允许修改该元素。
  4. Node* add_node();

    • node 字段末尾添加一个新的 Node 元素,并返回该新元素的可变引用。
  5. const ::google::protobuf::RepeatedPtrField<Node>& node() const;

    • 返回 node 字段中所有 Node 元素的只读引用,通常用于遍历。
  6. ::google::protobuf::RepeatedPtrField<Node>* mutable_node();

    • 返回 node 字段中所有 Node 元素的可变引用,允许批量修改。
  7. void clear_node();

    • 清除 node 字段中所有的 Node 元素。

使用示例

以下是一个使用生成的 Graph 类操作 repeated Node node 字段的示例:

#include "graph.pb.h" // 生成的 Protobuf 头文件void Example() {Graph graph;// 添加一个新的 NodeNode* node1 = graph.add_node();node1->set_lane_id("lane_123");node1->set_road_id("road_456");// 添加另一个 NodeNode* node2 = graph.add_node();node2->set_lane_id("lane_789");node2->set_road_id("road_012");// 获取 Node 的数量int count = graph.node_size();std::cout << "Number of nodes: " << count << std::endl;// 遍历所有 Nodefor (int i = 0; i < graph.node_size(); ++i) {const Node& node = graph.node(i);std::cout << "Node " << i << ": lane_id = " << node.lane_id()<< ", road_id = " << node.road_id() << std::endl;}// 清除所有 Nodegraph.clear_node();
}

总结

  • repeated 关键字:用于定义可以包含多个相同类型元素的字段,类似于数组或列表。
  • 自动生成的方法:Protobuf 根据 repeated 字段生成一系列方便操作的方法,如 add_node(), node_size(), node(int index) 等。
  • 灵活性和效率repeated 字段提供了高度的灵活性,允许动态添加和管理多个元素,同时保持高效的序列化和反序列化性能。

如果您有更多关于 Protobuf 或 repeated 字段的具体问题,请随时提问!

相关文章:

Proto文件相关知识

百度Apollo的数据结构常用proto文件来定义&#xff0c; proto文件允许你以类似于C结构体或类的方式定义数据结构。你可以在这个文件中定义简单数据类型、枚举、消息类型等。 基于proto文件&#xff0c;Protocol Buffers编译器&#xff08;protoc&#xff09;可以自动生成对应的…...

k8s的控制节点不能访问node节点容器的ip地址

master控制node服务器添加容器后,访问不了该node服务器容器的ip,只能在node服务器访问 排查后发现是k8s的master服务器和node节点的网址网段和k8s初始化时提示的ip网段不一致 我之前是192.168.137.50, 实际上master主机期望的是192.168.1.50 解决方案: 1.删除服务器后重建ma…...

鸿蒙OpenHarmony

开源鸿蒙系统编译指南 Ubuntu编译环境配置第一步&#xff1a;Shell 改 Bash第二步&#xff1a;安装Git和安装pip3工具第三步&#xff1a;远程仓配置第四步&#xff1a;拉取代码第五步&#xff1a;安装编译环境第六步&#xff1a;本地编译源码 Windows开发环境配置第一步&#x…...

把白底照片变蓝色用什么软件免费 批量更换证件照底色怎么弄

作为专业的修图师&#xff0c;有时候也会接手证件照修图和换底色工作&#xff0c;这种情况下&#xff0c;需要换底色的照片也许达到上百张。为了提高工作效率&#xff0c;一般需要批量快速修图&#xff0c;那么使用什么软件工具能够给各式不同的照片批量更换背景色呢&#xff1…...

Spring之生成Bean

Bean的生命周期&#xff1a;实例化->属性填充->初始化->销毁 核心入口方法&#xff1a;finishBeanFactoryInitialization-->preInstantiateSingletons DefaultListableBeanFactory#preInstantiateSingletons用于实例化非懒加载的bean。 1.preInstantiateSinglet…...

笔记整理—linux进程部分(6)进程间通信、alarm和pause

两个进程间通信可能是任何两个进程间的通信&#xff08;IPC&#xff09;。同一个进程是在同一块地址空间中的&#xff0c;在不同的函数与文件以变量进程传递&#xff0c;也可通过形参传递。2个不同进程处于不同的地址空间&#xff0c;要互相通信有难度&#xff08;内存隔离的原…...

Java网络通信—UDP

0.小记 1.udp通信不需要建立socket管道&#xff0c;一边只管发&#xff0c;一边只管收 2.客户端&#xff1a;将数据&#xff08;byte&#xff09;打包成包裹&#xff08;DatagramPacket&#xff09;&#xff0c;写上地址&#xff08;IP端口&#xff09;&#xff0c;通过快递站&…...

k8s架构,从clusterIP到光电半导体,再从clusterIP到企业管理

clusterIP作为k8s中的服务&#xff0c; 也是其他三个服务的基础 ~]$ kubectl create service clusterip externalname loadbalancer nodeport 客户端的流量到service service分发给pod&#xff0c;pod由控制器自动部署&#xff0c;自动维护 那么问题是service的可用…...

vue框架和uniapp框架区别

文章目录 vue框架和uniapp框架区别一、引言二、Vue.js 概述1、Vue.js 简介1.1、特点 2、适用场景 三、Uni-app 概述1、Uni-app 简介1.1、特点 2、适用场景 四、区别与比较1、跨平台能力2、开发体验3、性能优化4、社区和支持 五、总结 vue框架和uniapp框架区别 一、引言 在前端…...

828华为云征文 | 华为云Flexus云服务器X实例搭建Zabbix网络设备监视系统(Ubuntu服务器运维)

前言 Flexus X实例内嵌智能应用调优算法&#xff0c;性能强悍&#xff0c;基础模式GeekBench单核及多核跑分可达同规格独享型实例的1.6倍&#xff0c;性能模式更是超越多系列旗舰型云主机&#xff0c;为企业业务提供强劲动力。 &#x1f4bc; Flexus X Zabbix&#xff1a;打造…...

JAVA基础-线程(Thread)、多线程(Multi-threaded)

1、知识铺垫 要想了解什么是线程&#xff0c;首先要搞明白线程与进程的区别&#xff0c;并行与并发的区别 1.1 线程与进程 进程&#xff1a;是指⼀个内存中运⾏的应⽤程序&#xff0c;每个进程都有⼀个独⽴的内存空间&#xff0c;⼀个应⽤程序可以同时运⾏多个进程&#xff1b…...

hystrix微服务部署

目录 一.启动nacos和redis 1.查看是否有nacos和redis 二.开始项目 1.hystrix1工程&#xff08;修改一下工程的注册名字&#xff09; 2.运行登录nacos网站查看运行效果&#xff08;默认密码nacos,nacos&#xff09; 3.开启第二个项目 hystrix2工程 4.关闭第二个项目 hyst…...

使用百度文心智能体创建多风格表情包设计助手

文章目录 一、智能定制&#xff0c;个性飞扬二、多元风格&#xff0c;创意无限 百度文心智能体平台为你开启。百度文心智能体平台&#xff0c;创建属于自己的智能体应用。百度文心智能体平台是百度旗下的智能AI平台&#xff0c;集成了先进的自然语言处理技术和人工智能技术&…...

【嵌入式裸机开发】智能家居入门3(MQTT服务器、MQTT协议、微信小程序、STM32)

前面已经写了两篇博客关于智能家居的&#xff0c;服务器全都是使用ONENET中国移动&#xff0c;他最大的优点就是作为数据收发的中转站是免费的。本篇使用专门适配MQTT协议的MQTT服务器&#xff0c;有公用的&#xff0c;也可以自己搭建 前言一、项目总览二、总体流程分析1、了解…...

css的背景background属性

CSS的background属性是一个简写属性&#xff0c;它允许你同时设置元素的多个背景相关的子属性。使用这个属性可以简化代码&#xff0c;使其更加清晰和易于维护。background属性可以设置不同的子属性。 background子属性 定义背景颜色 使用background-color属性 格式&#x…...

Cypress自动化测试实战:构建高效的前端测试体系

在快速迭代的软件开发环境中&#xff0c;前端自动化测试是保证代码质量和用户体验的重要手段。Cypress作为一款功能强大的前端自动化测试工具&#xff0c;凭借其丰富的特性、直观的API和高效的测试执行速度&#xff0c;赢得了众多开发者和测试团队的青睐。本文将深入探讨Cypres…...

【YOLO学习】YOLOv2详解

文章目录 1. 概述2. Better2.1 Batch Normalization&#xff08;批归一化&#xff09;2.2 High Resolution Classifier&#xff08;高分辨率分类器&#xff09;2.3 Convolutional With Anchor Boxes&#xff08;带有Anchor Boxes的卷积&#xff09;2.4 Dimension Clusters&…...

windows 录音编码为flv格式时,pcm采样格式

这里使用的是0x3e&#xff0c;转换为二进制&#xff1a; 0 0 1 1 1 1 1 0 前四个字节为3&#xff0c;表示Linear Pcm, 后4个字节1 1 1 0 表示44100HZ采样&#xff0c; 16个bit&#xff0c;单声道。 故&#xff0c;windows 音频采样不支持48000HZ频率...

Qt开发技巧(九)去掉切换按钮,直接传样式文件,字体设置,QImage超强,巧用Qt的全局对象,信号槽断连,低量数据就用sqlite

继续讲一些Qt开发中的技巧操作&#xff1a; 1.去掉切换按钮 QTabWidget选项卡有个自动生成按钮切换选项卡的机制&#xff0c;有时候不想看到这个烦人的切换按钮&#xff0c;可以设置usesScrollButtons为假&#xff0c;其实QTabWidget的usesScrollButtons属性最终是应用到QTabWi…...

51c自动驾驶~合集1

我自己的原文哦~ https://blog.51cto.com/whaosoft/11466109 #HTCL 超过所有视觉方案&#xff01;HTCL&#xff1a;分层时间上下文问鼎OCC 本文是对ECCV2024接受的文章 HTCL: 的介绍&#xff0c;HTCL在SemanticKITTI基准测试中超过了所有基于相机的方法&#xff0c;甚至在和…...

HTML 列表、表格、表单

1 列表标签 作用&#xff1a;布局内容排列整齐的区域 列表分类&#xff1a;无序列表、有序列表、定义列表。 例如&#xff1a; 1.1 无序列表 标签&#xff1a;ul 嵌套 li&#xff0c;ul是无序列表&#xff0c;li是列表条目。 注意事项&#xff1a; ul 标签里面只能包裹 li…...

React19源码系列之 事件插件系统

事件类别 事件类型 定义 文档 Event Event 接口表示在 EventTarget 上出现的事件。 Event - Web API | MDN UIEvent UIEvent 接口表示简单的用户界面事件。 UIEvent - Web API | MDN KeyboardEvent KeyboardEvent 对象描述了用户与键盘的交互。 KeyboardEvent - Web…...

MODBUS TCP转CANopen 技术赋能高效协同作业

在现代工业自动化领域&#xff0c;MODBUS TCP和CANopen两种通讯协议因其稳定性和高效性被广泛应用于各种设备和系统中。而随着科技的不断进步&#xff0c;这两种通讯协议也正在被逐步融合&#xff0c;形成了一种新型的通讯方式——开疆智能MODBUS TCP转CANopen网关KJ-TCPC-CANP…...

在鸿蒙HarmonyOS 5中使用DevEco Studio实现录音机应用

1. 项目配置与权限设置 1.1 配置module.json5 {"module": {"requestPermissions": [{"name": "ohos.permission.MICROPHONE","reason": "录音需要麦克风权限"},{"name": "ohos.permission.WRITE…...

C++ Visual Studio 2017厂商给的源码没有.sln文件 易兆微芯片下载工具加开机动画下载。

1.先用Visual Studio 2017打开Yichip YC31xx loader.vcxproj&#xff0c;再用Visual Studio 2022打开。再保侟就有.sln文件了。 易兆微芯片下载工具加开机动画下载 ExtraDownloadFile1Info.\logo.bin|0|0|10D2000|0 MFC应用兼容CMD 在BOOL CYichipYC31xxloaderDlg::OnIni…...

什么是Ansible Jinja2

理解 Ansible Jinja2 模板 Ansible 是一款功能强大的开源自动化工具&#xff0c;可让您无缝地管理和配置系统。Ansible 的一大亮点是它使用 Jinja2 模板&#xff0c;允许您根据变量数据动态生成文件、配置设置和脚本。本文将向您介绍 Ansible 中的 Jinja2 模板&#xff0c;并通…...

return this;返回的是谁

一个审批系统的示例来演示责任链模式的实现。假设公司需要处理不同金额的采购申请&#xff0c;不同级别的经理有不同的审批权限&#xff1a; // 抽象处理者&#xff1a;审批者 abstract class Approver {protected Approver successor; // 下一个处理者// 设置下一个处理者pub…...

BLEU评分:机器翻译质量评估的黄金标准

BLEU评分&#xff1a;机器翻译质量评估的黄金标准 1. 引言 在自然语言处理(NLP)领域&#xff0c;衡量一个机器翻译模型的性能至关重要。BLEU (Bilingual Evaluation Understudy) 作为一种自动化评估指标&#xff0c;自2002年由IBM的Kishore Papineni等人提出以来&#xff0c;…...

【LeetCode】3309. 连接二进制表示可形成的最大数值(递归|回溯|位运算)

LeetCode 3309. 连接二进制表示可形成的最大数值&#xff08;中等&#xff09; 题目描述解题思路Java代码 题目描述 题目链接&#xff1a;LeetCode 3309. 连接二进制表示可形成的最大数值&#xff08;中等&#xff09; 给你一个长度为 3 的整数数组 nums。 现以某种顺序 连接…...

Python爬虫实战:研究Restkit库相关技术

1. 引言 1.1 研究背景与意义 在当今信息爆炸的时代,互联网上存在着海量的有价值数据。如何高效地采集这些数据并将其应用于实际业务中,成为了许多企业和开发者关注的焦点。网络爬虫技术作为一种自动化的数据采集工具,可以帮助我们从网页中提取所需的信息。而 RESTful API …...