org.atmosphere.cpr

Class AtmosphereFramework

java.lang.Object

org.atmosphere.cpr.AtmosphereFramework

All Implemented Interfaces:

ServletContextProvider

public class AtmosphereFramework
extends java.lang.Object
implements ServletContextProvider

The AtmosphereFramework is the entry point for the framework. This class can be used to from Servlet/filter to dispatch AtmosphereRequest and AtmosphereResponse. The framework can also be configured using the setXXX method. The life cycle of this class is

 AtmosphereFramework f = new AtmosphereFramework();
 f.init();
 f.doCometSupport(AtmosphereRequest, AtmosphereResource);
 f.destroy();
 

Author:

Jeanfrancois Arcand

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AtmosphereFramework.AtmosphereHandlerWrapper

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	annotationProcessorClassName
protected AsyncSupport	asyncSupport
protected java.util.List<AsyncSupportListener>	asyncSupportListeners
protected java.lang.String	atmosphereDotXmlPath
protected java.util.Map<java.lang.String,AtmosphereFramework.AtmosphereHandlerWrapper>	atmosphereHandlers
protected boolean	autoDetectHandlers
protected java.lang.String	broadcasterCacheClassName
protected java.lang.String	broadcasterClassName
protected BroadcasterFactory	broadcasterFactory
protected java.lang.String	broadcasterFactoryClassName
protected java.util.List<java.lang.String>	broadcasterFilters
protected java.lang.String	broadcasterLifeCyclePolicy
protected java.util.List<BroadcasterListener>	broadcasterListeners
protected java.util.concurrent.ConcurrentLinkedQueue<java.lang.String>	broadcasterTypes
protected AtmosphereConfig	config
static java.lang.String	DEFAULT_ATMOSPHERE_CONFIG_PATH
static java.lang.String	DEFAULT_LIB_PATH
protected java.lang.String	handlersPath
protected java.util.HashMap<java.lang.String,java.lang.String>	initParams
protected java.util.LinkedList<AtmosphereInterceptor>	interceptors
protected boolean	isBroadcasterSpecified
protected java.util.concurrent.atomic.AtomicBoolean	isCometSupportConfigured
protected boolean	isCometSupportSpecified
protected boolean	isFilter
protected boolean	isInit
protected boolean	isSessionSupportSpecified
protected java.lang.String	libPath
protected static org.slf4j.Logger	logger
static java.lang.String	MAPPING_REGEX
protected java.util.List<java.lang.String>	packages
protected java.util.ArrayList<java.lang.String>	possibleComponentsCandidate
protected boolean	scanDone
protected javax.servlet.ServletConfig	servletConfig
protected boolean	sharedThreadPools
protected boolean	useBlockingImplementation
protected boolean	useNativeImplementation
protected boolean	useStreamForFlushingComments
protected boolean	webSocketEnabled
protected java.lang.String	webSocketProcessorClassName
protected WebSocketProtocol	webSocketProtocol
protected java.lang.String	webSocketProtocolClassName

Constructor Summary

Constructors

Constructor and Description
AtmosphereFramework() Create an AtmosphereFramework.
AtmosphereFramework(boolean isFilter, boolean autoDetectHandlers) Create an AtmosphereFramework.
AtmosphereFramework(javax.servlet.ServletConfig sc) Create an AtmosphereFramework and initialize it via init(javax.servlet.ServletConfig)

Method Summary

Methods

