org.glassfish.jersey.media.sse
Class EventSource

java.lang.Object
  org.glassfish.jersey.media.sse.EventSource

All Implemented Interfaces:

EventListener

public class EventSource
extends java.lang.Object
implements EventListener

Client for reading and processing Server Sent InboundEvents.

When EventSource is created, it makes GET request to given URI and waits for incoming InboundEvents. Whenever any event is received, onEvent(InboundEvent) is called and listeners (if any) are notified (see addEventListener(String, EventListener) and addEventListener(String, EventListener).

Instances of this class are thread safe.

Author:

Pavel Bucek (pavel.bucek at oracle.com)

Constructor Summary

EventSource(WebTarget target)
Create new instance and start processing incoming InboundEvents in newly created single thread executor.

EventSource(WebTarget target, java.util.concurrent.ExecutorService executorService)
Create new instance and start processing incoming InboundEvents in provided ExecutorService.

Method Summary

void	addEventListener(EventListener listener) Add EventListener.
void	addEventListener(java.lang.String eventName, EventListener listener) Add EventListener which will be called only when InboundEvent with certain name is received.
void	close() Closes this event source.
void	onEvent(InboundEvent inboundEvent) Called when InboundEvent is received.

Methods inherited from class java.lang.Object

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

Constructor Detail

EventSource

public EventSource(WebTarget target)

Create new instance and start processing incoming InboundEvents in newly created single thread executor.

Parameters:

target - JAX-RS WebTarget instance which will be used to obtain InboundEvents.

EventSource

public EventSource(WebTarget target,
                   java.util.concurrent.ExecutorService executorService)

Create new instance and start processing incoming InboundEvents in provided ExecutorService.

Parameters:

target - JAX-RS WebTarget instance which will be used to obtain InboundEvents.

executorService - used for processing events.

Method Detail

addEventListener

public void addEventListener(EventListener listener)

Add EventListener.

Parameters:

listener - EventListener to add to current instance.

addEventListener

public void addEventListener(java.lang.String eventName,
                             EventListener listener)

Add EventListener which will be called only when InboundEvent with certain name is received.

Parameters:

eventName - InboundEvent name.

listener - EventListener to add to current instance.

onEvent

public void onEvent(InboundEvent inboundEvent)

Called when InboundEvent is received. Empty implementations, users can override this method to handle incoming InboundEvents. Please note that this is the ONLY way how to be absolutely sure that you won't miss any incoming InboundEvent. Initial request is made right after EventSource is created and processing starts immediately. EventListeners registered after InboundEvent is received won't be notified.

Specified by:

onEvent in interface EventListener

Parameters:

inboundEvent - received inboundEvent.

close

public void close()

Closes this event source.