Package one.nio.http

Interface EventSource<D>

All Superinterfaces:

AutoCloseable, Closeable

All Known Implementing Classes:

EventSourceResponse, HttpClient.ServerSentEventsReader

public interface EventSource<D>
extends Closeable

A source of server side emitted events

See Also:

• HTML Standard: 9.2 Server-sent events
• HttpClient.openEvents(Request, int)

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	EventSource.Event<D>	A single Server Sent Event, received from peer.

Method Summary

Modifier and Type	Method	Description
EventSource.Event<D>	poll()	Waits for the next SSE and returns an event.

Methods inherited from interface java.io.Closeable

close

Method Details

poll

EventSource.Event<D> poll()
                   throws IOException,
HttpException

Waits for the next SSE and returns an event. The method can block for a long time ( determined by server ). It is essential to check for null and EventSource.Event.isEmpty() before processing

Returns:

the next event from the stream or null, if stream was closed by either party

Throws:

IOException - an I/O exception occurred

HttpException - an incorrect HTTP request received