Modifier and Type	Method and Description
AtmosphereFramework	addAnnotationPackage(java.lang.Class<?> clazz) Add support for package detecttion of Atmosphere's Component.
AtmosphereFramework	addAtmosphereHandler(java.lang.String mapping, AtmosphereHandler h) Add an AtmosphereHandler serviced by the Servlet This API is exposed to allow embedding an Atmosphere application.
AtmosphereFramework	addAtmosphereHandler(java.lang.String mapping, AtmosphereHandler h, Broadcaster broadcaster) Add an AtmosphereHandler serviced by the Servlet This API is exposed to allow embedding an Atmosphere application.
AtmosphereFramework	addAtmosphereHandler(java.lang.String mapping, AtmosphereHandler h, Broadcaster broadcaster, java.util.List<AtmosphereInterceptor> l) Add an AtmosphereHandler serviced by the Servlet This API is exposed to allow embedding an Atmosphere application.
AtmosphereFramework	addAtmosphereHandler(java.lang.String mapping, AtmosphereHandler h, java.util.List<AtmosphereInterceptor> l) Add an AtmosphereHandler serviced by the Servlet This API is exposed to allow embedding an Atmosphere application.
AtmosphereFramework	addAtmosphereHandler(java.lang.String mapping, AtmosphereHandler h, java.lang.String broadcasterId) Add an AtmosphereHandler serviced by the Servlet This API is exposed to allow embedding an Atmosphere application.
AtmosphereFramework	addAtmosphereHandler(java.lang.String mapping, AtmosphereHandler h, java.lang.String broadcasterId, java.util.List<AtmosphereInterceptor> l) Add an AtmosphereHandler serviced by the Servlet This API is exposed to allow embedding an Atmosphere application.
AtmosphereFramework	addBroadcasterListener(BroadcasterListener b) Add BroadcasterListener to all created Broadcaster
AtmosphereFramework	addBroadcasterType(java.lang.String broadcasterTypeString) Add a new Broadcaster class name AtmosphereServlet can use when initializing requests, and when atmosphere.xml broadcaster element is unspecified.
AtmosphereFramework	addInitParameter(java.lang.String name, java.lang.String value) Add init-param like if they were defined in web.xml
protected void	analytics()
AtmosphereFramework	annotationProcessorClassName(java.lang.String annotationProcessorClassName) Set the AnnotationProcessor class name.
AtmosphereFramework	asyncSupportListener(AsyncSupportListener asyncSupportListener) Add an AsyncSupportListener
java.util.List<AsyncSupportListener>	asyncSupportListeners() Return the list of an AsyncSupportListener
protected void	autoConfigureService(javax.servlet.ServletContext sc)
void	autoDetectAtmosphereHandlers(javax.servlet.ServletContext servletContext, java.net.URLClassLoader classloader) Auto detect instance of AtmosphereHandler in case META-INF/atmosphere.xml is missing.
protected void	autoDetectContainer() Auto detect the underlying Servlet Container we are running on.
protected void	autoDetectWebSocketHandler(javax.servlet.ServletContext servletContext, java.net.URLClassLoader classloader) Auto detect instance of WebSocketHandler in case META-INF/atmosphere.xml is missing.
java.util.List<java.lang.String>	broadcasterFilters() Return the list of BroadcastFilter
protected void	configureAtmosphereInterceptor(javax.servlet.ServletConfig sc) Configure the list of AtmosphereInterceptor.
protected void	configureBroadcaster()
protected void	configureBroadcasterFactory()
protected java.util.Map<java.lang.String,java.lang.String>	configureQueryStringAsRequest(AtmosphereRequest request)
protected void	configureScanningPackage(javax.servlet.ServletConfig sc)
protected void	configureWebDotXmlAtmosphereHandler(javax.servlet.ServletConfig sc)
protected AsyncSupportResolver	createAsyncSupportResolver() Returns an instance of AsyncSupportResolver AsyncSupportResolver
AtmosphereFramework	destroy()
protected boolean	detectSupportedFramework(javax.servlet.ServletConfig sc) Auto-detect Jersey when no atmosphere.xml file are specified.
Action	doCometSupport(AtmosphereRequest req, AtmosphereResponse res) Invoke the proprietary AsyncSupport
protected void	doInitParams(javax.servlet.ServletConfig sc) Read init param from web.xml and apply them.
protected void	doInitParamsForWebSocket(javax.servlet.ServletConfig sc)
AsyncSupport	getAsyncSupport() Return the current AsyncSupport
AtmosphereConfig	getAtmosphereConfig() Return a configured instance of AtmosphereConfig
java.lang.String	getAtmosphereDotXmlPath()
java.util.Map<java.lang.String,AtmosphereFramework.AtmosphereHandlerWrapper>	getAtmosphereHandlers()
java.lang.String	getBroadcasterCacheClassName() Return the BroadcasterCache class name.
BroadcasterFactory	getBroadcasterFactory() Get the BroadcasterFactory which is used by Atmosphere to construct Broadcaster
AsyncSupport	getCometSupport() Deprecated. Use getAsyncSupport
java.lang.String	getDefaultBroadcasterClassName() Return the default Broadcaster class name.
java.lang.String	getHandlersPath()
java.lang.String	getLibPath() Return the location of the jars containing the application classes.
javax.servlet.ServletConfig	getServletConfig()
javax.servlet.ServletContext	getServletContext()
java.lang.String	getWebSocketProcessorClassName()
WebSocketProtocol	getWebSocketProtocol()
java.lang.String	getWebSocketProtocolClassName()
AtmosphereFramework	init() Initialize the AtmosphereFramework.
AtmosphereFramework	init(javax.servlet.ServletConfig sc) Initialize the AtmosphereFramework using the ServletContext
void	initAtmosphereHandler(javax.servlet.ServletConfig sc) Initialize AtmosphereServletProcessor
protected void	initWebSocket()
AtmosphereFramework	interceptor(AtmosphereInterceptor c) Add an AtmosphereInterceptor implementation.
java.util.LinkedList<AtmosphereInterceptor>	interceptors() Return the list of AtmosphereInterceptor
protected boolean	isIECandidate(AtmosphereRequest request)
boolean	isShareExecutorServices() Returns true if ExecutorService shared amongst all components.
boolean	isUseBlockingImplementation()
boolean	isUseNativeImplementation()
boolean	isUseStreamForFlushingComments() true if Atmosphere uses AtmosphereResponse.getOutputStream() by default for write operation.
protected void	loadAtmosphereDotXml(java.io.InputStream stream, java.net.URLClassLoader c) Load AtmosphereHandler defined under META-INF/atmosphere.xml
void	loadAtmosphereHandlersFromPath(java.net.URLClassLoader classloader, java.lang.String realPath)
void	loadConfiguration(javax.servlet.ServletConfig sc)
protected void	loadWebSocketFromPath(java.net.URLClassLoader classloader, java.lang.String realPath)
protected java.lang.String	lookupDefaultBroadcasterType(java.lang.String defaultB)
protected AtmosphereInterceptor	newAInterceptor(java.lang.Class<? extends AtmosphereInterceptor> a)
protected void	notify(Action.TYPE type, AtmosphereRequest request, AtmosphereResponse response)
void	patchContainer() Path specific container using their own property.
protected void	readSystemProperties()
AtmosphereFramework	removeAllAtmosphereHandler() Remove all AtmosphereHandler
AtmosphereFramework	removeAllInitParams() Remove all init parameters.
AtmosphereFramework	removeAtmosphereHandler(java.lang.String mapping) Remove an AtmosphereHandler
protected void	sessionSupport(boolean sessionSupport)
AtmosphereFramework	setAsyncSupport(AsyncSupport asyncSupport) Set the AsyncSupport implementation.
AtmosphereFramework	setAtmosphereDotXmlPath(java.lang.String atmosphereDotXmlPath)
void	setBroadcasterCacheClassName(java.lang.String broadcasterCacheClassName) Set the BroadcasterCache class name.
AtmosphereFramework	setBroadcasterFactory(BroadcasterFactory broadcasterFactory) Set the BroadcasterFactory which is used by Atmosphere to construct Broadcaster
AtmosphereFramework	setCometSupport(AsyncSupport asyncSupport)
AtmosphereFramework	setDefaultBroadcasterClassName(java.lang.String bccn) Set the default Broadcaster class name
AtmosphereFramework	setHandlersPath(java.lang.String handlersPath)
AtmosphereFramework	setLibPath(java.lang.String libPath) Set the location of the jars containing the application.
AtmosphereFramework	setUseBlockingImplementation(boolean useBlockingImplementation)
AtmosphereFramework	setUseNativeImplementation(boolean useNativeImplementation)
AtmosphereFramework	setUseStreamForFlushingComments(boolean useStreamForFlushingComments) Set to true so Atmosphere uses AtmosphereResponse.getOutputStream() by default for write operation.
AtmosphereFramework	setWebsocketProcessorClassName(java.lang.String webSocketProcessorClassName)
AtmosphereFramework	setWebSocketProtocolClassName(java.lang.String webSocketProtocolClassName)
AtmosphereFramework	shareExecutorServices(boolean sharedThreadPools) Set to true to have a ExecutorService shared amongst all components.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_ATMOSPHERE_CONFIG_PATH

