org.eclipse.jetty.websocket.server

Class WebSocketUpgradeFilter

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.websocket.server.WebSocketUpgradeFilter

All Implemented Interfaces:

javax.servlet.Filter, org.eclipse.jetty.util.component.Dumpable, org.eclipse.jetty.util.component.LifeCycle, MappedWebSocketCreator

@ManagedObject(value="WebSocket Upgrade Filter")
public class WebSocketUpgradeFilter
extends org.eclipse.jetty.util.component.AbstractLifeCycle
implements javax.servlet.Filter, MappedWebSocketCreator, org.eclipse.jetty.util.component.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

org.eclipse.jetty.util.component.AbstractLifeCycle.AbstractLifeCycleListener

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

org.eclipse.jetty.util.component.LifeCycle.Listener

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONFIG_ATTRIBUTE_KEY
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(NativeWebSocketConfiguration configuration)
WebSocketUpgradeFilter(org.eclipse.jetty.websocket.api.WebSocketPolicy policy, org.eclipse.jetty.io.ByteBufferPool bufferPool)

Method Summary

Methods

Modifier and Type	Method and Description
void	addMapping(PathSpec spec, WebSocketCreator creator) Add a mapping.
void	addMapping(PathSpec spec, WebSocketCreator creator) Deprecated.
void	addMapping(String spec, WebSocketCreator creator) Add a mapping, of a pathspec to a WebSocketCreator.
static WebSocketUpgradeFilter	configureContext(javax.servlet.ServletContext context) Deprecated. use configureContext(ServletContextHandler) instead
static WebSocketUpgradeFilter	configureContext(ServletContextHandler context)
void	destroy()
void	doFilter(javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, javax.servlet.FilterChain chain)
String	dump()
void	dump(Appendable out, String indent)
NativeWebSocketConfiguration	getConfiguration()
WebSocketServletFactory	getFactory()
WebSocketCreator	getMapping(String target) Returns the creator for the given path spec.
PathMappings<WebSocketCreator>	getMappings() Deprecated.
void	init(javax.servlet.FilterConfig config)
boolean	removeMapping(String spec) Removes the mapping based on the given path spec.
void	setToAttribute(javax.servlet.ServletContext context, String key)
String	toString()

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

addLifeCycleListener, doStart, doStop, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, setStopTimeout, 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

CONFIG_ATTRIBUTE_KEY

public static final String CONFIG_ATTRIBUTE_KEY

See Also:

Constant Field Values

Constructor Detail

WebSocketUpgradeFilter

public WebSocketUpgradeFilter()

WebSocketUpgradeFilter

public WebSocketUpgradeFilter(org.eclipse.jetty.websocket.api.WebSocketPolicy policy,
                      org.eclipse.jetty.io.ByteBufferPool bufferPool)

WebSocketUpgradeFilter

public WebSocketUpgradeFilter(NativeWebSocketConfiguration configuration)

Method Detail

configureContext

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

Throws:

javax.servlet.ServletException

configureContext

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

Deprecated. use configureContext(ServletContextHandler) instead

Throws:

javax.servlet.ServletException

addMapping

public void addMapping(PathSpec spec,
              WebSocketCreator creator)

Description copied from interface: MappedWebSocketCreator

Add a mapping.

Specified by:

addMapping in interface MappedWebSocketCreator

Parameters:

spec - the path spec to use

creator - the creator for the mapping

addMapping

@Deprecated
public void addMapping(PathSpec spec,
                         WebSocketCreator creator)

Deprecated.

Description copied from interface: MappedWebSocketCreator

Add a mapping.

Specified by:

addMapping in interface MappedWebSocketCreator

Parameters:

spec - the path spec to use

creator - the creator for the mapping

addMapping

public void addMapping(String spec,
              WebSocketCreator creator)

Description copied from interface: MappedWebSocketCreator

Add a mapping, of a pathspec to a WebSocketCreator.

Recognized Path Spec syntaxes

/path/to or / or *.ext or servlet|{spec}

Servlet Syntax

^{spec} or regex|{spec}

Regex Syntax

uri-template|{spec}

URI Template (see JSR356 and RFC6570 level 1)

Specified by:

addMapping in interface MappedWebSocketCreator

Parameters:

spec - the path spec to use.

creator - the websocket creator for this specific mapping

removeMapping

public boolean removeMapping(String spec)

Description copied from interface: MappedWebSocketCreator

Removes the mapping based on the given path spec.

Specified by:

removeMapping in interface MappedWebSocketCreator

Parameters:

spec - the path spec to remove (using the same spec syntax as seen in MappedWebSocketCreator.addMapping(String, WebSocketCreator))

Returns:

true if underlying mapping were altered, false otherwise

destroy

public void destroy()

Specified by:

destroy in interface javax.servlet.Filter

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 org.eclipse.jetty.util.component.Dumpable

dump

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

Specified by:

dump in interface org.eclipse.jetty.util.component.Dumpable

Throws:

IOException

getFactory

public WebSocketServletFactory getFactory()

getConfiguration

@ManagedAttribute(value="configuration",
                  readonly=true)
public NativeWebSocketConfiguration getConfiguration()

getMapping

public WebSocketCreator getMapping(String target)

Description copied from interface: MappedWebSocketCreator

Returns the creator for the given path spec.

Specified by:

getMapping in interface MappedWebSocketCreator

Parameters:

target - @param spec the spec to test for (using the same spec syntax as seen in MappedWebSocketCreator.addMapping(String, WebSocketCreator))

Returns:

the websocket creator if path spec exists, or null

getMappings

@Deprecated
public PathMappings<WebSocketCreator> getMappings()

Deprecated.

Description copied from interface: MappedWebSocketCreator

Get all of the PathMappings declared.

Specified by:

getMappings in interface MappedWebSocketCreator

Returns:

the PathMappings

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