org.atmosphere.cpr

Class AtmosphereFramework

java.lang.Object

org.atmosphere.cpr.AtmosphereFramework

public class AtmosphereFramework
extends java.lang.Object

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
static class	AtmosphereFramework.DefaultAtmosphereObjectFactory
static class	AtmosphereFramework.MetaServiceAction This enumeration represents all possible actions to specify in a meta service file.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	allowAllClassesScan
protected boolean	annotationFound
protected java.util.LinkedList<java.lang.String>	annotationPackages
protected AnnotationProcessor	annotationProcessor
protected java.lang.String	annotationProcessorClassName
protected AtmosphereResourceFactory	arFactory
static java.lang.String	ASYNC_IO
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 java.util.List<AtmosphereResourceListener>	atmosphereResourceListeners
protected boolean	autoDetectHandlers
protected java.lang.String	broadcasterCacheClassName
protected java.util.LinkedList<BroadcasterCacheListener>	broadcasterCacheListeners
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.util.List<java.lang.Class<? extends AtmosphereInterceptor>>	DEFAULT_ATMOSPHERE_INTERCEPTORS
static java.lang.String	DEFAULT_HANDLER_PATH
static java.lang.String	DEFAULT_LIB_PATH
protected java.lang.Class<Serializer>	defaultSerializerClass
protected java.lang.String	defaultSerializerClassName
protected EndpointMapper<AtmosphereFramework.AtmosphereHandlerWrapper>	endpointMapper
protected java.util.List<java.lang.String>	excludedInterceptors
protected boolean	executeFirstSet
protected boolean	externalizeDestroy
protected java.util.List<BroadcasterConfig.FilterManipulator>	filterManipulators
protected java.util.List<AtmosphereFrameworkListener>	frameworkListeners
protected java.lang.String	handlersPath
protected java.util.HashMap<java.lang.String,java.lang.String>	initParams
protected java.util.concurrent.ConcurrentLinkedQueue<BroadcasterCacheInspector>	inspectors
protected java.util.LinkedList<AtmosphereInterceptor>	interceptors
protected boolean	isBroadcasterSpecified
protected java.util.concurrent.atomic.AtomicBoolean	isCometSupportConfigured
protected boolean	isCometSupportSpecified
protected java.util.concurrent.atomic.AtomicBoolean	isDestroyed
protected boolean	isFilter
protected boolean	isInit
protected boolean	isSessionSupportSpecified
protected boolean	isThrowExceptionOnClonedRequestSpecified
protected java.lang.String	libPath
protected static org.slf4j.Logger	logger
static java.lang.String	MAPPING_REGEX
protected java.lang.String	mappingRegex
static java.lang.String	META_SERVICE
protected MetaBroadcaster	metaBroadcaster
protected java.lang.String	metaServicePath
protected AtmosphereObjectFactory<?>	objectFactory
protected java.util.concurrent.ConcurrentLinkedQueue<java.lang.String>	objectFactoryType
protected java.util.List<java.lang.String>	packages
protected java.util.ArrayList<java.lang.String>	possibleComponentsCandidate
static AtmosphereHandler	REFLECTOR_ATMOSPHEREHANDLER An implementation of AbstractReflectorAtmosphereHandler.
protected boolean	scanDone
protected javax.servlet.ServletConfig	servletConfig
protected AtmosphereResourceSessionFactory	sessionFactory
protected boolean	sharedThreadPools
protected java.lang.Thread	shutdownHook
protected boolean	useBlockingImplementation
protected boolean	useNativeImplementation
protected boolean	useServlet30
protected boolean	useStreamForFlushingComments
protected boolean	webSocketEnabled
protected java.lang.String	webSocketProcessorClassName
protected WebSocketProtocol	webSocketProtocol
protected java.lang.String	webSocketProtocolClassName
protected boolean	webSocketProtocolInitialized

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