public static final java.lang.String DEFAULT_ATMOSPHERE_CONFIG_PATH

See Also:

Constant Field Values

DEFAULT_LIB_PATH

public static final java.lang.String DEFAULT_LIB_PATH

See Also:

Constant Field Values

MAPPING_REGEX

public static final java.lang.String MAPPING_REGEX

See Also:

Constant Field Values

logger

protected static final org.slf4j.Logger logger

broadcasterFilters

protected final java.util.List<java.lang.String> broadcasterFilters

asyncSupportListeners

protected final java.util.List<AsyncSupportListener> asyncSupportListeners

possibleComponentsCandidate

protected final java.util.ArrayList<java.lang.String> possibleComponentsCandidate

initParams

protected final java.util.HashMap<java.lang.String,java.lang.String> initParams

config

protected final AtmosphereConfig config

isCometSupportConfigured

protected final java.util.concurrent.atomic.AtomicBoolean isCometSupportConfigured

isFilter

protected final boolean isFilter

atmosphereHandlers

protected final java.util.Map<java.lang.String,AtmosphereFramework.AtmosphereHandlerWrapper> atmosphereHandlers

broadcasterTypes

protected final java.util.concurrent.ConcurrentLinkedQueue<java.lang.String> broadcasterTypes

useNativeImplementation

