Using Atmosphere's Annotations

Configuring your application

If you are using Atmosphere Runtime, you can configure your application using an atmosphere.xml or web.xml's init-param, or use Atmosphere's Annotation. The available annotations are:

Using annotation

First, add in your pom.xml if you are using Atmosphere 1.0.x. Not needed with 1.1

        <dependency>
            <groupId>eu.infomas</groupId>
            <artifactId>annotation-detector</artifactId>
            <version>3.0.1</version>
        </dependency>

Next, define the following in your web/application.xml

        <init-param>
            <param-name>org.atmosphere.cpr.packages</param-name>
            <param-value>you.class.package</param-value>
        </init-param>

The available annotations are:

• AtmosphereHandlerService : At least on class must be annotated with this annotation if you are using AtmosphereServlet. The class must implements the AtmosphereHandler interface. See this tutorial for more information.
• BroadcasterCacheService : If you are planning to support your own BroadcasterCache implementation, use this annotation to tell Atmosphere to use it.
• BroadcasterFilterService : If you want to add BroadcastFilter to your application, annotate them using this annotation.
• BroadcasterService : If you are planning to support your own Broadcaster implementation, use this annotation to tell Atmosphere to use it.
• MeteorService : At least on class must be annotated with this annotation if you are using Atmosphere as as MeteorServlet. This class will install Meteor automatically.
• WebSocketHandlerService : If you want to write pure WebSocket application.
• WebSocketProtocolService : If you want to write your own WebSocketProtocol support for Atmosphere.
• AtmosphereInterceptor : Install AtmosphereInterceptor
• AsyncSupportListenerService : You can install a global events listener using that annotation. Read this document for more information.
• ManagedService A Meta Annotation which install a BroadcasterCache and several AtmosphereInterceptor.