Modifier and Type	Method and Description
AtmosphereFramework	addAnnotationPackage(java.lang.Class<?> clazz) Add support for package detection 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.
AtmosphereFramework	addAtmosphereHandler(java.lang.String mapping, AtmosphereHandler h, Broadcaster broadcaster, java.util.List<AtmosphereInterceptor> l) Add an AtmosphereHandler serviced by the Servlet.
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.
AtmosphereFramework	addAtmosphereHandler(java.lang.String mapping, AtmosphereHandler h, java.lang.String broadcasterId, java.util.List<AtmosphereInterceptor> l) Add an AtmosphereHandler serviced by the Servlet.
AtmosphereFramework	addBroadcasterCacheInjector(BroadcasterCacheInspector b) Add a BroadcasterCacheInspector which will be associated with the defined BroadcasterCache.
AtmosphereFramework	addBroadcasterCacheListener(BroadcasterCacheListener b) Add BroadcasterCacheListener to the BroadcasterCache.
AtmosphereFramework	addBroadcasterListener(BroadcasterListener b) Add BroadcasterListener to all created Broadcasters.
AtmosphereFramework	addBroadcasterType(java.lang.String broadcasterTypeString) Add a new Broadcaster class name that AtmosphereServlet can use when initializing requests, and when the atmosphere.xml broadcaster element is unspecified.
AtmosphereFramework	addCustomAnnotationPackage(java.lang.Class p) Add a package containing classes annotated with AtmosphereAnnotation.
protected void	addDefaultOrAppInterceptors()
AtmosphereFramework	addInitParameter(java.lang.String name, java.lang.String value) Add init-param like if they were defined in web.xml
protected void	addInterceptorToAllWrappers(AtmosphereInterceptor c)
protected void	addInterceptorToWrapper(AtmosphereFramework.AtmosphereHandlerWrapper wrapper, AtmosphereInterceptor c)
protected void	addInterceptorToWrapper(AtmosphereFramework.AtmosphereHandlerWrapper wrapper, java.util.List<AtmosphereInterceptor> interceptors)
AtmosphereFramework	addWebSocketHandler(java.lang.String path, WebSocketHandler handler) Add an WebSocketHandler mapped to the path.
AtmosphereFramework	addWebSocketHandler(java.lang.String path, WebSocketHandler handler, AtmosphereHandler h) Add an WebSocketHandler mapped to the path and the AtmosphereHandler in case Broadcaster are used.
AtmosphereFramework	addWebSocketHandler(java.lang.String path, WebSocketHandler handler, AtmosphereHandler h, java.util.List<AtmosphereInterceptor> l) Add an WebSocketHandler mapped to the path and the AtmosphereHandler in case Broadcaster are used.
AtmosphereFramework	addWebSocketHandler(WebSocketHandler handler) Add an WebSocketHandler mapped to "/*".
boolean	allowAllClassesScan()
AtmosphereFramework	allowAllClassesScan(boolean allowAllClassesScan)
protected void	analytics()
AnnotationProcessor	annotationProcessor() Return the AnnotationProcessor
AtmosphereFramework	annotationProcessorClassName(java.lang.String annotationProcessorClassName)
AtmosphereFramework	annotationScanned(boolean b) Invoked when a AnnotationProcessor found an annotation.
AtmosphereFramework	asyncSupportListener(AsyncSupportListener asyncSupportListener) Add an AsyncSupportListener.
java.util.List<AsyncSupportListener>	asyncSupportListeners() Return the list of AsyncSupportListeners.
AtmosphereResourceFactory	atmosphereFactory()
AtmosphereFramework	atmosphereResourceListener(AtmosphereResourceListener atmosphereResourceListener) Add a AtmosphereResourceListener
java.util.List<AtmosphereResourceListener>	atmosphereResourceListeners() Return the list of AtmosphereResourceListener
protected void	autoConfigureService(javax.servlet.ServletContext sc)
void	autoDetectAtmosphereHandlers(javax.servlet.ServletContext servletContext, java.lang.ClassLoader 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.lang.ClassLoader classloader) Auto detect instance of WebSocketHandler in case META-INF/atmosphere.xml is missing.
java.util.List<BroadcasterCacheListener>	broadcasterCacheListeners()
java.util.List<java.lang.String>	broadcasterFilters() Return the list of BroadcastFilters.
AtmosphereFramework	broadcasterFilters(BroadcastFilter f) Add a BroadcastFilter.
java.lang.String	broadcasterLifeCyclePolicy()
AtmosphereFramework	broadcasterLifeCyclePolicy(java.lang.String broadcasterLifeCyclePolicy)
java.util.List<BroadcasterListener>	broadcasterListeners()
java.util.concurrent.ConcurrentLinkedQueue<java.lang.String>	broadcasterTypes()
void	checkWebSocketSupportState()
protected void	closeAtmosphereResource()
protected void	configureAtmosphereInterceptor(javax.servlet.ServletConfig sc) Configure the list of AtmosphereInterceptor.
protected void	configureBroadcaster()
void	configureBroadcasterFactory()
protected void	configureDetectedFramework(ReflectorServletProcessor rsp, boolean isJersey)
protected void	configureObjectFactory()
protected java.util.Map<java.lang.String,java.lang.String>	configureQueryStringAsRequest(AtmosphereRequest request)
AtmosphereFramework	configureRequestResponse(AtmosphereRequest req, AtmosphereResponse res) Configure some attributes on the AtmosphereRequest.
protected void	configureScanningPackage(javax.servlet.ServletConfig sc, java.lang.String value)
protected void	configureWebDotXmlAtmosphereHandler(javax.servlet.ServletConfig sc)
protected AsyncSupportResolver	createAsyncSupportResolver() Returns an instance of AsyncSupportResolver AsyncSupportResolver.
protected AtmosphereFramework.AtmosphereHandlerWrapper	createWrapperAndConfigureHandler(AtmosphereHandler h, java.lang.String mapping, java.util.List<AtmosphereInterceptor> l)
java.util.List<java.lang.String>	customAnnotationPackages() Return the list of packages the framework should look for AtmosphereAnnotation.
java.lang.Class<? extends AtmosphereInterceptor>[]	defaultInterceptors()
protected void	defaultPackagesToScan()
AtmosphereFramework	destroy()
protected void	destroyInterceptors()
protected boolean	detectSupportedFramework(javax.servlet.ServletConfig sc) Auto-detect Jersey when no atmosphere.xml file is specified.
Action	doCometSupport(AtmosphereRequest req, AtmosphereResponse res) Invoke the proprietary AsyncSupport.
protected void	doInitParams(javax.servlet.ServletConfig sc) Read init params from web.xml and apply them.
protected void	doInitParams(javax.servlet.ServletConfig sc, boolean reconfigure) Read init params from web.xml and apply them.
protected void	doInitParamsForWebSocket(javax.servlet.ServletConfig sc)
EndpointMapper<AtmosphereFramework.AtmosphereHandlerWrapper>	endPointMapper() The current EndpointMapper used to map requests to AtmosphereHandler.
AtmosphereFramework	endPointMapper(EndpointMapper endpointMapper) Set the EndpointMapper.
java.util.List<java.lang.String>	excludedInterceptors()
AtmosphereFramework	excludeInterceptor(java.lang.String interceptor) Exclude an AtmosphereInterceptor from being added, at startup, by Atmosphere.
boolean	externalizeDestroy()
AtmosphereFramework	externalizeDestroy(boolean externalizeDestroy) If set to true, the task of finishing the request/response lifecycle will not be handled by this class.
AtmosphereFramework	filterManipulator(BroadcasterConfig.FilterManipulator m)
java.util.List<BroadcasterConfig.FilterManipulator>	filterManipulators()
AtmosphereFramework	frameworkListener(AtmosphereFrameworkListener l) Add a AtmosphereFrameworkListener
java.util.List<AtmosphereFrameworkListener>	frameworkListeners() Return the list of AtmosphereFrameworkListener
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.Class<Serializer>	getDefaultSerializerClass() Get the default Serializer class to use for AtmosphereResources.
java.lang.String	getDefaultSerializerClassName() Get the default Serializer class name to use for AtmosphereResources.
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() Return the ServletContext
java.lang.String	getWebSocketProcessorClassName() The current WebSocketProcessor used to handle websocket requests.
WebSocketProtocol	getWebSocketProtocol()
java.lang.String	getWebSocketProtocolClassName()
AtmosphereFramework	init() Initialize the AtmosphereFramework.
AtmosphereFramework	init(javax.servlet.ServletConfig sc) Initialize the AtmosphereFramework using the ServletContext.
AtmosphereFramework	init(javax.servlet.ServletConfig sc, boolean wrap) Initialize the AtmosphereFramework using the ServletContext.
void	initAtmosphereHandler()
void	initAtmosphereHandler(javax.servlet.ServletConfig sc) Initialize AtmosphereServletProcessor.
void	initEndpointMapper()
void	initializationError(java.lang.IllegalStateException initializationError) If a ContainerInitializer fail, log the excetion here.
boolean	initialized() Return true if the init() has been sucessfully executed.
void	initWebSocket()
java.util.concurrent.ConcurrentLinkedQueue<BroadcasterCacheInspector>	inspectors() Return the list of BroadcasterCacheInspectors.
protected void	installAnnotationProcessor(javax.servlet.ServletConfig sc)
AtmosphereFramework	interceptor(AtmosphereInterceptor c) Add an AtmosphereInterceptor implementation.
<T extends AtmosphereInterceptor> T	interceptor(java.lang.Class<T> c)
java.util.LinkedList<AtmosphereInterceptor>	interceptors() Return the list of AtmosphereInterceptor.
boolean	isAServletFilter()
boolean	isBroadcasterSpecified() Was a Broadcaster defined in web.xml or programmatically added.
boolean	isDestroyed() Return true is the destroy() method has been invoked.
boolean	isShareExecutorServices() Returns true if ExecutorService is shared among all components.
boolean	isUseBlockingImplementation()
boolean	isUseNativeImplementation()
boolean	isUseServlet30()
boolean	isUseStreamForFlushingComments() true if Atmosphere uses AtmosphereResponseImpl.getOutputStream() by default for write operation.
protected void	loadAtmosphereDotXml(java.io.InputStream stream, java.lang.ClassLoader c) Load AtmosphereHandler defined under META-INF/atmosphere.xml.
void	loadAtmosphereHandlersFromPath(java.lang.ClassLoader classloader, java.lang.String realPath)
void	loadConfiguration(javax.servlet.ServletConfig sc)
protected void	loadMetaService()
protected void	loadWebSocketFromPath(java.lang.ClassLoader classloader, java.lang.String realPath)
protected java.lang.String	lookupDefaultBroadcasterType(java.lang.String defaultB)
protected AtmosphereObjectFactory<?>	lookupDefaultObjectFactoryType()
java.lang.String	mappingRegex()
AtmosphereFramework	mappingRegex(java.lang.String mappingRegex)
MetaBroadcaster	metaBroadcaster()
protected AtmosphereInterceptor	newAInterceptor(java.lang.Class<? extends AtmosphereInterceptor> a)
protected AtmosphereConfig	newAtmosphereConfig() Create an instance of AtmosphereConfig
<T,U extends T> T	newClassInstance(java.lang.Class<T> classType, java.lang.Class<U> defaultType) Instantiate a class
java.lang.String	normalizePath(java.lang.String path)
AtmosphereFramework	notify(Action.TYPE type, AtmosphereRequest request, AtmosphereResponse response)
AtmosphereFramework	notifyDestroyed(java.lang.String uuid)
AtmosphereFramework	notifySuspended(java.lang.String uuid)
AtmosphereObjectFactory	objectFactory()
void	objectFactory(AtmosphereObjectFactory objectFactory) Set an object used for class instantiation.
java.util.concurrent.ConcurrentLinkedQueue<java.lang.String>	objectFactoryType()
protected void	onPostDestroy()
protected void	onPostInit()
protected void	onPreDestroy()
protected void	onPreInit()
java.util.List<java.lang.String>	packages()
void	patchContainer() Path specific container using their own property.
protected void	preventOOM() Prevent Atmosphere from scanning the entire class path.
protected void	readSystemProperties()
void	reconfigureInitParams(boolean reconfigureInitParams)
AtmosphereFramework	removeAllAtmosphereHandler() Remove all AtmosphereHandlers.
AtmosphereFramework	removeAllInitParams() Remove all init parameters.
AtmosphereFramework	removeAtmosphereHandler(java.lang.String mapping) Remove an AtmosphereHandler.
AtmosphereFramework	resetStates()
protected void	servletConfig(javax.servlet.ServletConfig sc, boolean wrap)
AtmosphereResourceSessionFactory	sessionFactory() Return the AtmosphereResourceSessionFactory
void	sessionSupport(boolean sessionSupport)
void	setAndConfigureAtmosphereResourceFactory(AtmosphereResourceFactory arFactory)
AtmosphereFramework	setAsyncSupport(AsyncSupport asyncSupport) Set the AsyncSupport implementation.
AtmosphereFramework	setAtmosphereDotXmlPath(java.lang.String atmosphereDotXmlPath)
AtmosphereFramework	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	setDefaultSerializerClassName(java.lang.String defaultSerializerClassName) Set the default Serializer class name to use for AtmosphereResources.
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)
void	setUseServlet30(boolean useServlet30)
AtmosphereFramework	setUseStreamForFlushingComments(boolean useStreamForFlushingComments) Set to true so Atmosphere uses AtmosphereResponseImpl.getOutputStream() by default for write operation.
AtmosphereFramework	setWebsocketProcessorClassName(java.lang.String webSocketProcessorClassName) Set the WebSocketProcessor class name used to process WebSocket requests.
AtmosphereFramework	setWebSocketProtocolClassName(java.lang.String webSocketProtocolClassName)
boolean	sharedThreadPools()
AtmosphereFramework	sharedThreadPools(boolean sharedThreadPools)
AtmosphereFramework	shareExecutorServices(boolean sharedThreadPools) Set to true to have a ExecutorService shared among all components.
protected void	universe()
UUIDProvider	uuidProvider() Return the UUIDProvider
AtmosphereFramework	uuidProvider(UUIDProvider uuidProvider) Set a UUID like implementation for generating random UUID String
boolean	webSocketEnabled()
AtmosphereFramework	webSocketEnabled(boolean webSocketEnabled)
WebSocketFactory	webSocketFactory() Return the WebSocketFactory
AtmosphereFramework	webSocketFactory(WebSocketFactory webSocketFactory) Configure the WebSocketFactory

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

