com.mysql.cj.protocol.a

Class MultiPacketReader

java.lang.Object

com.mysql.cj.protocol.a.MultiPacketReader

All Implemented Interfaces:

MessageReader<NativePacketHeader,NativePacketPayload>

public class MultiPacketReader
extends java.lang.Object
implements MessageReader<NativePacketHeader,NativePacketPayload>

A MessageReader which reads a full packet built from sequence of it's on-wire parts. See http://dev.mysql.com/doc/internals/en/sending-more-than-16mbyte.html

Constructor Summary

Constructors

Constructor and Description
MultiPacketReader(MessageReader<NativePacketHeader,NativePacketPayload> packetReader)

Method Summary

Modifier and Type	Method and Description
byte	getMessageSequence() Get last message sequence number, as it was stored by MessageReader.readHeader().
NativePacketHeader	probeHeader() Read the next message header from server, possibly blocking indefinitely until the message is received, and cache it so that the next MessageReader.readHeader() return the same header.
NativePacketPayload	probeMessage(java.util.Optional<NativePacketPayload> reuse, NativePacketHeader header) Read message from server into to the given Message instance or into the new one if not present and cache it so that the next MessageReader.readMessage(Optional, MessageHeader) return the same message.
NativePacketHeader	readHeader() Read the next message header from server, possibly blocking indefinitely until the message is received.
NativePacketPayload	readMessage(java.util.Optional<NativePacketPayload> reuse, NativePacketHeader header) Read message from server into to the given Message instance or into the new one if not present.
void	resetMessageSequence() Set stored message sequence number to 0.
MessageReader<NativePacketHeader,NativePacketPayload>	undecorate() Return the previous MessageReader instance from the decorators chain or the current MessageReader if it is the first entry in a chain.
MessageReader<NativePacketHeader,NativePacketPayload>	undecorateAll() Return a MessageReader instance free of decorators.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.mysql.cj.protocol.MessageReader

pushMessageListener, readMessage, start, stopAfterNextMessage

Constructor Detail

MultiPacketReader

public MultiPacketReader(MessageReader<NativePacketHeader,NativePacketPayload> packetReader)

Method Detail

readHeader

public NativePacketHeader readHeader()
                              throws java.io.IOException

Description copied from interface: MessageReader

Read the next message header from server, possibly blocking indefinitely until the message is received.

Specified by:

readHeader in interface MessageReader<NativePacketHeader,NativePacketPayload>

Returns:

MessageHeader of the next message

Throws:

java.io.IOException - if an error occurs

probeHeader

public NativePacketHeader probeHeader()
                               throws java.io.IOException

Description copied from interface: MessageReader

Read the next message header from server, possibly blocking indefinitely until the message is received, and cache it so that the next MessageReader.readHeader() return the same header.

Specified by:

probeHeader in interface MessageReader<NativePacketHeader,NativePacketPayload>

Returns:

MessageHeader of the next message

Throws:

java.io.IOException - if an error occurs

readMessage

public NativePacketPayload readMessage(java.util.Optional<NativePacketPayload> reuse,
                                       NativePacketHeader header)
                                throws java.io.IOException

Description copied from interface: MessageReader

Read message from server into to the given Message instance or into the new one if not present. For asynchronous channel it synchronously reads the next message in the stream, blocking until the message is read fully. Could throw CJCommunicationsException wrapping an IOException during read or parse

Specified by:

readMessage in interface MessageReader<NativePacketHeader,NativePacketPayload>

Parameters:

reuse - Message object to reuse. May be ignored by implementation.

header - MessageHeader instance

Returns:

Message instance

Throws:

java.io.IOException - if an error occurs

probeMessage

public NativePacketPayload probeMessage(java.util.Optional<NativePacketPayload> reuse,
                                        NativePacketHeader header)
                                 throws java.io.IOException

Description copied from interface: MessageReader

Read message from server into to the given Message instance or into the new one if not present and cache it so that the next MessageReader.readMessage(Optional, MessageHeader) return the same message. For asynchronous channel it synchronously reads the next message in the stream, blocking until the message is read fully. Could throw CJCommunicationsException wrapping an IOException during read or parse

Specified by:

probeMessage in interface MessageReader<NativePacketHeader,NativePacketPayload>

Parameters:

reuse - Message object to reuse. May be ignored by implementation.

header - MessageHeader instance

Returns:

Message instance

Throws:

java.io.IOException - if an error occurs

getMessageSequence

public byte getMessageSequence()

Description copied from interface: MessageReader

Get last message sequence number, as it was stored by MessageReader.readHeader().

Specified by:

getMessageSequence in interface MessageReader<NativePacketHeader,NativePacketPayload>

Returns:

number

resetMessageSequence

public void resetMessageSequence()

Description copied from interface: MessageReader

Set stored message sequence number to 0.

Specified by:

resetMessageSequence in interface MessageReader<NativePacketHeader,NativePacketPayload>

undecorateAll

public MessageReader<NativePacketHeader,NativePacketPayload> undecorateAll()

Description copied from interface: MessageReader

Return a MessageReader instance free of decorators.

Specified by:

undecorateAll in interface MessageReader<NativePacketHeader,NativePacketPayload>

Returns:

MessageReader

undecorate

public MessageReader<NativePacketHeader,NativePacketPayload> undecorate()

Description copied from interface: MessageReader

Return the previous MessageReader instance from the decorators chain or the current MessageReader if it is the first entry in a chain.

Specified by:

undecorate in interface MessageReader<NativePacketHeader,NativePacketPayload>

Returns:

MessageReader