protected boolean useNativeImplementation

useBlockingImplementation

protected boolean useBlockingImplementation

useStreamForFlushingComments

protected boolean useStreamForFlushingComments

asyncSupport

protected AsyncSupport asyncSupport

broadcasterClassName

protected java.lang.String broadcasterClassName

isCometSupportSpecified

protected boolean isCometSupportSpecified

isBroadcasterSpecified

protected boolean isBroadcasterSpecified

isSessionSupportSpecified

protected boolean isSessionSupportSpecified

broadcasterFactory

protected BroadcasterFactory broadcasterFactory

broadcasterFactoryClassName

protected java.lang.String broadcasterFactoryClassName

broadcasterCacheClassName

protected java.lang.String broadcasterCacheClassName

webSocketEnabled

protected boolean webSocketEnabled

broadcasterLifeCyclePolicy

protected java.lang.String broadcasterLifeCyclePolicy

webSocketProtocolClassName

protected java.lang.String webSocketProtocolClassName

webSocketProtocol

protected WebSocketProtocol webSocketProtocol

handlersPath

protected java.lang.String handlersPath

servletConfig

protected javax.servlet.ServletConfig servletConfig

autoDetectHandlers

protected boolean autoDetectHandlers

atmosphereDotXmlPath

protected java.lang.String atmosphereDotXmlPath

interceptors

protected final java.util.LinkedList<AtmosphereInterceptor> interceptors

scanDone

protected boolean scanDone

annotationProcessorClassName

protected java.lang.String annotationProcessorClassName

broadcasterListeners

protected final java.util.List<BroadcasterListener> broadcasterListeners

webSocketProcessorClassName

protected java.lang.String webSocketProcessorClassName

libPath

protected java.lang.String libPath

isInit

protected boolean isInit

sharedThreadPools

protected boolean sharedThreadPools

packages

protected final java.util.List<java.lang.String> packages

Constructor Detail

AtmosphereFramework

public AtmosphereFramework()

Create an AtmosphereFramework.

AtmosphereFramework

public AtmosphereFramework(javax.servlet.ServletConfig sc)
                    throws javax.servlet.ServletException

Create an AtmosphereFramework and initialize it via init(javax.servlet.ServletConfig)

Throws:

javax.servlet.ServletException

AtmosphereFramework

public AtmosphereFramework(boolean isFilter,
                   boolean autoDetectHandlers)

Create an AtmosphereFramework.

Parameters:

