org.apache.ratis.grpc.util

类 ZeroCopyMessageMarshaller<T extends org.apache.ratis.thirdparty.com.google.protobuf.MessageLite>

java.lang.Object

org.apache.ratis.grpc.util.ZeroCopyMessageMarshaller<T>

所有已实现的接口:

org.apache.ratis.thirdparty.io.grpc.MethodDescriptor.Marshaller<T>, org.apache.ratis.thirdparty.io.grpc.MethodDescriptor.PrototypeMarshaller<T>, org.apache.ratis.thirdparty.io.grpc.MethodDescriptor.ReflectableMarshaller<T>

public class ZeroCopyMessageMarshaller<T extends org.apache.ratis.thirdparty.com.google.protobuf.MessageLite>
extends Object
implements org.apache.ratis.thirdparty.io.grpc.MethodDescriptor.PrototypeMarshaller<T>

Custom gRPC marshaller to use zero memory copy feature of gRPC when deserializing messages. This achieves zero-copy by deserializing proto messages pointing to the buffers in the input stream to avoid memory copy so stream should live as long as the message can be referenced. Hence, it exposes the input stream to applications (through popStream) and applications are responsible to close it when it's no longer needed. Otherwise, it'd cause memory leak.

构造器概要

构造器

构造器和说明
ZeroCopyMessageMarshaller(T defaultInstance)
ZeroCopyMessageMarshaller(T defaultInstance, Consumer<T> zeroCopyCount, Consumer<T> nonZeroCopyCount)

方法概要

限定符和类型	方法和说明
Class<T>	getMessageClass()
T	getMessagePrototype()
T	parse(InputStream stream)
InputStream	popStream(T message) Application can call this function to get the stream for the message, and, possibly later, must call InputStream.close() to release buffers.
void	release(T message) Release the underlying buffers in the given message.
InputStream	stream(T value)

从类继承的方法 java.lang.Object

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

构造器详细资料

ZeroCopyMessageMarshaller

public ZeroCopyMessageMarshaller(T defaultInstance)

ZeroCopyMessageMarshaller

public ZeroCopyMessageMarshaller(T defaultInstance,
                                 Consumer<T> zeroCopyCount,
                                 Consumer<T> nonZeroCopyCount)

方法详细资料

getMessageClass

public Class<T> getMessageClass()

指定者:

getMessageClass 在接口中 org.apache.ratis.thirdparty.io.grpc.MethodDescriptor.ReflectableMarshaller<T extends org.apache.ratis.thirdparty.com.google.protobuf.MessageLite>

getMessagePrototype

public T getMessagePrototype()

指定者:

getMessagePrototype 在接口中 org.apache.ratis.thirdparty.io.grpc.MethodDescriptor.PrototypeMarshaller<T extends org.apache.ratis.thirdparty.com.google.protobuf.MessageLite>

stream

public InputStream stream(T value)

指定者:

stream 在接口中 org.apache.ratis.thirdparty.io.grpc.MethodDescriptor.Marshaller<T extends org.apache.ratis.thirdparty.com.google.protobuf.MessageLite>

parse

public T parse(InputStream stream)

指定者:

parse 在接口中 org.apache.ratis.thirdparty.io.grpc.MethodDescriptor.Marshaller<T extends org.apache.ratis.thirdparty.com.google.protobuf.MessageLite>

release

public void release(T message)

Release the underlying buffers in the given message.

popStream

public InputStream popStream(T message)

Application can call this function to get the stream for the message, and, possibly later, must call InputStream.close() to release buffers. Alternatively, use #release(T) to do both in one step.