org.apache.paimon.service.network.messages

Class MessageSerializer<REQ extends MessageBody,RESP extends MessageBody>

java.lang.Object

org.apache.paimon.service.network.messages.MessageSerializer<REQ,RESP>

Type Parameters:

REQ - Type of the requests of the protocol.

RESP - Type of the responses of the protocol.

public final class MessageSerializer<REQ extends MessageBody,RESP extends MessageBody>
extends Object

Serialization and deserialization of messages exchanged between NetworkClient and NetworkServer.

The binary messages have the following format:

                     <------ Frame ------------------------->
                    +----------------------------------------+
                    |        HEADER (8)      | PAYLOAD (VAR) |
 +------------------+----------------------------------------+
 | FRAME LENGTH (4) | VERSION (4) | TYPE (4) | CONTENT (VAR) |
 +------------------+----------------------------------------+
 

The concrete content of a message depends on the MessageType.

Constructor Summary

Constructors

Constructor and Description
MessageSerializer(MessageDeserializer<REQ> requestDeser, MessageDeserializer<RESP> responseDeser)

Method Summary

Modifier and Type	Method and Description
static MessageType	deserializeHeader(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf buf) De-serializes the header and returns the MessageType.
REQ	deserializeRequest(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf buf) De-serializes the request sent to the NetworkServer.
static RequestFailure	deserializeRequestFailure(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf buf) De-serializes the RequestFailure sent to the NetworkClient in case of protocol related errors.
RESP	deserializeResponse(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf buf) De-serializes the response sent to the NetworkClient.
static Throwable	deserializeServerFailure(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf buf) De-serializes the failure message sent to the NetworkClient in case of server related errors.
static long	getRequestId(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf buf) De-serializes the header and returns the MessageType.
static <REQ extends MessageBody> org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf	serializeRequest(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBufAllocator alloc, long requestId, REQ request) Serializes the request sent to the NetworkServer.
static org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf	serializeRequestFailure(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBufAllocator alloc, long requestId, Throwable cause) Serializes the exception containing the failure message sent to the NetworkClient in case of protocol related errors.
static <RESP extends MessageBody> org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf	serializeResponse(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBufAllocator alloc, long requestId, RESP response) Serializes the response sent to the NetworkClient.
static org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf	serializeServerFailure(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBufAllocator alloc, Throwable cause) Serializes the failure message sent to the NetworkClient in case of server related errors.

Methods inherited from class java.lang.Object

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

Constructor Detail

MessageSerializer

public MessageSerializer(MessageDeserializer<REQ> requestDeser,
                         MessageDeserializer<RESP> responseDeser)

Method Detail

serializeRequest

public static <REQ extends MessageBody> org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf serializeRequest(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBufAllocator alloc,
                                                                                                                long requestId,
                                                                                                                REQ request)

Serializes the request sent to the NetworkServer.

Parameters:

alloc - The ByteBufAllocator used to allocate the buffer to serialize the message into.

requestId - The id of the request to which the message refers to.

request - The request to be serialized.

Returns:

A ByteBuf containing the serialized message.

serializeResponse

public static <RESP extends MessageBody> org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf serializeResponse(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBufAllocator alloc,
                                                                                                                  long requestId,
                                                                                                                  RESP response)

Serializes the response sent to the NetworkClient.

Parameters:

alloc - The ByteBufAllocator used to allocate the buffer to serialize the message into.

requestId - The id of the request to which the message refers to.

response - The response to be serialized.

Returns:

A ByteBuf containing the serialized message.

serializeRequestFailure

public static org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf serializeRequestFailure(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBufAllocator alloc,
                                                                                             long requestId,
                                                                                             Throwable cause)
                                                                                      throws IOException

Serializes the exception containing the failure message sent to the NetworkClient in case of protocol related errors.

Parameters:

alloc - The ByteBufAllocator used to allocate the buffer to serialize the message into.

requestId - The id of the request to which the message refers to.

cause - The exception thrown at the server.

Returns:

A ByteBuf containing the serialized message.

Throws:

IOException

serializeServerFailure

public static org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf serializeServerFailure(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBufAllocator alloc,
                                                                                            Throwable cause)
                                                                                     throws IOException

Serializes the failure message sent to the NetworkClient in case of server related errors.

Parameters:

alloc - The ByteBufAllocator used to allocate the buffer to serialize the message into.

cause - The exception thrown at the server.

Returns:

The failure message.

Throws:

IOException

deserializeHeader

public static MessageType deserializeHeader(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf buf)

De-serializes the header and returns the MessageType.

  The buffer is expected to be at the header position.
 

Parameters:

buf - The ByteBuf containing the serialized header.

Returns:

The message type.

Throws:

IllegalStateException - If unexpected message version or message type.

getRequestId

public static long getRequestId(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf buf)

De-serializes the header and returns the MessageType.

  The buffer is expected to be at the request id position.
 

Parameters:

buf - The ByteBuf containing the serialized request id.

Returns:

The request id.

deserializeRequest

public REQ deserializeRequest(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf buf)

De-serializes the request sent to the NetworkServer.

  The buffer is expected to be at the request position.
 

Parameters:

buf - The ByteBuf containing the serialized request.

Returns:

The request.

deserializeResponse

public RESP deserializeResponse(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf buf)

De-serializes the response sent to the NetworkClient.

  The buffer is expected to be at the response position.
 

Parameters:

buf - The ByteBuf containing the serialized response.

Returns:

The response.

deserializeRequestFailure

public static RequestFailure deserializeRequestFailure(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf buf)
                                                throws IOException,
                                                       ClassNotFoundException

De-serializes the RequestFailure sent to the NetworkClient in case of protocol related errors.

  The buffer is expected to be at the correct position.
 

Parameters:

buf - The ByteBuf containing the serialized failure message.

Returns:

The failure message.

Throws:

IOException

ClassNotFoundException

deserializeServerFailure

public static Throwable deserializeServerFailure(org.apache.paimon.shade.netty4.io.netty.buffer.ByteBuf buf)
                                          throws IOException,
                                                 ClassNotFoundException

De-serializes the failure message sent to the NetworkClient in case of server related errors.

  The buffer is expected to be at the correct position.
 

Parameters:

buf - The ByteBuf containing the serialized failure message.

Returns:

The failure message.

Throws:

IOException

ClassNotFoundException