isFilter - true if this instance is used as an AtmosphereFilter

Method Detail

addAtmosphereHandler

public AtmosphereFramework addAtmosphereHandler(java.lang.String mapping,
                                       AtmosphereHandler h,
                                       java.util.List<AtmosphereInterceptor> l)

Add an AtmosphereHandler serviced by the Servlet This API is exposed to allow embedding an Atmosphere application.

Parameters:

mapping - The servlet mapping (servlet path)

h - implementation of an AtmosphereHandler

l - An attay of AtmosphereInterceptor

addAtmosphereHandler

public AtmosphereFramework addAtmosphereHandler(java.lang.String mapping,
                                       AtmosphereHandler h)

Add an AtmosphereHandler serviced by the Servlet This API is exposed to allow embedding an Atmosphere application.

Parameters:

mapping - The servlet mapping (servlet path)

h - implementation of an AtmosphereHandler

addAtmosphereHandler

public AtmosphereFramework addAtmosphereHandler(java.lang.String mapping,
                                       AtmosphereHandler h,
                                       java.lang.String broadcasterId,
                                       java.util.List<AtmosphereInterceptor> l)

Add an AtmosphereHandler serviced by the Servlet This API is exposed to allow embedding an Atmosphere application.

Parameters:

mapping - The servlet mapping (servlet path)

h - implementation of an AtmosphereHandler

broadcasterId - The Broadcaster.getID() value.

l - An attay of AtmosphereInterceptor

addAtmosphereHandler

public AtmosphereFramework addAtmosphereHandler(java.lang.String mapping,
                                       AtmosphereHandler h,
                                       java.lang.String broadcasterId)

Add an AtmosphereHandler serviced by the Servlet This API is exposed to allow embedding an Atmosphere application.

Parameters:

mapping - The servlet mapping (servlet path)

h - implementation of an AtmosphereHandler

broadcasterId - The Broadcaster.getID() value.

addAtmosphereHandler

public AtmosphereFramework addAtmosphereHandler(java.lang.String mapping,
                                       AtmosphereHandler h,
                                       Broadcaster broadcaster,
                                       java.util.List<AtmosphereInterceptor> l)

Add an AtmosphereHandler serviced by the Servlet This API is exposed to allow embedding an Atmosphere application.

Parameters:

mapping - The servlet mapping (servlet path)

h - implementation of an AtmosphereHandler

broadcaster - The Broadcaster associated with AtmosphereHandler.

l - An attay of AtmosphereInterceptor

addAtmosphereHandler

public AtmosphereFramework addAtmosphereHandler(java.lang.String mapping,
                                       AtmosphereHandler h,
                                       Broadcaster broadcaster)

Add an AtmosphereHandler serviced by the Servlet This API is exposed to allow embedding an Atmosphere application.

Parameters:

mapping - The servlet mapping (servlet path)

h - implementation of an AtmosphereHandler

broadcaster - The Broadcaster associated with AtmosphereHandler.

removeAtmosphereHandler

public AtmosphereFramework removeAtmosphereHandler(java.lang.String mapping)

Remove an AtmosphereHandler

Parameters:

mapping - the mapping used when invoking addAtmosphereHandler(String, AtmosphereHandler);

Returns:

true if removed

removeAllAtmosphereHandler

public AtmosphereFramework removeAllAtmosphereHandler()

Remove all AtmosphereHandler

removeAllInitParams

public AtmosphereFramework removeAllInitParams()

Remove all init parameters.

addInitParameter

public AtmosphereFramework addInitParameter(java.lang.String name,
                                   java.lang.String value)

Add init-param like if they were defined in web.xml

Parameters:

name - The name

value - The value

readSystemProperties

protected void readSystemProperties()

patchContainer

public void patchContainer()

Path specific container using their own property.

init

public AtmosphereFramework init()

Initialize the AtmosphereFramework. Invoke that method after having properly configured this class using the setter.

init

public AtmosphereFramework init(javax.servlet.ServletConfig sc)
                         throws javax.servlet.ServletException

Initialize the AtmosphereFramework using the ServletContext

Parameters:

sc - the ServletContext

Throws:

javax.servlet.ServletException

analytics