DEFAULT_HANDLER_PATH

public static final java.lang.String DEFAULT_HANDLER_PATH

See Also:

Constant Field Values

META_SERVICE

public static final java.lang.String META_SERVICE

See Also:

Constant Field Values

MAPPING_REGEX

public static final java.lang.String MAPPING_REGEX

See Also:

Constant Field Values

ASYNC_IO

public static final java.lang.String ASYNC_IO

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

atmosphereResourceListeners

protected final java.util.List<AtmosphereResourceListener> atmosphereResourceListeners

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

objectFactoryType

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

inspectors

protected final java.util.concurrent.ConcurrentLinkedQueue<BroadcasterCacheInspector> inspectors

mappingRegex

protected java.lang.String mappingRegex

useNativeImplementation

protected boolean useNativeImplementation

useBlockingImplementation

protected boolean useBlockingImplementation

useStreamForFlushingComments

protected boolean useStreamForFlushingComments

useServlet30

protected boolean useServlet30

asyncSupport

protected AsyncSupport asyncSupport

broadcasterClassName

protected java.lang.String broadcasterClassName

isCometSupportSpecified

protected boolean isCometSupportSpecified

isBroadcasterSpecified

protected boolean isBroadcasterSpecified

isSessionSupportSpecified

protected boolean isSessionSupportSpecified

