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的特定库中。
更多信息，参见这里。