protected void analytics()

configureAtmosphereInterceptor

protected void configureAtmosphereInterceptor(javax.servlet.ServletConfig sc)

Configure the list of AtmosphereInterceptor.

Parameters:

sc - a ServletConfig

newAInterceptor

protected AtmosphereInterceptor newAInterceptor(java.lang.Class<? extends AtmosphereInterceptor> a)

configureWebDotXmlAtmosphereHandler

protected void configureWebDotXmlAtmosphereHandler(javax.servlet.ServletConfig sc)

configureScanningPackage

protected void configureScanningPackage(javax.servlet.ServletConfig sc)

configureBroadcasterFactory

protected void configureBroadcasterFactory()

configureBroadcaster

protected void configureBroadcaster()

doInitParamsForWebSocket

protected void doInitParamsForWebSocket(javax.servlet.ServletConfig sc)

doInitParams

protected void doInitParams(javax.servlet.ServletConfig sc)

Read init param from web.xml and apply them.

Parameters:

sc - ServletConfig

loadConfiguration

public void loadConfiguration(javax.servlet.ServletConfig sc)
                       throws javax.servlet.ServletException

Throws:

javax.servlet.ServletException

detectSupportedFramework

protected boolean detectSupportedFramework(javax.servlet.ServletConfig sc)
                                    throws java.lang.ClassNotFoundException,
                                           java.lang.IllegalAccessException,
                                           java.lang.InstantiationException,
                                           java.lang.NoSuchMethodException,
                                           java.lang.reflect.InvocationTargetException

Auto-detect Jersey when no atmosphere.xml file are specified.

Parameters:

sc - ServletConfig

Returns:

true if Jersey classes are detected

Throws:

java.lang.ClassNotFoundException

java.lang.IllegalAccessException

java.lang.InstantiationException

java.lang.NoSuchMethodException

java.lang.reflect.InvocationTargetException

lookupDefaultBroadcasterType

protected java.lang.String lookupDefaultBroadcasterType(java.lang.String defaultB)

sessionSupport

protected void sessionSupport(boolean sessionSupport)

initAtmosphereHandler

public void initAtmosphereHandler(javax.servlet.ServletConfig sc)
                           throws javax.servlet.ServletException

Initialize AtmosphereServletProcessor

Parameters:

sc - the ServletConfig

Throws:

javax.servlet.ServletException

initWebSocket

protected void initWebSocket()

destroy

public AtmosphereFramework destroy()

loadAtmosphereDotXml

protected void loadAtmosphereDotXml(java.io.InputStream stream,
                        java.net.URLClassLoader c)
                             throws java.io.IOException,
                                    javax.servlet.ServletException

Load AtmosphereHandler defined under META-INF/atmosphere.xml

Parameters:

stream - The input stream we read from.

c - The classloader

Throws:

java.io.IOException

javax.servlet.ServletException

setAsyncSupport

public AtmosphereFramework setAsyncSupport(AsyncSupport asyncSupport)

Set the AsyncSupport implementation. Make sure you don't set an implementation that only works on some Container. See BlockingIOCometSupport for an example.

Parameters:

asyncSupport -

setCometSupport

public AtmosphereFramework setCometSupport(AsyncSupport asyncSupport)

Parameters:

asyncSupport -

Returns:

getAsyncSupport

public AsyncSupport getAsyncSupport()

Return the current AsyncSupport

Returns:

the current AsyncSupport

getCometSupport

public AsyncSupport getCometSupport()

Deprecated. Use getAsyncSupport

Return the current AsyncSupport

Returns:

the current AsyncSupport

createAsyncSupportResolver

protected AsyncSupportResolver createAsyncSupportResolver()

Returns an instance of AsyncSupportResolver AsyncSupportResolver

Returns:

CometSupportResolver

autoDetectContainer

protected void autoDetectContainer()

Auto detect the underlying Servlet Container we are running on.

autoDetectAtmosphereHandlers

public void autoDetectAtmosphereHandlers(javax.servlet.ServletContext servletContext,
                                java.net.URLClassLoader classloader)
                                  throws java.net.MalformedURLException,
                                         java.net.URISyntaxException