isThrowExceptionOnClonedRequestSpecified

protected boolean isThrowExceptionOnClonedRequestSpecified

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

metaServicePath

protected java.lang.String metaServicePath

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

webSocketProtocolInitialized

protected boolean webSocketProtocolInitialized

endpointMapper

protected EndpointMapper<AtmosphereFramework.AtmosphereHandlerWrapper> endpointMapper

libPath

protected java.lang.String libPath

isInit

protected boolean isInit

sharedThreadPools

protected boolean sharedThreadPools

packages

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

annotationPackages

protected final java.util.LinkedList<java.lang.String> annotationPackages

allowAllClassesScan

protected boolean allowAllClassesScan

annotationFound

protected boolean annotationFound

executeFirstSet

protected boolean executeFirstSet

objectFactory

protected AtmosphereObjectFactory<?> objectFactory

isDestroyed

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

externalizeDestroy

protected boolean externalizeDestroy

annotationProcessor

protected AnnotationProcessor annotationProcessor

excludedInterceptors

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

broadcasterCacheListeners

protected final java.util.LinkedList<BroadcasterCacheListener> broadcasterCacheListeners

filterManipulators

protected final java.util.List<BroadcasterConfig.FilterManipulator> filterManipulators

arFactory

protected AtmosphereResourceFactory arFactory

