Package org.eclipse.jetty.servlets

Class EventSourceServlet

java.lang.Object

javax.servlet.GenericServlet

javax.servlet.http.HttpServlet

org.eclipse.jetty.servlets.EventSourceServlet

All Implemented Interfaces:

Servlet, ServletConfig

public abstract class EventSourceServlet
extends HttpServlet

A servlet that implements the event source protocol, also known as "server sent events".

This servlet must be subclassed to implement abstract method newEventSource(HttpServletRequest) to return an instance of EventSource that allows application to listen for event source events and to emit event source events.

This servlet supports the following configuration parameters:

• heartBeatPeriod, that specifies the heartbeat period, in seconds, used to check whether the connection has been closed by the client; defaults to 10 seconds.

NOTE: there is currently no support for last-event-id.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	EventSourceServlet.EventSourceEmitter

Constructor Summary

Constructors

Constructor	Description
EventSourceServlet()

Method Summary

Modifier and Type	Method	Description
void	destroy()
protected void	doGet(HttpServletRequest request, HttpServletResponse response)
void	init()
protected abstract EventSource	newEventSource(HttpServletRequest request)
protected void	open(EventSource eventSource, EventSource.Emitter emitter)
protected void	respond(HttpServletRequest request, HttpServletResponse response)

Methods inherited from class javax.servlet.GenericServlet

getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, log, log

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, doHead, doOptions, doPost, doPut, doTrace, getLastModified, service, service

Methods inherited from class java.lang.Object

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

Constructor Detail

EventSourceServlet

public EventSourceServlet()

Method Detail

init

public void init()
          throws ServletException

Overrides:

init in class GenericServlet

Throws:

ServletException

destroy

public void destroy()

Specified by:

destroy in interface Servlet

Overrides:

destroy in class GenericServlet

doGet

protected void doGet(HttpServletRequest request,
                     HttpServletResponse response)
              throws ServletException,
                     java.io.IOException

Overrides:

doGet in class HttpServlet

Throws:

ServletException

java.io.IOException

newEventSource

protected abstract EventSource newEventSource(HttpServletRequest request)

respond

protected void respond(HttpServletRequest request,
                       HttpServletResponse response)
                throws java.io.IOException

Throws:

java.io.IOException

open

protected void open(EventSource eventSource,
                    EventSource.Emitter emitter)
             throws java.io.IOException

Throws:

java.io.IOException