Auto detect instance of AtmosphereHandler in case META-INF/atmosphere.xml is missing.

Parameters:

servletContext - ServletContext

classloader - URLClassLoader to load the class.

Throws:

java.net.MalformedURLException

java.net.URISyntaxException

loadAtmosphereHandlersFromPath

public void loadAtmosphereHandlersFromPath(java.net.URLClassLoader classloader,
                                  java.lang.String realPath)

autoDetectWebSocketHandler

protected void autoDetectWebSocketHandler(javax.servlet.ServletContext servletContext,
                              java.net.URLClassLoader classloader)
                                   throws java.net.MalformedURLException,
                                          java.net.URISyntaxException

Auto detect instance of WebSocketHandler in case META-INF/atmosphere.xml is missing.

Parameters:

servletContext - ServletContext

classloader - URLClassLoader to load the class.

Throws:

java.net.MalformedURLException

java.net.URISyntaxException

loadWebSocketFromPath

protected void loadWebSocketFromPath(java.net.URLClassLoader classloader,
                         java.lang.String realPath)

doCometSupport

public Action doCometSupport(AtmosphereRequest req,
                    AtmosphereResponse res)
                      throws java.io.IOException,
                             javax.servlet.ServletException

Invoke the proprietary AsyncSupport

Parameters:

req -

res -

Returns:

an Action

Throws:

java.io.IOException

javax.servlet.ServletException

getDefaultBroadcasterClassName

public java.lang.String getDefaultBroadcasterClassName()

Return the default Broadcaster class name.

Returns:

the broadcasterClassName

setDefaultBroadcasterClassName

public AtmosphereFramework setDefaultBroadcasterClassName(java.lang.String bccn)

Set the default Broadcaster class name

Parameters:

bccn - the broadcasterClassName to set

isUseStreamForFlushingComments

public boolean isUseStreamForFlushingComments()

true if Atmosphere uses AtmosphereResponse.getOutputStream() by default for write operation.

Returns:

the useStreamForFlushingComments

setUseStreamForFlushingComments

public AtmosphereFramework setUseStreamForFlushingComments(boolean useStreamForFlushingComments)

Set to true so Atmosphere uses AtmosphereResponse.getOutputStream() by default for write operation. Default is false.

Parameters:

useStreamForFlushingComments - the useStreamForFlushingComments to set

getBroadcasterFactory

public BroadcasterFactory getBroadcasterFactory()

Get the BroadcasterFactory which is used by Atmosphere to construct Broadcaster

Returns:

BroadcasterFactory

setBroadcasterFactory

public AtmosphereFramework setBroadcasterFactory(BroadcasterFactory broadcasterFactory)

Set the BroadcasterFactory which is used by Atmosphere to construct Broadcaster

Returns:

BroadcasterFactory

getBroadcasterCacheClassName

public java.lang.String getBroadcasterCacheClassName()

Return the BroadcasterCache class name.

Returns:

the BroadcasterCache class name.

setBroadcasterCacheClassName

public void setBroadcasterCacheClassName(java.lang.String broadcasterCacheClassName)

Set the BroadcasterCache class name.

Parameters:

broadcasterCacheClassName -

addBroadcasterType

public AtmosphereFramework addBroadcasterType(java.lang.String broadcasterTypeString)

Add a new Broadcaster class name AtmosphereServlet can use when initializing requests, and when atmosphere.xml broadcaster element is unspecified.

Parameters:

broadcasterTypeString -

getWebSocketProtocolClassName

public java.lang.String getWebSocketProtocolClassName()

setWebSocketProtocolClassName

public AtmosphereFramework setWebSocketProtocolClassName(java.lang.String webSocketProtocolClassName)

getAtmosphereHandlers

public java.util.Map<java.lang.String,AtmosphereFramework.AtmosphereHandlerWrapper> getAtmosphereHandlers()

configureQueryStringAsRequest

protected java.util.Map<java.lang.String,java.lang.String> configureQueryStringAsRequest(AtmosphereRequest request)

isIECandidate

protected boolean isIECandidate(AtmosphereRequest request)

getWebSocketProtocol

public WebSocketProtocol getWebSocketProtocol()

