org.eclipse.jetty.websocket.server

Class WebSocketServerFactory

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.websocket.server.WebSocketServerFactory

All Implemented Interfaces:

Container, Destroyable, Dumpable, LifeCycle, WebSocketContainerScope, WebSocketCreator, WebSocketServletFactory

public class WebSocketServerFactory
extends ContainerLifeCycle
implements WebSocketCreator, WebSocketContainerScope, WebSocketServletFactory

Factory to create WebSocket connections

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.websocket.servlet.WebSocketServletFactory

WebSocketServletFactory.Loader

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 inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
boolean	acceptWebSocket(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
boolean	acceptWebSocket(WebSocketCreator creator, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
void	addSessionFactory(SessionFactory sessionFactory)
void	cleanup()
WebSocketServletFactory	createFactory(WebSocketPolicy policy)
Object	createWebSocket(ServletUpgradeRequest req, ServletUpgradeResponse resp) Default Creator logic
protected void	doStart() Starts the managed lifecycle beans in the order they were added.
ByteBufferPool	getBufferPool() The configured Container Buffer Pool.
WebSocketCreator	getCreator()
EventDriverFactory	getEventDriverFactory()
Executor	getExecutor() Executor in use by the container.
ExtensionFactory	getExtensionFactory()
DecoratedObjectFactory	getObjectFactory() Object Factory used to create objects.
Collection<WebSocketSession>	getOpenSessions()
WebSocketPolicy	getPolicy() The policy the container is running on.
SslContextFactory	getSslContextFactory() The SslContextFactory in use by the container.
void	init(javax.servlet.ServletContext context)
void	init(ServletContextHandler context)
boolean	isUpgradeRequest(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
void	onSessionClosed(WebSocketSession session) A Session has been closed
void	onSessionOpened(WebSocketSession session) A Session has been opened
protected String[]	parseProtocols(String protocol)
void	register(Class<?> websocketPojo) Register a websocket class pojo with the default WebSocketCreator.
void	setCreator(WebSocketCreator creator)

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

addBean, addBean, addBean, addEventListener, addManaged, contains, destroy, doStop, dump, dump, 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, toString, wait, wait, wait

Constructor Detail

WebSocketServerFactory

public WebSocketServerFactory()

WebSocketServerFactory

public WebSocketServerFactory(WebSocketPolicy policy)

WebSocketServerFactory

public WebSocketServerFactory(ByteBufferPool bufferPool)

WebSocketServerFactory

public WebSocketServerFactory(WebSocketPolicy policy,
                              ByteBufferPool bufferPool)

Method Detail

acceptWebSocket

public boolean acceptWebSocket(javax.servlet.http.HttpServletRequest request,
                               javax.servlet.http.HttpServletResponse response)
                        throws IOException

Specified by:

acceptWebSocket in interface WebSocketServletFactory

Throws:

IOException

acceptWebSocket

public boolean acceptWebSocket(WebSocketCreator creator,
                               javax.servlet.http.HttpServletRequest request,
                               javax.servlet.http.HttpServletResponse response)
                        throws IOException

Specified by:

acceptWebSocket in interface WebSocketServletFactory

Throws:

IOException

addSessionFactory

public void addSessionFactory(SessionFactory sessionFactory)

cleanup

public void cleanup()

Specified by:

cleanup in interface WebSocketServletFactory

createFactory

public WebSocketServletFactory createFactory(WebSocketPolicy policy)

Specified by:

createFactory in interface WebSocketServletFactory

createWebSocket

public Object createWebSocket(ServletUpgradeRequest req,
                              ServletUpgradeResponse resp)

Default Creator logic

Specified by:

createWebSocket in interface WebSocketCreator

Parameters:

req - the request details

resp - the response details

Returns:

a websocket object to use, or null if no websocket should be created from this request.

doStart

protected void doStart()
                throws Exception

Description copied from class: ContainerLifeCycle

Starts the managed lifecycle beans in the order they were added.

Overrides:

doStart in class ContainerLifeCycle

Throws:

Exception

getBufferPool

public ByteBufferPool getBufferPool()

Description copied from interface: WebSocketContainerScope

The configured Container Buffer Pool.

Specified by:

getBufferPool in interface WebSocketContainerScope

Returns:

the buffer pool (never null)

getCreator

public WebSocketCreator getCreator()

Specified by:

getCreator in interface WebSocketServletFactory

getExecutor

public Executor getExecutor()

Description copied from interface: WebSocketContainerScope

Executor in use by the container.

Specified by:

getExecutor in interface WebSocketContainerScope

Returns:

the Executor in use by the container.

getObjectFactory

public DecoratedObjectFactory getObjectFactory()

Description copied from interface: WebSocketContainerScope

Object Factory used to create objects.

Specified by:

getObjectFactory in interface WebSocketContainerScope

Returns:

Object Factory used to create instances of objects.

getEventDriverFactory

public EventDriverFactory getEventDriverFactory()

getExtensionFactory

public ExtensionFactory getExtensionFactory()

Specified by:

getExtensionFactory in interface WebSocketServletFactory

getOpenSessions

public Collection<WebSocketSession> getOpenSessions()

getPolicy

public WebSocketPolicy getPolicy()

Description copied from interface: WebSocketContainerScope

The policy the container is running on.

Specified by:

getPolicy in interface WebSocketContainerScope

Specified by:

getPolicy in interface WebSocketServletFactory

Returns:

the websocket policy

getSslContextFactory

public SslContextFactory getSslContextFactory()

Description copied from interface: WebSocketContainerScope

The SslContextFactory in use by the container.

Specified by:

getSslContextFactory in interface WebSocketContainerScope

Returns:

the SslContextFactory in use by the container (can be null if no SSL context is defined)

init

public void init(ServletContextHandler context)
          throws javax.servlet.ServletException

Throws:

javax.servlet.ServletException

init

public void init(javax.servlet.ServletContext context)
          throws javax.servlet.ServletException

Specified by:

init in interface WebSocketServletFactory

Throws:

javax.servlet.ServletException

isUpgradeRequest

public boolean isUpgradeRequest(javax.servlet.http.HttpServletRequest request,
                                javax.servlet.http.HttpServletResponse response)

Specified by:

isUpgradeRequest in interface WebSocketServletFactory

onSessionClosed

public void onSessionClosed(WebSocketSession session)

Description copied from interface: WebSocketContainerScope

A Session has been closed

Specified by:

onSessionClosed in interface WebSocketContainerScope

Parameters:

session - the session that was closed

onSessionOpened

public void onSessionOpened(WebSocketSession session)

Description copied from interface: WebSocketContainerScope

A Session has been opened

Specified by:

onSessionOpened in interface WebSocketContainerScope

Parameters:

session - the session that was opened

parseProtocols

protected String[] parseProtocols(String protocol)

register

public void register(Class<?> websocketPojo)

Description copied from interface: WebSocketServletFactory

Register a websocket class pojo with the default WebSocketCreator.

Note: only required if using the default WebSocketCreator provided by this factory.

Specified by:

register in interface WebSocketServletFactory

Parameters:

websocketPojo - the class to instantiate for each incoming websocket upgrade request.

setCreator

public void setCreator(WebSocketCreator creator)

Specified by:

setCreator in interface WebSocketServletFactory