Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Realtime Client Server Framework for the JVM, supporting WebSockets and Cross-Browser Fallbacks Support
Java
Branch: master
Pull request Compare This branch is 532 commits behind Atmosphere:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
assembly
license
modules
scripts
.gitignore
CNAME
README.md
pom.xml

README.md

LOGO

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 are either supporting Atmosphere or supported natively by the framework. The Atmosphere Framework supports all major Browsers and Servers.

Follow us on Twitter or Donate for rewarding contributors

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

The Atmosphere Framework Stack consists of:

Atmosphere Stack

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, Play! Framework or Vert.x. We support a variety of extensions like STOMP, Redis, Hazelcast, JMS, JGroups and many more. Support for Socket.IO, SockJS and Cometd are also available.

Notice: Atmosphere 3, aka Vibe has landed. Get ready for the next generation of real time application for the web!

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 Sent 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.2.3</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 Sent 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.2.0 release: 2.2.3 2.2.2 2.2.1 2.2.0

2.1 release: 2.1.9 2.1.8 2.1.7 2.1.6 2.1.5 2.1.4 2.1.2 2.1.1 2.1.0

2.0 release: 2.0.10 2.0.9 2.0.8 2.0.7 2.0.6 2.0.5 2.0.4 2.0.3 2.0.2 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

Build Status

[Analytics]

Something went wrong with that request. Please try again.