Table of Contents
Just a second...

DEPRECATED: Protocol buffer topics

A topic that maintains state at the server in Google protocol buffers format.

Note: Protocol buffer topics are deprecated and will be removed in a future release. We recommend that you stream your protocol buffer data using a binary topic instead and handle serialization and deserialization of the binary data at your clients.

Protocol buffers provide an extensible mechanism for serializing structured data.

For more information about protocol buffers, see https://developers.google.com/protocol-buffers/.

Define the format of data on a protocol buffer topic by using a .proto file. Compile the .proto file into a Java™ class and ensure that the class is on the Diffusion™ server classpath.

The schema defines a compiled .proto class which must exist at the server and the name of a message definition within the class that defines the topic data layout.

Why use a protocol buffer topic?

Data on protocol buffers topics is simple and small, and can be transmitted and parsed quickly.

A protocol buffer topic benefits from the same delta-processing capability at the server as a record topic.

Serialization and deserialization code can be automatically generated for the data on the topic.

Considerations when using a protocol buffer topic

The compiled .proto Java class must be present on the classpath of the Diffusion server. If your solution uses multiple Diffusion servers that all host a protocol buffer topic with the same message definition, the same compiled .proto class must be present on all of their classpaths.

Protocol buffer definitions must be compiled into Java.

The supported version of protoc is 2.6.1.