С++ API

Пакеты
google::protobuf
google::protobuf::io Вспомогательные классы, используемые для ввода-вывода.
google::protobuf::util Полезные классы.
google::protobuf::compiler Реализация компилятора протокольного буфера.

гугл:: протобуф

Файлы
google/protobuf/arena.h Этот файл определяет распределитель Arena для повышения производительности распределения.
google/protobuf/descriptor.h Этот файл содержит классы, которые описывают тип сообщения протокола.
google/protobuf/descriptor.pb.h Буферные представления дескрипторов протокола.
google/protobuf/descriptor_database.h Интерфейс для работы с базами данных дескрипторов.
google/protobuf/dynamic_message.h Определяет реализацию Message , которая может эмулировать типы, неизвестные во время компиляции.
google/protobuf/map.h Этот файл определяет контейнер карты и его помощники для поддержки карт protobuf.
google/protobuf/message.h Определяет Message , абстрактный интерфейс, реализуемый объектами сообщений необлегченного протокола.
google/protobuf/message_lite.h Определяет MessageLite , абстрактный интерфейс, реализованный всеми (упрощенными и неупрощенными) объектами сообщений протокола.
google/protobuf/repeated_field.h RepeatedField и RepeatedPtrField используются сгенерированными классами протокольных сообщений для управления повторяющимися полями.
google/protobuf/service.h УСТАРЕЛО: этот модуль объявляет абстрактные интерфейсы, лежащие в основе сервисов proto2 RPC.
google/protobuf/text_format.h Утилиты для печати и разбора протокольных сообщений в удобочитаемом текстовом формате.
google/protobuf/unknown_field_set.h Содержит классы, используемые для отслеживания нераспознанных полей, видимых при анализе сообщения протокола.

гугл::протобуф::ио

Вспомогательные классы, используемые для ввода-вывода.

Библиотека Protocol Buffer использует классы из этого пакета для работы с вводом-выводом и кодированием/декодированием необработанных байтов. Большинству пользователей не нужно иметь дело с этим пакетом. Тем не менее, пользователям, которые хотят адаптировать систему для работы со своими собственными абстракциями ввода-вывода, например, разрешить считывание протокольных буферов из другого типа входного потока без необходимости во временном буфере, следует присмотреться повнимательнее.

Файлы
google/protobuf/io/coded_stream.h Этот файл содержит классы CodedInputStream и CodedOutputStream , которые оборачивают ZeroCopyInputStream или ZeroCopyOutputStream соответственно и позволяют читать или записывать отдельные фрагменты данных в различных форматах.
google/protobuf/io/printer.h Служебный класс для записи текста в ZeroCopyOutputStream .
google/protobuf/io/tokenizer.h Класс для разбора токенизированного текста из ZeroCopyInputStream .
google/protobuf/io/zero_copy_stream.h Этот файл содержит интерфейсы ZeroCopyInputStream и ZeroCopyOutputStream , которые представляют собой абстрактные потоки ввода-вывода, в которые и из которых можно считывать и записывать буферы протокола.
google/protobuf/io/zero_copy_stream_impl.h Этот файл содержит общие реализации интерфейсов, определенных в zero_copy_stream.h , которые включены только в полную (не облегченную) библиотеку protobuf.
google/protobuf/io/zero_copy_stream_impl_lite.h Этот файл содержит общие реализации интерфейсов, определенных в zero_copy_stream.h , которые включены в "облегченную" библиотеку protobuf.

гугл:: протобуф:: утилита

Полезные классы.

Этот пакет содержит различные утилиты для сравнения сообщений, преобразования JSON, общеизвестных типов и т. д.

Файлы
google/protobuf/util/field_comparator.h Определяет классы для сравнения полей.
google/protobuf/util/field_mask_util.h Определяет утилиты для общеизвестного типа FieldMask.
google/protobuf/util/json_util.h Служебные функции для преобразования между двоичным форматом protobuf и форматом proto3 JSON.
google/protobuf/util/message_differencer.h Этот файл определяет статические методы и классы для сравнения сообщений протокола.
google/protobuf/util/time_util.h Определяет утилиты для хорошо известных типов Timestamp и Duration.
google/protobuf/util/type_resolver.h Определяет TypeResolver для любого сообщения.
google/protobuf/util/type_resolver_util.h Определяет утилиты для TypeResolver.

гугл::протобуф::компилятор

Реализация компилятора протокольного буфера.

Этот пакет содержит код для разбора файлов .proto и генерации кода на их основе. Есть две причины, по которым вас может заинтересовать этот пакет:

• Вы хотите анализировать файлы .proto во время выполнения. В этом случае вы должны посмотреть importer.h . Поскольку эта функциональность широко используется, она включена в базовую библиотеку libprotobuf; вам не нужно связываться с libprotoc.
• Вы хотите написать собственный компилятор протокола, который генерирует различные виды кода, например, код на другом языке, который не поддерживается официальным компилятором. Для этой цели command_line_interface.h предоставляет вам полный внешний интерфейс компилятора, поэтому все, что вам нужно сделать, это написать собственную реализацию CodeGenerator и тривиальную функцию main(). Вы даже можете заставить свой компилятор поддерживать официальные языки в дополнение к вашему собственному. Поскольку эта функциональность полезна только для тех, кто пишет собственные компиляторы, она находится в отдельной библиотеке под названием «libprotoc», с которой вам придется связываться.

Файлы
google/protobuf/compiler/code_generator.h Определяет абстрактный интерфейс, реализованный каждым из генераторов кода для конкретного языка.
google/protobuf/compiler/command_line_interface.h Реализует внешний интерфейс компилятора протоколов, чтобы его можно было повторно использовать в пользовательских компиляторах, написанных для поддержки других языков.
google/protobuf/compiler/importer.h Этот файл является общедоступным интерфейсом для парсера файлов .proto.
google/protobuf/compiler/parser.h Реализует синтаксический анализ файлов .proto в FileDescriptorProtos.
google/protobuf/compiler/plugin.h Внешний интерфейс для плагинов генератора кода протокола, написанных на C++.
google/protobuf/compiler/plugin.pb.h API для плагинов protoc.
google/protobuf/compiler/cpp/cpp_generator.h Генерирует код C++ для заданного файла .proto.
google/protobuf/compiler/csharp/csharp_generator.h Создает код C# для заданного файла .proto.
google/protobuf/compiler/csharp/csharp_names.h Предоставляет механизм сопоставления дескриптора с полным именем соответствующего класса C#.
google/protobuf/compiler/java/java_generator.h Генерирует код Java для заданного файла .proto.
google/protobuf/compiler/java/java_names.h Предоставляет механизм сопоставления дескриптора с полным именем соответствующего класса Java.
google/protobuf/compiler/js/js_generator.h Генерирует код JavaScript для заданного файла .proto.
google/protobuf/compiler/objectivec/objectivec_generator.h Генерирует код ObjectiveC для заданного файла .proto.
google/protobuf/compiler/objectivec/objectivec_helpers.h Вспомогательные функции для генерации кода ObjectiveC.
google/protobuf/compiler/python/python_generator.h Генерирует код Python для заданного файла .proto.
google/protobuf/compiler/ruby/ruby_generator.h Генерирует код Ruby для заданного файла .proto.