Awesome
Welcome to Atmosphere: The Event Driven Framework supporting WebSocket and HTTP
The Atmosphere Framework contains client and server side components for building Asynchronous Web Applications. Atmosphere transparently supports WebSockets, Server Sent Events (SSE), Long-Polling, HTTP Streaming and JSONP.
The Atmosphere Framework works on all Servlet based servers, Spring Boot and frameworks like Netty, Play! Framework and Vert.x. We support a variety of extensions like Apache Kafka, Hazelcast, RabbitMQ, Redis and many more.
Atmosphere's Java/Scala/Android Client is called wAsync.
Atmosphere 3.0.x on JDK 17 and 23
Atmosphere 2.7.x on JDK 8 up to 23
Commercial support
Commercial Support is available via Async-IO.org
To use Atmosphere, add the following dependency:
<dependency>
<groupId>org.atmosphere</groupId>
<artifactId>atmosphere-runtime</artifactId>
<version>3.0.13</version>
</dependency>
or
<dependency>
<groupId>org.atmosphere</groupId>
<artifactId>atmosphere-{atmosphere-module}</artifactId>
<version>2.7.15</version>
</dependency>
atmosphere-module can be: runtime (main module), jersey, spring, kafka, guice, redis, hazelcast, jms, rabbitmq, jgroups etc. Our official releases are available from Maven Central download.
Official Documentation
Complete repository of samples sample.
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.
Getting started
Here's how to get your first Atmosphere project off the ground.
Prerequisites
Ensure you have Java 8 (or later) installed on your system. For managing your Java Project and its dependencies, you'll need a build automation tool. We recommend Maven, which is widely used in the Java ecosystem.
Project Setup
Create a new project using Maven. Add Atmosphere as a dependency in your pom.xml
to access all the necessary libraries.
Server Configuration
In your project, you'll define a server endpoint that listens to incoming connections. Atmosphere's annotations and resource handlers make this process straightforward.
Running Your Server
With the server set up, use your IDE or the Maven CLI to compile and run your application.
Create a Client
Your web client will need to establish a connection to your server. You can create a simple HTML page with JavaScript to connect and communicate with your server endpoint.
Keep Going!
Once you've got the basics down, explore the full range of Atmosphere's capabilities to create more sophisticated real-time applications.
For detailed instructions, examples, and advanced configurations, refer to the official Atmosphere tutorial. Z
Supported Atmosphere Versions
Atmosphere 2.7.x requires JDK 8 or 11. Atmosphere 3.0.x requires JDK 11.
@Copyright 2008-2024 Async-IO.org