Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Realtime Client Server Framework for the JVM, supporting WebSockets with Cross-Browser Fallbacks
Java
branch: master

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

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.

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.

Atmosphere.Next

Active Development of Atmosphere 3 started. Join the community to help

Commercial support

Commercial Support is available via Async-IO.org

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 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.3.1</version>
      </dependency>

Where atmosphere-module can be: sockjs, kafka, jersey, runtime (main module), spring, guice, redis, hazelcast, jms, rabbitmq, 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

Versions

Change Log

2.3.x release: 2.3.1 2.3.0

2.2.x release: 2.2.7 2.2.6 2.2.5 2.2.4 2.2.3 2.2.2 2.2.1 2.2.0

2.1.x release: 2.1.11 2.1.10 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

End Of Life Versions (go to http://async-io.org for commercial support)

2.0.x 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.19 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]

@Copyright 2015 Async-IO.org

Something went wrong with that request. Please try again.