Skip to content

Latest commit

 

History

History
84 lines (47 loc) · 6.99 KB

README.md

File metadata and controls

84 lines (47 loc) · 6.99 KB

Welcome to Atmosphere: The Asynchronous WebSocket/Comet Framework

The Atmosphere Framework contains client and server side components. The majority of popular frameworks are either supporting Atmosphere or supported natively by the framework. The Atmosphere Framework supports all majors Browsers and Servers

Follow us on Twitter or get the latest news here

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

Official Documentation

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

To use Atmosphere, add the following dependency:

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

Where atmosphere-module can be: jersey, runtime (main module), guice, jquery, redis, hazelcast, jms, jgroups or gwt. Our official release are available from Maven Central download. Atmosphere supports the majority of Servers and Browsers

IMPORTANT: Migrating 0.x to the new 0.9 API

Jump directly inside the code: WebSocket, 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!

Must read

Writing a REST over WebSocket/Comet apps using JQuery

Which Atmosphere API should I use for my project?

Latest Publications

Introducing SwaggerSocket

What's new in Atmosphere 0.9

Comet/WebSocket? Introducing the Atmosphere framework

Latest Presentation - Writing highly scalable WebSocket using the Atmosphere Framework

Quick Start

To quickly see what Atmosphere can do with WebSocket and Comet, and If you want to play with Redis, Hazelcast, ActiveMQ(JMS) or XMPP(Gmail), download the JQueryPubSub sample, uncomments the appropriate technology in the pom.xml, re-war the file or manually drop the atmosphere-{technology-name}.jar under your WEB-INF/lib to enabled it automatically

For SNAPSHOT, you'll have to add the Sonatype repo to your settings in order to be able to access the snapshot builds Browse the artifact

Several Samples are available Download the sample, rename the file without the maven version

RoadMap

Atmosphere 0.9 is our official release, and our work in progress version is 1.0, targeted for end of End of May 2012

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

Browse sample's code

Guice

Spring

PubSub

JQueryPubSub

Twitter Search

JavaScript Multi Request

EJB

AtmosphereHandler

Meteor

JAXRS 2.0 Async API

Changes logs

0.9 release: 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