metaBroadcaster

protected MetaBroadcaster metaBroadcaster

sessionFactory

protected AtmosphereResourceSessionFactory sessionFactory

defaultSerializerClassName

protected java.lang.String defaultSerializerClassName

defaultSerializerClass

protected java.lang.Class<Serializer> defaultSerializerClass

frameworkListeners

protected final java.util.List<AtmosphereFrameworkListener> frameworkListeners

shutdownHook

protected java.lang.Thread shutdownHook

DEFAULT_ATMOSPHERE_INTERCEPTORS

public static final java.util.List<java.lang.Class<? extends AtmosphereInterceptor>> DEFAULT_ATMOSPHERE_INTERCEPTORS

REFLECTOR_ATMOSPHEREHANDLER

public static final AtmosphereHandler REFLECTOR_ATMOSPHEREHANDLER

An implementation of AbstractReflectorAtmosphereHandler.

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

setAndConfigureAtmosphereResourceFactory

public void setAndConfigureAtmosphereResourceFactory(AtmosphereResourceFactory arFactory)

newAtmosphereConfig

protected AtmosphereConfig newAtmosphereConfig()

Create an instance of AtmosphereConfig

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 array of AtmosphereInterceptor.

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 - A list of AtmosphereInterceptors

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 - A list of AtmosphereInterceptor

createWrapperAndConfigureHandler

protected AtmosphereFramework.AtmosphereHandlerWrapper createWrapperAndConfigureHandler(AtmosphereHandler h,
                                                                                        java.lang.String mapping,
                                                                                        java.util.List<AtmosphereInterceptor> l)

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

normalizePath

public java.lang.String normalizePath(java.lang.String path)

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)

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

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 this method after having properly configured this class using the setters.

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

preventOOM

protected void preventOOM()

Prevent Atmosphere from scanning the entire class path.

init

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

Initialize the AtmosphereFramework using the ServletContext.

Parameters:

sc - the ServletContext

Throws:

javax.servlet.ServletException

servletConfig

protected void servletConfig(javax.servlet.ServletConfig sc,
                             boolean wrap)

reconfigureInitParams

public void reconfigureInitParams(boolean reconfigureInitParams)

universe

protected void universe()

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,
                                        java.lang.String value)

defaultPackagesToScan

protected void defaultPackagesToScan()

configureBroadcasterFactory

public void configureBroadcasterFactory()

configureBroadcaster

protected void configureBroadcaster()

installAnnotationProcessor

protected void installAnnotationProcessor(javax.servlet.ServletConfig sc)

doInitParamsForWebSocket

protected void doInitParamsForWebSocket(javax.servlet.ServletConfig sc)

doInitParams

protected void doInitParams(javax.servlet.ServletConfig sc)

Read init params from web.xml and apply them.

Parameters:

sc - ServletConfig

doInitParams

protected void doInitParams(javax.servlet.ServletConfig sc,
                            boolean reconfigure)

Read init params 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.Exception

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

Parameters:

sc - ServletConfig

Returns:

true if Jersey classes are detected

Throws:

java.lang.ClassNotFoundException

java.lang.Exception

configureDetectedFramework

protected void configureDetectedFramework(ReflectorServletProcessor rsp,
                                          boolean isJersey)

lookupDefaultBroadcasterType

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

lookupDefaultObjectFactoryType

protected AtmosphereObjectFactory<?> lookupDefaultObjectFactoryType()

sessionSupport

public 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

initAtmosphereHandler

