README.md

### Welcome to Atmosphere: The Asynchronous WebSocket/Comet Framework The Atmosphere Framework contains client and server side components for building Asynchronous Web Application. The majority of [popular frameworks](https://github.com/Atmosphere/atmosphere/wiki/Atmosphere-PlugIns-and-Extensions) are either supporting Atmosphere or supported natively by the framework. The Atmosphere Framework supports all majors [Browsers and Servers](https://github.com/Atmosphere/atmosphere/wiki/Supported-WebServers-and-Browsers) Follow us on [Twitter](http://www.twitter.com/atmo_framework) or get the latest news [here](http://jfarcand.wordpress.com)

Atmosphere transparently supports WebSockets, Server Side Events (SSE), Long-Polling, HTTP Streaming (Forever frame) and JSONP.

The Atmosphere Framework Stack consists of:

The Atmosphere Framework Stack works on all Servlet based server including Tomcat, JBoss Jetty, Resin, GlassFish, Undertow, WebSphere, WebLogic etc. Not running a Servlet Container? [Netty](http://atmosphere.github.io/nettosphere/) [Play! Framework](http://atmosphere.github.io/atmosphere-play/) or [Vert.x](https://github.com/Atmosphere/atmosphere-vertx)

Using another framework? Look at the list of supported extensions. Easiest way to learn Atmosphere is by trying a sample

Commercial support now available!

Commercial Support is now available via Async-IO.org Want the project to stay alive? Please donate by visiting the Async-IO.org and click on donate button!

Tutorial

Get started using this step by step tutorial

Official Documentation

Our Wiki contains several tutorials for getting started as well as FAQ. You can also browse the framework's Javadoc for Server Components, and atmosphere.js for Client Components

Quick Start

The Atmosphere's Framework ships with many examples describing how to implements WebSockets, Server Side Events, Long Polling, Http Streaming and JSONP client's application. Take a look at this page to pick the best sample to starts with.

To use Atmosphere, add the following dependency:

     <dependency>
         <groupId>org.atmosphere</groupId>
         <artifactId>atmosphere-{atmosphere-module}</artifactId>
         <version>2.0.0.RC5</version>
      </dependency>

Where atmosphere-module can be: jersey, runtime (main module), guice, redis, hazelcast, jms, jgroups or gwt. Our official release are available from Maven Central download.

Jump directly inside the code: WebSockets, Server Side Events (SSE), Long-Polling, JSONP and Http Streaming!

Take a look at the PubSub Client-Server or the infamous Chat Client-Server to realize how simple Atmosphere is!

Top

Latest version

     <dependency>
         <groupId>org.atmosphere</groupId>
         <artifactId>atmosphere-{atmosphere-module}</artifactId>
         <version>1.0.17</version>
      </dependency>

If you where using Atmosphere's Client 1.0.x, please note that starting with version 1.0.15, the javascript has been updated to use the newest version of atmosphere-javascript. It is strongly recommended to use:

     <dependency>
         <groupId>org.atmosphere.client</groupId>
         <artifactId>jquery|javascript</artifactId>
         <version>2.0.x</version>
      </dependency>

to get the latest fixes.

Top

RoadMap

Atmosphere 1.0.17 is our official release, and our work in progress version is 2.0, targeted for end of September 20, 2013

If you are interested, subscribe to our mailing list for more info! We are on irc.freenode.net under #atmosphere-comet

Top

Changelogs

1.0 release: 1.0.17 1.0.16 1.0.14 1.0.13 1.0.11 1.0.10 1.0.8 1.0.6 1.0.5 1.0.4 1.0.3 1.0.2 1.0.1 1.0

0.9 release: 0.9.7 0.9.5 0.9.4 0.9.2/0.9.3 0.9.1 0.9.0

0.8 release: 0.8.6 0.8.5 0.8.4 0.8.3 0.8.2 0.8.0

Top

Build Status

Powered by Cloudbees

License

YourKit is kindly supporting open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products: YourKit Java Profiler and YourKit .NET Profiler