org.jenkinsci.remoting.protocol.impl

Class AckFilterLayer

java.lang.Object

org.jenkinsci.remoting.protocol.FilterLayer

org.jenkinsci.remoting.protocol.impl.AckFilterLayer

All Implemented Interfaces:

ProtocolLayer, ProtocolLayer.Recv, ProtocolLayer.Send

public class AckFilterLayer
extends FilterLayer

A FilterLayer that ensures both sides will not proceed unless the acknowledgement has been sent and received by both sides.

Since:

3.0

Nested Class Summary

Nested classes/interfaces inherited from interface org.jenkinsci.remoting.protocol.ProtocolLayer

ProtocolLayer.Recv, ProtocolLayer.Send

Field Summary

Fields inherited from interface org.jenkinsci.remoting.protocol.ProtocolLayer

EMPTY_BUFFER

Constructor Summary

Constructors

Constructor and Description
AckFilterLayer() Default constructor.
AckFilterLayer(String ack) Constructor using a custom acknowledgement string.

Method Summary

Modifier and Type	Method and Description
void	doSend(ByteBuffer data) SPI: Sends data to the lower layer.
boolean	isRecvOpen() Tracks if this layer is accepting received data via ProtocolLayer.Recv.onRecv(ByteBuffer).
void	onRecv(ByteBuffer data) SPI: Callback on data being received from the lower layer.
void	onRecvClosed(IOException cause) Callback on the lower layer's source of data being closed.
void	start() Starts this layer.

Methods inherited from class org.jenkinsci.remoting.protocol.FilterLayer

abort, completed, doCloseSend, flushRecv, flushSend, init, isSendOpen, next, stack

Methods inherited from class java.lang.Object

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

Constructor Detail

AckFilterLayer

public AckFilterLayer()

Default constructor.

AckFilterLayer

public AckFilterLayer(String ack)

Constructor using a custom acknowledgement string.

Parameters:

ack - the acknowledgement string.

Method Detail

start

public void start()
           throws IOException

Starts this layer. All layers in the stack will be initialized before a call to this method. All lower layers in the stack will have been started before this layer is started.

Specified by:

start in interface ProtocolLayer

Overrides:

start in class FilterLayer

Throws:

IOException - if something goes wrong.

onRecv

public void onRecv(@NonNull
                   ByteBuffer data)
            throws IOException

SPI: Callback on data being received from the lower layer.

Specified by:

onRecv in interface ProtocolLayer.Recv

Specified by:

onRecv in class FilterLayer

Parameters:

data - the data received. Any data consumed from the ByteBuffer can be assumed as processed. Any data not consumed from the ByteBuffer will be the responsibility of the caller to resubmit in subsequent calls.

Throws:

IOException - if there was an error during processing of the received data.

onRecvClosed

public void onRecvClosed(IOException cause)
                  throws IOException

Callback on the lower layer's source of data being closed.

Specified by:

onRecvClosed in interface ProtocolLayer.Recv

Overrides:

onRecvClosed in class FilterLayer

Parameters:

cause - the cause of the lower layer being closed or null.

Throws:

IOException - if there was an error during the processing of the close notification.

isRecvOpen

public boolean isRecvOpen()

Tracks if this layer is accepting received data via ProtocolLayer.Recv.onRecv(ByteBuffer). Once this method returns false it must always return false and can be assumed to behave in this way.

Specified by:

isRecvOpen in interface ProtocolLayer.Recv

Overrides:

isRecvOpen in class FilterLayer

Returns:

true if accepting received data via ProtocolLayer.Recv.onRecv(ByteBuffer).

doSend

public void doSend(@NonNull
                   ByteBuffer data)
            throws IOException

SPI: Sends data to the lower layer.

Specified by:

doSend in interface ProtocolLayer.Send

Specified by:

doSend in class FilterLayer

Parameters:

data - the data to send. Any data consumed from the ByteBuffer can be assumed as processed. Any data not consumed from the ByteBuffer will be the responsibility of the caller to resubmit in subsequent calls.

Throws:

IOException - if there was an error during processing of the data.