isUseNativeImplementation

public boolean isUseNativeImplementation()

setUseNativeImplementation

public AtmosphereFramework setUseNativeImplementation(boolean useNativeImplementation)

isUseBlockingImplementation

public boolean isUseBlockingImplementation()

setUseBlockingImplementation

public AtmosphereFramework setUseBlockingImplementation(boolean useBlockingImplementation)

getAtmosphereDotXmlPath

public java.lang.String getAtmosphereDotXmlPath()

setAtmosphereDotXmlPath

public AtmosphereFramework setAtmosphereDotXmlPath(java.lang.String atmosphereDotXmlPath)

getHandlersPath

public java.lang.String getHandlersPath()

setHandlersPath

public AtmosphereFramework setHandlersPath(java.lang.String handlersPath)

getLibPath

public java.lang.String getLibPath()

Return the location of the jars containing the application classes. Default is WEB-INF/lib

Returns:

the location of the jars containing the application classes. Default is WEB-INF/lib

setLibPath

public AtmosphereFramework setLibPath(java.lang.String libPath)

Set the location of the jars containing the application.

Parameters:

libPath - the location of the jars containing the application.

Returns:

this

getWebSocketProcessorClassName

public java.lang.String getWebSocketProcessorClassName()

setWebsocketProcessorClassName

public AtmosphereFramework setWebsocketProcessorClassName(java.lang.String webSocketProcessorClassName)

interceptor

public AtmosphereFramework interceptor(AtmosphereInterceptor c)

Add an AtmosphereInterceptor implementation. The adding order or AtmosphereInterceptor will be used, e.g the first added AtmosphereInterceptor will always be called first.

Parameters:

c - AtmosphereInterceptor

Returns:

this

interceptors

public java.util.LinkedList<AtmosphereInterceptor> interceptors()

Return the list of AtmosphereInterceptor

Returns:

the list of AtmosphereInterceptor

annotationProcessorClassName

public AtmosphereFramework annotationProcessorClassName(java.lang.String annotationProcessorClassName)

Set the AnnotationProcessor class name.

Parameters:

annotationProcessorClassName - the AnnotationProcessor class name.

Returns:

this

asyncSupportListener

public AtmosphereFramework asyncSupportListener(AsyncSupportListener asyncSupportListener)

Add an AsyncSupportListener

Parameters:

asyncSupportListener - an AsyncSupportListener

Returns:

this;

asyncSupportListeners

public java.util.List<AsyncSupportListener> asyncSupportListeners()

Return the list of an AsyncSupportListener

Returns:

addBroadcasterListener

public AtmosphereFramework addBroadcasterListener(BroadcasterListener b)

Add BroadcasterListener to all created Broadcaster

getAtmosphereConfig

public AtmosphereConfig getAtmosphereConfig()

Return a configured instance of AtmosphereConfig

Returns:

a configured instance of AtmosphereConfig

getServletContext

public javax.servlet.ServletContext getServletContext()

Specified by:

getServletContext in interface ServletContextProvider

getServletConfig

public javax.servlet.ServletConfig getServletConfig()

broadcasterFilters

public java.util.List<java.lang.String> broadcasterFilters()

Return the list of BroadcastFilter

Returns:

the list of {@link BroadcastFilter

isShareExecutorServices

public boolean isShareExecutorServices()

Returns true if ExecutorService shared amongst all components.

Returns:

true if ExecutorService shared amongst all components.

shareExecutorServices

public AtmosphereFramework shareExecutorServices(boolean sharedThreadPools)

Set to true to have a ExecutorService shared amongst all components.

Parameters:

sharedThreadPools -

Returns:

this

autoConfigureService

protected void autoConfigureService(javax.servlet.ServletContext sc)
                             throws java.io.IOException

Throws:

java.io.IOException

addAnnotationPackage

public AtmosphereFramework addAnnotationPackage(java.lang.Class<?> clazz)

Add support for package detecttion of Atmosphere's Component.

Parameters:

clazz - a Class

Returns:

this.

notify

protected void notify(Action.TYPE type,
          AtmosphereRequest request,
          AtmosphereResponse response)