Skip to content

PollEndpointHandler Class

The transmitter's half of one poll exchange (RFC 8936, carried by SSF 1.0 Section 6.1.2): release what the receiver acknowledged, then answer with what waits. A host adapter owns routing, authentication and any long-poll waiting; this type answers from the queue as it is.

C#
public sealed class PollEndpointHandler

Inheritance System.Object → PollEndpointHandler

Constructors

PollEndpointHandler(IEventOutbox) Constructor

The transmitter's half of one poll exchange (RFC 8936, carried by SSF 1.0 Section 6.1.2): release what the receiver acknowledged, then answer with what waits. A host adapter owns routing, authentication and any long-poll waiting; this type answers from the queue as it is.

C#
public PollEndpointHandler(Abblix.SharedSignals.Transmitter.IEventOutbox outbox);

Parameters

outbox IEventOutbox

The queues being served.

Methods

PollEndpointHandler.HandleAsync(StreamState, PollRequest, CancellationToken) Method

Handles one poll request for one stream.

C#
public System.Threading.Tasks.Task<Abblix.SecurityEvents.Delivery.PollResponse> HandleAsync(Abblix.SharedSignals.Transmitter.StreamState stream, Abblix.SecurityEvents.Delivery.PollRequest request, System.Threading.CancellationToken cancellationToken=default(System.Threading.CancellationToken));

Parameters

stream StreamState

The stream being polled.

request Abblix.SecurityEvents.Delivery.PollRequest

What the receiver acknowledges and asks for.

cancellationToken System.Threading.CancellationToken

Cancels outbox I/O.

Returns

System.Threading.Tasks.Task<Abblix.SecurityEvents.Delivery.PollResponse>

Remarks

An acknowledgement releases retention, and only an acknowledgement does: RFC 8936 Section 2.2 says of "ack" that "the SET Transmitter is released from any obligation to retain the SET", and says no such thing of "setErrs". An error report is released only when the code says redelivery cannot change the answer - the same reading the push sender applies, so one registry does not decide two ways in one package. A receiver whose credentials lapsed reports "access_denied" and keeps its events. A stream that is not enabled serves nothing except status announcements - the pause holds events (SSF 1.0 Section 8.1.2.1), and the announcement is what Section 8.1.5 still owes the receiver after the stop.