public void initAtmosphereHandler()
                           throws javax.servlet.ServletException

Throws:

javax.servlet.ServletException

checkWebSocketSupportState

public void checkWebSocketSupportState()

initWebSocket

public void initWebSocket()

initEndpointMapper

public void initEndpointMapper()

closeAtmosphereResource

protected void closeAtmosphereResource()

destroy

public AtmosphereFramework destroy()

destroyInterceptors

protected void destroyInterceptors()

resetStates

public AtmosphereFramework resetStates()

loadMetaService

protected void loadMetaService()

loadAtmosphereDotXml

protected void loadAtmosphereDotXml(java.io.InputStream stream,
                                    java.lang.ClassLoader 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.lang.ClassLoader classloader)
                                  throws java.net.MalformedURLException

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

Parameters:

servletContext - ServletContext

classloader - ClassLoader to load the class.

Throws:

java.net.MalformedURLException

loadAtmosphereHandlersFromPath

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

autoDetectWebSocketHandler

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

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

Parameters:

servletContext - ServletContext

classloader - ClassLoader to load the class.

Throws:

java.net.MalformedURLException

loadWebSocketFromPath

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

configureRequestResponse

public AtmosphereFramework configureRequestResponse(AtmosphereRequest req,
                                                    AtmosphereResponse res)
                                             throws java.io.UnsupportedEncodingException

Configure some attributes on the AtmosphereRequest.

Parameters:

req - AtmosphereRequest

Throws:

java.io.UnsupportedEncodingException

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 AtmosphereResponseImpl.getOutputStream() by default for write operation.

Returns:

the useStreamForFlushingComments

isUseServlet30

public boolean isUseServlet30()

setUseStreamForFlushingComments

public AtmosphereFramework setUseStreamForFlushingComments(boolean useStreamForFlushingComments)

Set to true so Atmosphere uses AtmosphereResponseImpl.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 AtmosphereFramework 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 that AtmosphereServlet can use when initializing requests, and when the atmosphere.xml broadcaster element is unspecified.

Parameters:

broadcasterTypeString -

broadcasterTypes

public java.util.concurrent.ConcurrentLinkedQueue<java.lang.String> broadcasterTypes()

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)

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()

The current WebSocketProcessor used to handle websocket requests.

Returns:

WebSocketProcessor

setWebsocketProcessorClassName

public AtmosphereFramework setWebsocketProcessorClassName(java.lang.String webSocketProcessorClassName)

Set the WebSocketProcessor class name used to process WebSocket requests. Default is DefaultWebSocketProcessor

Parameters:

webSocketProcessorClassName - WebSocketProcessor

Returns:

this

interceptor

public AtmosphereFramework interceptor(AtmosphereInterceptor c)

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

Parameters:

c - AtmosphereInterceptor

Returns:

this

addDefaultOrAppInterceptors

protected void addDefaultOrAppInterceptors()

addInterceptorToAllWrappers

protected void addInterceptorToAllWrappers(AtmosphereInterceptor c)

addInterceptorToWrapper

protected void addInterceptorToWrapper(AtmosphereFramework.AtmosphereHandlerWrapper wrapper,
                                       AtmosphereInterceptor c)

addInterceptorToWrapper

protected void addInterceptorToWrapper(AtmosphereFramework.AtmosphereHandlerWrapper wrapper,
                                       java.util.List<AtmosphereInterceptor> interceptors)

interceptors

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

Return the list of AtmosphereInterceptor.

Returns:

the list of AtmosphereInterceptor

interceptor

public <T extends AtmosphereInterceptor> T interceptor(java.lang.Class<T> c)

annotationProcessorClassName

public AtmosphereFramework annotationProcessorClassName(java.lang.String annotationProcessorClassName)

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

Returns:

addBroadcasterListener

public AtmosphereFramework addBroadcasterListener(BroadcasterListener b)

Add BroadcasterListener to all created Broadcasters.

addBroadcasterCacheListener

public AtmosphereFramework addBroadcasterCacheListener(BroadcasterCacheListener b)

Add BroadcasterCacheListener to the BroadcasterCache.

broadcasterCacheListeners

public java.util.List<BroadcasterCacheListener> broadcasterCacheListeners()

addBroadcasterCacheInjector

public AtmosphereFramework addBroadcasterCacheInjector(BroadcasterCacheInspector b)

Add a BroadcasterCacheInspector which will be associated with the defined BroadcasterCache.

Parameters:

b - BroadcasterCacheInspector

Returns:

this;

inspectors

public java.util.concurrent.ConcurrentLinkedQueue<BroadcasterCacheInspector> inspectors()

Return the list of BroadcasterCacheInspectors.

Returns:

the list of BroadcasterCacheInspectors

getAtmosphereConfig

public AtmosphereConfig getAtmosphereConfig()

Return a configured instance of AtmosphereConfig.

Returns:

a configured instance of AtmosphereConfig

getServletContext

public javax.servlet.ServletContext getServletContext()

