io.grpc.protobuf

Class ProtoUtils

java.lang.Object

io.grpc.protobuf.ProtoUtils

public final class ProtoUtils
extends Object

Utility methods for using protobuf with grpc.

Method Summary

Modifier and Type	Method and Description
static <T extends Message> Metadata.Key<T>	keyForProto(T instance) Produce a metadata key for a generated protobuf type.
static <T extends Message> MethodDescriptor.Marshaller<T>	marshaller(T defaultInstance) Create a MethodDescriptor.Marshaller for protos of the same type as defaultInstance.
static <T extends Message> Metadata.BinaryMarshaller<T>	metadataMarshaller(T instance) Produce a metadata marshaller for a protobuf type.
static void	setExtensionRegistry(ExtensionRegistry registry) Sets the global registry for proto marshalling shared across all servers and clients.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

setExtensionRegistry

@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/1787")
public static void setExtensionRegistry(ExtensionRegistry registry)

Sets the global registry for proto marshalling shared across all servers and clients.

Warning: This API will likely change over time. It is not possible to have separate registries per Process, Server, Channel, Service, or Method. This is intentional until there is a more appropriate API to set them.

Warning: Do NOT modify the extension registry after setting it. It is thread safe to call setExtensionRegistry(com.google.protobuf.ExtensionRegistry), but not to modify the underlying object.

If you need custom parsing behavior for protos, you will need to make your own MethodDescriptor.Marshaller for the time being.

Since:

1.16.0

marshaller

public static <T extends Message> MethodDescriptor.Marshaller<T> marshaller(T defaultInstance)

Create a MethodDescriptor.Marshaller for protos of the same type as defaultInstance.

Since:

1.0.0

keyForProto

public static <T extends Message> Metadata.Key<T> keyForProto(T instance)

Produce a metadata key for a generated protobuf type.

Since:

1.0.0

metadataMarshaller

@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/4477")
public static <T extends Message> Metadata.BinaryMarshaller<T> metadataMarshaller(T instance)

Produce a metadata marshaller for a protobuf type.

Since:

1.13.0