Package com.linecorp.armeria.common.grpc.protocol

Class ArmeriaMessageDeframer

java.lang.Object

com.linecorp.armeria.common.grpc.protocol.AbstractMessageDeframer

com.linecorp.armeria.common.grpc.protocol.ArmeriaMessageDeframer

All Implemented Interfaces:

com.linecorp.armeria.common.stream.HttpDecoder<DeframedMessage>, com.linecorp.armeria.common.stream.StreamDecoder<com.linecorp.armeria.common.HttpData,DeframedMessage>

@UnstableApi
public class ArmeriaMessageDeframer
extends AbstractMessageDeframer
implements com.linecorp.armeria.common.stream.HttpDecoder<DeframedMessage>

A deframer of messages transported in the gRPC wire format. See gRPC Wire Format for more detail on the protocol.

The logic has been mostly copied from io.grpc.internal.MessageDeframer, while removing the buffer abstraction in favor of using ByteBuf directly, and allowing the delivery of uncompressed frames as a ByteBuf to optimize message parsing.

Field Summary

Fields inherited from class com.linecorp.armeria.common.grpc.protocol.AbstractMessageDeframer

NO_MAX_INBOUND_MESSAGE_SIZE

Constructor Summary

Constructors

Constructor	Description
ArmeriaMessageDeframer(int maxMessageLength)	Construct an ArmeriaMessageDeframer for reading messages out of a gRPC request or response.
ArmeriaMessageDeframer(int maxMessageLength, io.netty.buffer.ByteBufAllocator alloc, boolean grpcWebText)	Construct an ArmeriaMessageDeframer for reading messages out of a gRPC request or response with the specified parameters.

Method Summary

Modifier and Type	Method	Description
ArmeriaMessageDeframer	decompressor(@Nullable Decompressor decompressor)	Sets the Decompressor for this deframer.
void	process(com.linecorp.armeria.common.stream.StreamDecoderInput in, com.linecorp.armeria.common.stream.StreamDecoderOutput<DeframedMessage> out)
io.netty.buffer.ByteBuf	toByteBuf(com.linecorp.armeria.common.HttpData in)

Methods inherited from class com.linecorp.armeria.common.grpc.protocol.AbstractMessageDeframer

readBody, readHeader

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.linecorp.armeria.common.stream.HttpDecoder

processHeaders, processInformationalHeaders, processTrailers

Methods inherited from interface com.linecorp.armeria.common.stream.StreamDecoder

processOnComplete, processOnError

Constructor Details

ArmeriaMessageDeframer

public ArmeriaMessageDeframer(int maxMessageLength)

Construct an ArmeriaMessageDeframer for reading messages out of a gRPC request or response.

ArmeriaMessageDeframer

public ArmeriaMessageDeframer(int maxMessageLength,
 io.netty.buffer.ByteBufAllocator alloc,
 boolean grpcWebText)

Construct an ArmeriaMessageDeframer for reading messages out of a gRPC request or response with the specified parameters.

Method Details

toByteBuf

public io.netty.buffer.ByteBuf toByteBuf(com.linecorp.armeria.common.HttpData in)

Specified by:

toByteBuf in interface com.linecorp.armeria.common.stream.HttpDecoder<DeframedMessage>

Specified by:

toByteBuf in interface com.linecorp.armeria.common.stream.StreamDecoder<com.linecorp.armeria.common.HttpData,DeframedMessage>

process

public void process(com.linecorp.armeria.common.stream.StreamDecoderInput in,
 com.linecorp.armeria.common.stream.StreamDecoderOutput<DeframedMessage> out)
             throws Exception

Specified by:

process in interface com.linecorp.armeria.common.stream.StreamDecoder<com.linecorp.armeria.common.HttpData,DeframedMessage>

Throws:

Exception

decompressor

public ArmeriaMessageDeframer decompressor(@Nullable
 @Nullable Decompressor decompressor)

Description copied from class: AbstractMessageDeframer

Sets the Decompressor for this deframer.

Overrides:

decompressor in class AbstractMessageDeframer