org.eclipse.jetty.websocket.server

Class WebSocketUpgradeFilter

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.websocket.server.WebSocketUpgradeFilter

All Implemented Interfaces:

javax.servlet.Filter, Container, Destroyable, Dumpable, LifeCycle, MappedWebSocketCreator

@ManagedObject(value="WebSocket Upgrade Filter")
public class WebSocketUpgradeFilter
extends ContainerLifeCycle
implements javax.servlet.Filter, MappedWebSocketCreator, Dumpable

Inline Servlet Filter to capture WebSocket upgrade requests and perform path mappings to WebSocketCreator objects.

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

Container.InheritedListener, Container.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONTEXT_ATTRIBUTE_KEY

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
WebSocketUpgradeFilter()
WebSocketUpgradeFilter(WebSocketPolicy policy, ByteBufferPool bufferPool)

Method Summary

Modifier and Type	Method and Description
void	addMapping(PathSpec spec, WebSocketCreator creator)
static WebSocketUpgradeFilter	configureContext(javax.servlet.ServletContext context)
static WebSocketUpgradeFilter	configureContext(ServletContextHandler context)
void	destroy() Destroys the managed Destroyable beans in the reverse order they were added.
void	doFilter(javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, javax.servlet.FilterChain chain)
String	dump()
void	dump(Appendable out, String indent)
WebSocketServerFactory	getFactory()
PathMappings<WebSocketCreator>	getMappings()
void	init(javax.servlet.FilterConfig config)
void	setToAttribute(javax.servlet.ServletContext context, String key)
String	toString()

Methods inherited from class org.eclipse.jetty.util.component.ContainerLifeCycle

addBean, addBean, addBean, addEventListener, addManaged, contains, doStart, doStop, dump, dump, dump, dumpBeans, dumpObject, dumpStdErr, dumpThis, getBean, getBeans, getBeans, isManaged, manage, removeBean, removeBeans, removeEventListener, setBeans, setStopTimeout, start, stop, unmanage, updateBean, updateBean, updateBeans

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Methods inherited from class java.lang.Object

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

Field Detail

CONTEXT_ATTRIBUTE_KEY

public static final String CONTEXT_ATTRIBUTE_KEY

See Also:

Constant Field Values

Constructor Detail

WebSocketUpgradeFilter

public WebSocketUpgradeFilter()

WebSocketUpgradeFilter

public WebSocketUpgradeFilter(WebSocketPolicy policy,
                              ByteBufferPool bufferPool)

Method Detail

configureContext

public static WebSocketUpgradeFilter configureContext(ServletContextHandler context)
                                               throws javax.servlet.ServletException

Throws:

javax.servlet.ServletException

configureContext

public static WebSocketUpgradeFilter configureContext(javax.servlet.ServletContext context)
                                               throws javax.servlet.ServletException

Throws:

javax.servlet.ServletException

addMapping

public void addMapping(PathSpec spec,
                       WebSocketCreator creator)

Specified by:

addMapping in interface MappedWebSocketCreator

destroy

public void destroy()

Description copied from class: ContainerLifeCycle

Destroys the managed Destroyable beans in the reverse order they were added.

Specified by:

destroy in interface javax.servlet.Filter

Specified by:

destroy in interface Destroyable

Overrides:

destroy in class ContainerLifeCycle

doFilter

public void doFilter(javax.servlet.ServletRequest request,
                     javax.servlet.ServletResponse response,
                     javax.servlet.FilterChain chain)
              throws IOException,
                     javax.servlet.ServletException

Specified by:

doFilter in interface javax.servlet.Filter

Throws:

IOException

javax.servlet.ServletException

dump

public String dump()

Specified by:

dump in interface Dumpable

Overrides:

dump in class ContainerLifeCycle

dump

public void dump(Appendable out,
                 String indent)
          throws IOException

Specified by:

dump in interface Dumpable

Overrides:

dump in class ContainerLifeCycle

Throws:

IOException

getFactory

public WebSocketServerFactory getFactory()

getMappings

@ManagedAttribute(value="mappings",
                  readonly=true)
public PathMappings<WebSocketCreator> getMappings()

Specified by:

getMappings in interface MappedWebSocketCreator

init

public void init(javax.servlet.FilterConfig config)
          throws javax.servlet.ServletException

Specified by:

init in interface javax.servlet.Filter

Throws:

javax.servlet.ServletException

setToAttribute

public void setToAttribute(javax.servlet.ServletContext context,
                           String key)
                    throws javax.servlet.ServletException

Throws:

javax.servlet.ServletException

toString

public String toString()

Overrides:

toString in class Object