Realtime Client Server Framework for the JVM, supporting WebSockets with Cross-Browser Fallbacks
Java
Latest commit cd813ef Aug 22, 2016 @jfarcand jfarcand committed on GitHub Merge pull request #2203 from saikiran939/master
ISSUE #2144 and ISSUE #2199

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.

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.4.5</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!.

Top

Atmosphere and JDK Versions

Atmosphere 2.3.x and older can run on JDK 1.6 or newer.

Atmosphere 2.4.x requires JDK 1.7 or newer

Atmosphere 2.5.x requires JDK 1.8

Versions

Change Log

2.4.x release: 2.4.5 2.4.4 2.4.3 2.4.2 2.4.1 2.4.0

2.3.x release: 2.3.8 2.3.7 2.3.6 2.3.5 2.3.4 2.3.3 2.3.2 2.3.1 2.3.0

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

2.2.x release: 2.2.9 2.2.8 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.12 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

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 2016 Async-IO.org