Return the ServletContext

Returns:

the ServletContext

getServletConfig

public javax.servlet.ServletConfig getServletConfig()

broadcasterFilters

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

Return the list of BroadcastFilters.

Returns:

the list of BroadcastFilters

broadcasterFilters

public AtmosphereFramework broadcasterFilters(BroadcastFilter f)

Add a BroadcastFilter.

Returns:

isShareExecutorServices

public boolean isShareExecutorServices()

Returns true if ExecutorService is shared among all components.

Returns:

true if ExecutorService is shared amongst all components

shareExecutorServices

public AtmosphereFramework shareExecutorServices(boolean sharedThreadPools)

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

Parameters:

sharedThreadPools -

Returns:

this

autoConfigureService

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

Throws:

java.io.IOException

endPointMapper

public EndpointMapper<AtmosphereFramework.AtmosphereHandlerWrapper> endPointMapper()

The current EndpointMapper used to map requests to AtmosphereHandler.

Returns:

EndpointMapper

endPointMapper

public AtmosphereFramework endPointMapper(EndpointMapper endpointMapper)

Set the EndpointMapper.

Parameters:

endpointMapper - EndpointMapper

Returns:

this

addAnnotationPackage

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

Add support for package detection of Atmosphere's Component.

Parameters:

clazz - a Class

Returns:

this.

notify

public AtmosphereFramework notify(Action.TYPE type,
                                  AtmosphereRequest request,
                                  AtmosphereResponse response)

notifyDestroyed

public AtmosphereFramework notifyDestroyed(java.lang.String uuid)

notifySuspended

public AtmosphereFramework notifySuspended(java.lang.String uuid)

addWebSocketHandler

public AtmosphereFramework addWebSocketHandler(WebSocketHandler handler)

Add an WebSocketHandler mapped to "/*". return this

addWebSocketHandler

public AtmosphereFramework addWebSocketHandler(java.lang.String path,
                                               WebSocketHandler handler)

Add an WebSocketHandler mapped to the path. return this

addWebSocketHandler

public AtmosphereFramework addWebSocketHandler(java.lang.String path,
                                               WebSocketHandler handler,
                                               AtmosphereHandler h)

Add an WebSocketHandler mapped to the path and the AtmosphereHandler in case Broadcaster are used.

Parameters:

path - a path

handler - a WebSocketHandler

h - an AtmosphereHandler

Returns:

this

addWebSocketHandler

public AtmosphereFramework addWebSocketHandler(java.lang.String path,
                                               WebSocketHandler handler,
                                               AtmosphereHandler h,
                                               java.util.List<AtmosphereInterceptor> l)

Add an WebSocketHandler mapped to the path and the AtmosphereHandler in case Broadcaster are used.

Parameters:

path - a path

handler - a WebSocketHandler

h - an AtmosphereHandler

l - AtmosphereInterceptor

Returns:

this

annotationScanned

public AtmosphereFramework annotationScanned(boolean b)

Invoked when a AnnotationProcessor found an annotation.

Parameters:

b - true when found

Returns:

this

initialized

public boolean initialized()

Return true if the init() has been sucessfully executed.

Returns:

true if the init() has been sucessfully executed.

packages

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

customAnnotationPackages

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

Return the list of packages the framework should look for AtmosphereAnnotation.

Returns:

the list of packages the framework should look for AtmosphereAnnotation

addCustomAnnotationPackage

public AtmosphereFramework addCustomAnnotationPackage(java.lang.Class p)

Add a package containing classes annotated with AtmosphereAnnotation.

Parameters:

p - a package

Returns:

this;

newClassInstance

public <T,U extends T> T newClassInstance(java.lang.Class<T> classType,
                                          java.lang.Class<U> defaultType)
                                   throws java.lang.InstantiationException,
                                          java.lang.IllegalAccessException

Instantiate a class

Parameters:

classType - The Required Class's Type

defaultType - The default implementation of the Class's Type.

Returns:

the an instance of defaultType

Throws:

java.lang.InstantiationException

java.lang.IllegalAccessException

objectFactory

public void objectFactory(AtmosphereObjectFactory objectFactory)

Set an object used for class instantiation. Allows for integration with dependency injection frameworks.

Parameters:

objectFactory -

externalizeDestroy

public AtmosphereFramework externalizeDestroy(boolean externalizeDestroy)

If set to true, the task of finishing the request/response lifecycle will not be handled by this class.

Parameters:

externalizeDestroy -

Returns:

this

annotationProcessor

public AnnotationProcessor annotationProcessor()

Return the AnnotationProcessor

Returns:

the AnnotationProcessor

isBroadcasterSpecified

public boolean isBroadcasterSpecified()

Was a Broadcaster defined in web.xml or programmatically added.

Returns:

true is defined.

configureObjectFactory

protected void configureObjectFactory()

excludeInterceptor

public AtmosphereFramework excludeInterceptor(java.lang.String interceptor)

