Proto3:C++ API概览
包名 | 说明 |
---|---|
google::protobuf | Protocol Buffer运行时库核心组件。 |
google::protobuf::io | I/O操作辅助类。 |
google::protobuf::util | 工具类。 |
google::protobuf::compiler | Protocol Buffer编译器实现。 |
google::protobuf
Protocol Buffer运行时库核心组件。
此包中的文件代表着Protocol Buffer系统的核心,它们都是libprotobuf库的组成。
关于线程安全的注意事项:
Protocol Buffer库的线程安全遵循一个简单的规则:除非显示地说明,只要对象在所有线程中声明为const
,那么同时使用来自多个线程的对象总是安全的(或者,只有在声明为const
的情况下才被允许使用)。但是,如果一个对象在一个线程中以不允许const
的方式被访问,那么其它任何线程同时访问访问该对象都是不安全的。
简单来说,在多线程中同时以只读的方式访问对象是允许的,但是同时只能有一个线程以写的方式访问对象。
该实现确实包含一些const
方法,这些方法实际上在后台修改对象 --- 例如,缓存结果 --- 但是在这些情况下,使用互斥锁使访问线程安全。
文件 | 说明 |
---|---|
google/protobuf/arena.h | 针对分配性能,文件定义了Arena分配。 |
google/protobuf/descriptor.h | 文件中包含描述protocol消息的类。 |
google/protobuf/descriptor.pb.h | 描述符的Protocol Buffer表示。 |
google/protobuf/descriptor_database.h | 操作描述符数据库的接口。 |
google/protobuf/dynamic_message.h | 定义消息的实现,该实现可以模拟编译时未知的类型的。 |
google/protobuf/map.h | 定义了map容器以及protobuf map支持。 |
google/protobuf/message.h | 定义消息,非liteprotocol消息对象的抽象接口实现。 |
google/protobuf/message_lite.h | 定义轻量消息,所有(包括轻量和非清理)protocol消息对象的抽象接口实现。 |
google/protobuf/repeated_field.h | 供生成的protocol消息类使用RepeatedField和RepeatedPtrField操作重复字段。 |
google/protobuf/service.h | 弃用:该模块声明了proto2底层RPC服务的抽象接口。 |
google/protobuf/text_format.h | 以可读的方式 --- text-based方式输出和解析protocol消息工具。 |
google/protobuf/unknown_field_set.h | 包含用于跟踪在解析protocol消息时遇到的未识别字段的类。 |
google/protobuf/stubs/common.h | 包含库中其它部分使用的基本类型和工具。 |
google::protobuf::io
I/O操作辅助类。
Protocol Buffer库使用包中类来处理原始字节的I/O和编解码操作。大多数使用者并不需要知道包的实现细节。然而,当用户想要适配他们自己的I/O --- 例如,想要在不使用临时缓存的情况下从不同的输入流中读取Protocol Buffer,这样的用户需要详细了解实现细节。
文件 | 说明 |
---|---|
google/protobuf/io/coded_stream.h | 这个文件包含CodedInputStream和CodedOutputStream类,它们分别包装一个ZeroCopyInputStream或ZeroCopyOutputStream,并允许您以各种格式读取或写入单个数据片段。 |
google/protobuf/io/printer.h | 将text内容写入ZeroCopyOutputStream的工具类。 |
google/protobuf/io/tokenizer.h | 从ZeroCopyInputStream解析标记化的text类。 |
google/protobuf/io/zero_copy_stream.h | 包含ZeroCopyInputStream或ZeroCopyOutputStream,可用来表示抽象的I/O流和读写Protocol Buffer。 |
google/protobuf/io/zero_copy_stream_impl.h | 包含在zero_copy_stream.h中定义的接口的实现,仅包括在完整的protobuf库中。 |
google::protobuf::util
工具类,其中包括许多工具,可用于消息比对、JSON转换以及其它已知类型等。
文件 | 说明 |
---|---|
google/protobuf/util/field_comparator.h | 定义了用于字段对比的类。 |
google/protobuf/util/field_mask_util.h | 定义FieldMask已知类型的工具。 |
[google/protobuf/util/json_util.h | 定义了在protocol二进制格式与proto3 JSON格式间转换的工具函数。 |
google/protobuf/util/message_differencer.h | 定义了用于比较Protocol消息的静态函数和方法。 |
google/protobuf/util/time_util.h | 定义了用于时间戳和时长的工具函数。 |
google/protobuf/util/type_resolver.h | 为所有消息定义了Type Resolver。 |
google/protobuf/util/type_resolver_util.h | 定义了TypeResolver工具。 |
google::protobuf::compiler
Protocol Buffer编译器的实现,其中包含了解析.proto
文件的代码以及基于.proto
文件生成代码的代码。你可能因为以下两个原因而对这个包感兴趣:
- 在运行时你想要解析
.proto
文件。这种情况下,你用过翻阅importer.h。由于这个功能应用很广泛,所以它被包含在libprotobuf的基本库里;这样你就不必链接libprotoc。 - 你要实现一个自定义的protocol编译器来生成不同的代码,比如说官方编译器不支持的编程语言。为此,command_line_interface.h为你提供了完整的编译器前端,所以你要做的就是编写CodeGenerator的自定义实现以及一个简单的
main()
函数。你甚至可以让你的编译器支持你自己编写的语言。由于这些功能只适用于那些要自己编写编译器的人,所以它们位于你必须链接的名为libprotoc
的特定库中。
更多信息,参见这里。
Proto3:C++ API概览的更多相关文章
- Zookeeper C API 指南四(C API 概览)(转)
上一节<Zookeeper C API 指南三(回调函数)>重点讲了 Zookeeper C API 中各种回调函数的原型,本节将切入正题,正式讲解 Zookeeper C API.相信大 ...
- node-webkit学习(3)Native UI API概览
node-webkit学习(3)Native UI API概览 文/玄魂 目录 node-webkit学习(3)Native UI API概览 前言 3.1 Native UI api概览 Exte ...
- Android 设备管理API概览(Device Administration API)
原文:http://android.eoe.cn/topic/android_sdk Android 2.2通过提供Android设备管理API的支持来引入企业应用支持.在系统级的设备管理API提供了 ...
- V8世界探险 (1) - v8 API概览
版权声明:本文为博主原创文章,遵循 CC 4.0 by-sa 版权协议,转载请附上原文出处链接和本声明. 本文链接:https://blog.csdn.net/lusing/article/detai ...
- 20. API概览 Schemas
能被机器所理解的概要, 描述了通过api可得到的资源, URL, 表示方式以及支持的操作. API概要在很多使用场景下都是有用的工具, 例如生成参考文档, 或者驱动可以与API交互的动态客户端库. r ...
- Java 8 Date-Time API概览
更新时间:2018-04-19 根据网上资料整理 java 8增加了新的Date-Time API (JSR 310),增强对日期与时间的处理.它在很大程度上受到Joda-Time的影响.之前写过一篇 ...
- underscore api 概览
underscore 集合函数(数组或对象) _.each(list, iteratee, [context]); _.map(list, iteratee, [context]); _.reduce ...
- Golang里面使用protobuf(proto3)
参考文章:https://developers.google.com/protocol-buffers/docs/gotutorial 1.执行指令: go envgo get github.com/ ...
- Zookeeper C API 指南三(回调函数)(转)
2013-02-21 12:54 by Haippy, 9237 阅读, 0 评论, 收藏, 编辑 接上一篇<Zookeeper C API 指南二(监视(Wathes), 基本常量和结构体介绍 ...
随机推荐
- java内部类(构造spring中的接收返回数据的实体类)
说起内部类这个词,想必很多人都不陌生,但是又会觉得不熟悉.原因是平时编写代码时可能用到的场景不多,用得最多的是在有事件监听的情况下,并且即使用到也很少去总结内部类的用法.今天我们就来一探究竟. 原文链 ...
- Django框架的安装与使用
Django框架的安装与使用 在使用Django框架开发web应用程序时,开发阶段同样依赖wsgiref模块来实现Server的功能,我们使用Django框架是为了快速地开发application, ...
- 【iOS学习笔记】UITextField中的输入检测——限制只能输入数字和小数点
最近趁着放假时间,在看The Big Nerd Ranch的iOS编程,想着重新复习一遍iOS开发的基础知识 于是从这一篇开始记录一些学习过程中遇到的小问题 书中第四章有一个温度转换的app实现,整体 ...
- 如何动态调用WebService
封装WBS类 using System; using System.Collections.Generic; using System.Linq; using System.Web; using Sy ...
- vncserver
## install packages yum install tigervnc-server xhost ## start vnc and xhost vncserver export DISPLA ...
- UML-设想
样例:
- Ret2shellcode
利用原理 ret2shellcode,即控制程序执行 shellcode 代码.一般来说,shellcode 需要我们自己填充.这其实是另外一种典型的利用方法,即此时我们需要自己去填充一些可执行的代码 ...
- Nmap_使用介绍
Nmap 注意,本文仅是作为课余时间的学习了解,请不要做有关违反法律法规的事情,违者自行承担后果!!! 环境centos7.7yum -y install nmap 命令操作 1.扫描单个目标 1. ...
- 学习4412开发板gdb和gdbserver的调试
因为有很多的小伙伴是从单片机转过来的,用惯了单片机上的JLINK调试程序,换到Linux上非常的不习惯.确实,如果能设置断点,单步调试,查看变量,那确实是太爽了,那么在我们的Linux可以做到吗,答案 ...
- ipv6 mac地址转化为linklocal地址
mac 3c:32:66:67:dd:46 linklocal地址 前六位固定 fe80:: 第七位 mac地址第一个byte进行如下计算 (byte) ((byte) (macbyte &am ...