Package org.eclipse.jetty.websocket.server

Class NativeWebSocketConfiguration

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.websocket.server.NativeWebSocketConfiguration

All Implemented Interfaces:

Container, Destroyable, Dumpable, Dumpable.DumpableContainer, LifeCycle, MappedWebSocketCreator

public class NativeWebSocketConfiguration
extends ContainerLifeCycle
implements MappedWebSocketCreator

Interface for Configuring Jetty Server Native WebSockets

Only applicable if using WebSocketUpgradeFilter

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.Dumpable

Dumpable.DumpableContainer

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

LifeCycle.Listener

Field Summary

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

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Fields inherited from interface org.eclipse.jetty.util.component.Dumpable

KEY

Constructor Summary

Constructors

Constructor	Description
NativeWebSocketConfiguration(javax.servlet.ServletContext context)
NativeWebSocketConfiguration(WebSocketServerFactory webSocketServerFactory)

Method Summary

Modifier and Type	Method	Description
void	addMapping(java.lang.String rawspec, java.lang.Class<?> endpointClass)	Manually add a WebSocket mapping.
void	addMapping(java.lang.String rawspec, WebSocketCreator creator)	Add a mapping, of a pathspec to a WebSocketCreator.
void	addMapping(PathSpec pathSpec, java.lang.Class<?> endpointClass)	Manually add a WebSocket mapping.
void	addMapping(PathSpec pathSpec, WebSocketCreator creator)	Manually add a WebSocket mapping.
void	addMapping(PathSpec spec, WebSocketCreator creator)	Deprecated. use addMapping(PathSpec, WebSocketCreator) instead.
void	doStop()	Stops the managed lifecycle beans in the reverse order they were added.
WebSocketServerFactory	getFactory()	Get WebSocketServerFactory being used.
WebSocketCreator	getMapping(java.lang.String rawspec)	/** Returns the creator for the given path spec.
MappedResource<WebSocketCreator>	getMatch(java.lang.String target)	Deprecated. use getMatched(String) instead.
MatchedResource<WebSocketCreator>	getMatched(java.lang.String target)	Get the matching MatchedResource for the provided target.
WebSocketPolicy	getPolicy()	Used to configure the Default WebSocketPolicy used by all endpoints that don't redeclare the values.
boolean	removeMapping(java.lang.String rawspec)	Removes the mapping based on the given path spec.

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

addBean, addBean, addEventListener, addManaged, contains, destroy, doStart, dump, dump, dump, dump, dump, dumpBeans, dumpObject, dumpObjects, dumpStdErr, dumpThis, getBean, getBeans, getBeans, getContainedBeans, getContainedBeans, isAuto, isManaged, isUnmanaged, 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, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable

dumpSelf

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable.DumpableContainer

isDumpable

Constructor Detail

NativeWebSocketConfiguration

public NativeWebSocketConfiguration(javax.servlet.ServletContext context)

NativeWebSocketConfiguration

public NativeWebSocketConfiguration(WebSocketServerFactory webSocketServerFactory)

Method Detail

doStop

public void doStop()
            throws java.lang.Exception

Description copied from class: ContainerLifeCycle

Stops the managed lifecycle beans in the reverse order they were added.

Overrides:

doStop in class ContainerLifeCycle

Throws:

java.lang.Exception

getFactory

public WebSocketServerFactory getFactory()

Get WebSocketServerFactory being used.

Returns:

the WebSocketServerFactory being used.

getMatched

public MatchedResource<WebSocketCreator> getMatched(java.lang.String target)

Get the matching MatchedResource for the provided target.

Parameters:

target - the target path

Returns:

the matching resource, or null if no match.

getMatch

@Deprecated
public MappedResource<WebSocketCreator> getMatch(java.lang.String target)

Deprecated.

use getMatched(String) instead.

Get the matching MappedResource for the provided target.

Parameters:

target - the target path

Returns:

the matching resource, or null if no match.

getPolicy

public WebSocketPolicy getPolicy()

Used to configure the Default WebSocketPolicy used by all endpoints that don't redeclare the values.

Returns:

the default policy for all WebSockets

addMapping

public void addMapping(PathSpec pathSpec,
                       WebSocketCreator creator)

Manually add a WebSocket mapping.

If mapping is added before this configuration is started, then it is persisted through stop/start of this configuration's lifecycle. Otherwise it will be removed when this configuration is stopped.

Specified by:

addMapping in interface MappedWebSocketCreator

Parameters:

pathSpec - the pathspec to respond on

creator - the websocket creator to activate on the provided mapping.

addMapping

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

Deprecated.

use addMapping(PathSpec, WebSocketCreator) instead.

Manually add a WebSocket mapping.

Specified by:

addMapping in interface MappedWebSocketCreator

Parameters:

spec - the pathspec to respond on

creator - the websocket creator to activate on the provided mapping

addMapping

public void addMapping(PathSpec pathSpec,
                       java.lang.Class<?> endpointClass)

Manually add a WebSocket mapping.

Parameters:

pathSpec - the pathspec to respond on

endpointClass - the endpoint class to use for new upgrade requests on the provided pathspec (can be an WebSocket annotated POJO, or implementing WebSocketListener)

addMapping

public void addMapping(java.lang.String rawspec,
                       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:

rawspec - the path spec to use.

creator - the websocket creator for this specific mapping

getMapping

public WebSocketCreator getMapping(java.lang.String rawspec)

Description copied from interface: MappedWebSocketCreator

/** Returns the creator for the given path spec.

Specified by:

getMapping in interface MappedWebSocketCreator

Parameters:

rawspec - 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

removeMapping

public boolean removeMapping(java.lang.String rawspec)

Description copied from interface: MappedWebSocketCreator

Removes the mapping based on the given path spec.

Specified by:

removeMapping in interface MappedWebSocketCreator

Parameters:

rawspec - 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

addMapping

public void addMapping(java.lang.String rawspec,
                       java.lang.Class<?> endpointClass)

Manually add a WebSocket mapping.

Parameters:

rawspec - the pathspec to map to (see MappedWebSocketCreator.addMapping(String, WebSocketCreator) for syntax details)

endpointClass - the endpoint class to use for new upgrade requests on the provided pathspec (can be an WebSocket annotated POJO, or implementing WebSocketListener)