Exclude an AtmosphereInterceptor from being added, at startup, by Atmosphere. The default's DEFAULT_ATMOSPHERE_INTERCEPTORS are candidates for being excluded.

Parameters:

interceptor - an AtmosphereInterceptor class name

Returns:

this

filterManipulator

public AtmosphereFramework filterManipulator(BroadcasterConfig.FilterManipulator m)

filterManipulators

public java.util.List<BroadcasterConfig.FilterManipulator> filterManipulators()

isAServletFilter

public boolean isAServletFilter()

objectFactoryType

public java.util.concurrent.ConcurrentLinkedQueue<java.lang.String> objectFactoryType()

mappingRegex

public java.lang.String mappingRegex()

mappingRegex

public AtmosphereFramework mappingRegex(java.lang.String mappingRegex)

setUseServlet30

public void setUseServlet30(boolean useServlet30)

webSocketEnabled

public boolean webSocketEnabled()

webSocketEnabled

public AtmosphereFramework webSocketEnabled(boolean webSocketEnabled)

broadcasterLifeCyclePolicy

public java.lang.String broadcasterLifeCyclePolicy()

broadcasterLifeCyclePolicy

public AtmosphereFramework broadcasterLifeCyclePolicy(java.lang.String broadcasterLifeCyclePolicy)

broadcasterListeners

public java.util.List<BroadcasterListener> broadcasterListeners()

sharedThreadPools

public boolean sharedThreadPools()

sharedThreadPools

public AtmosphereFramework sharedThreadPools(boolean sharedThreadPools)

allowAllClassesScan

public boolean allowAllClassesScan()

allowAllClassesScan

public AtmosphereFramework allowAllClassesScan(boolean allowAllClassesScan)

objectFactory

public AtmosphereObjectFactory objectFactory()

externalizeDestroy

public boolean externalizeDestroy()

excludedInterceptors

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

defaultInterceptors

public java.lang.Class<? extends AtmosphereInterceptor>[] defaultInterceptors()

atmosphereFactory

public AtmosphereResourceFactory atmosphereFactory()

metaBroadcaster

public MetaBroadcaster metaBroadcaster()

getDefaultSerializerClassName

public java.lang.String getDefaultSerializerClassName()

Get the default Serializer class name to use for AtmosphereResources.

Returns:

the class name as a string, might be null if not configured

getDefaultSerializerClass

public java.lang.Class<Serializer> getDefaultSerializerClass()

Get the default Serializer class to use for AtmosphereResources.

Returns:

the class, might be null if not configured

setDefaultSerializerClassName

public AtmosphereFramework setDefaultSerializerClassName(java.lang.String defaultSerializerClassName)

Set the default Serializer class name to use for AtmosphereResources.

Parameters:

defaultSerializerClassName - the class name to use

Returns:

this

sessionFactory

public AtmosphereResourceSessionFactory sessionFactory()

Return the AtmosphereResourceSessionFactory

Returns:

the AtmosphereResourceSessionFactory

isDestroyed

public boolean isDestroyed()

Return true is the destroy() method has been invoked.

Returns:

true is the destroy() method has been invoked.

frameworkListener

public AtmosphereFramework frameworkListener(AtmosphereFrameworkListener l)

Add a AtmosphereFrameworkListener

Parameters:

l - AtmosphereFrameworkListener

Returns:

this;

frameworkListeners

public java.util.List<AtmosphereFrameworkListener> frameworkListeners()

Return the list of AtmosphereFrameworkListener

Returns:

AtmosphereFrameworkListener

onPreInit

protected void onPreInit()

onPostInit

protected void onPostInit()

onPreDestroy

protected void onPreDestroy()

onPostDestroy

protected void onPostDestroy()

atmosphereResourceListeners

public java.util.List<AtmosphereResourceListener> atmosphereResourceListeners()

Return the list of AtmosphereResourceListener

Returns:

the list of AtmosphereResourceListener

atmosphereResourceListener

public AtmosphereFramework atmosphereResourceListener(AtmosphereResourceListener atmosphereResourceListener)

Add a AtmosphereResourceListener

Parameters:

atmosphereResourceListener - a AtmosphereResourceListener

Returns:

this

uuidProvider

public AtmosphereFramework uuidProvider(UUIDProvider uuidProvider)

Set a UUID like implementation for generating random UUID String

Parameters:

uuidProvider -

Returns:

this

uuidProvider

public UUIDProvider uuidProvider()

Return the UUIDProvider

Returns:

UUIDProvider

webSocketFactory

public WebSocketFactory webSocketFactory()

Return the WebSocketFactory

Returns:

the WebSocketFactory

webSocketFactory

public AtmosphereFramework webSocketFactory(WebSocketFactory webSocketFactory)

Configure the WebSocketFactory

Parameters:

webSocketFactory - the WebSocketFactory

Returns:

this

initializationError

public void initializationError(java.lang.IllegalStateException initializationError)

If a ContainerInitializer fail, log the excetion here.

Parameters:

initializationError -