gdrouet/atmosphere

Realtime Client Server Framework for the JVM, supporting WebSockets and Cross-Browser Fallbacks Support

Please vote for us as the Most Innovative Java Technology

The Atmosphere Framework has been nominated as the "Most Innovative Java Technology". Please vote for us!

### Welcome to Atmosphere: The Asynchronous WebSocket/Comet Framework The Atmosphere Framework contains client and server side components for building Asynchronous Web Applications. 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 major [Browsers and Servers](https://github.com/Atmosphere/atmosphere/wiki/Supported-WebServers-and-Browsers). Follow us on [Twitter](http://www.twitter.com/atmo_framework).

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 servers 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). We support a variety of extensions like [STOMP](https://github.com/Atmosphere/atmosphere-stomp/), [Redis](https://github.com/Atmosphere/atmosphere-extensions/tree/master/redis), [Hazelcast](https://github.com/Atmosphere/atmosphere-extensions/tree/master/hazelcast), [JMS](https://github.com/Atmosphere/atmosphere-extensions/tree/master/jms), [JGroups](https://github.com/Atmosphere/atmosphere-extensions/tree/master/jgroups) and [many more](https://github.com/Atmosphere/atmosphere-extensions/). Support for [Socket.IO](https://github.com/Atmosphere/atmosphere-extensions/tree/master/socketio), [SockJS](https://github.com/Atmosphere/atmosphere-extensions/tree/master/sockjs) and [Cometd](https://github.com/Atmosphere/atmosphere-extensions/tree/master/cometd) are also available.

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

Atmosphere's Java/Scala/Android Client is called wAsync.

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 the 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 implement WebSockets, Server Side Events, Long Polling, HTTP Streaming and JSONP client applications. Take a look at this page to pick the best sample to start with.

To use Atmosphere, add the following dependency:

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

Where atmosphere-module can be: jersey, runtime (main module), guice, redis, hazelcast, jms, jgroups or gwt. Our official releases 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

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

Top

Changelogs

2.1 release: 2.1.4 2.1.2 2.1.1 2.1.0

2.0 release: 2.0.8 2.0.7 2.0.6 2.0.5 2.0.4 2.0.3 [2.0.2] (http://goo.gl/44qnsU) 2.0.1

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

Top

Build Status