Skip to content

Latest commit

 

History

History
65 lines (54 loc) · 24.3 KB

README.md

File metadata and controls

65 lines (54 loc) · 24.3 KB

Atmosphere WebSockets Samples for for Jersey, Jersey2, GWT, JavaScript, JQuery, Netty, Guice, Spring, RMI, RabbitMQ, Redis, Hazelcast, JGroups, jsr 356, Sockjs, Socket.IO, JMS, Vert.x, Play Framework, Java EE, Tomcat, Jetty, Undertow, JBoss, etc...

One sample to rule them all!

The table below describes every Atmosphere's sample by defining the server and client API used to build it. You can download the sample by clicking on its name or clone the workspace, build it and then do

  mvn jetty:run

or

  mvn tomcat7:run

Recommended samples for getting started are the chat, which demonstrate usage of all transports using an AtmosphereHandler, or the jquery-pubsub, which demonstrate how to switch from one transport to another using a Jersey Resources. If you are interested to write WebSocket only application, take a look at the atmosphere-websockethandler-pubsub sample. The pubsub sample contains a lot of small demonstration on how the Jersey extension can be used. If you are interested to write HTML5 Server Side Events application, take a look at the atmosphere-sse-xxx samples.

If you plan to use Spring or GWT, take a look at their specific samples.

[Analytics]

All sample supports WebSocket and Long Polling by default. Streaming and JSONP are supported by the majority of pubsub samples. If you are interested to write HTML5 Server Side Events application, take a look at the atmosphere-sse-xxx samples.

Sample Name Description Server Components Client Components
all-api-pubsub This sample implements a pubsub example that demonstrates all Atmosphere's API and extension. The use of AtmosphereResource, Meteor, Annotation like @Suspend and @Broadcast are demonstrated AtmosphereHandler Jersey Resource Meteor WebSocketProtocol Single Callback supporting WebSocket, Long-Polling, JSONP, Http-Streaming
async-annotation-pubsub This sample demonstrates the use of the @Asynchronous annotation combined with the Callable API, showing how an application can be fully asynchronous in its execution. The sample implements the pubsub concepts. Jersey Resource Single Callback supporting WebSocket, Long-Polling, JSONP, Http-Streaming
atmosphere-ee6 This sample demonstrates the use of @Suspend with Java EE's 6 annotation like @Resource and EJB Timer Jersey Resource Http-Streaming
channel This sample demonstrate the use of @Subscribe and @Publish annotation using a pub sub application. If you are migrating from CometD, this sample is for you. Jersey Resource
chat-guice This sample demonstrate the use of Google Guice with Atmosphere. The Chat application is implemented using @Suspend and @Broadcast annotation Guice Jersey Resource Javascript Functions demonstrating WebSocket, falling back to Long-Polling
chat This sample demonstrates the use of WebSocket (falling back to SSE and Long-Polling) using the @ManagedService annotation. The sample also demonstrates how to detect which transport are supported by the client and server by negotiating with the server. Chat Javascript Functions demonstrating WebSocket, falling back to Long-Polling. This is the recommended sample to start with.
chat-multiroom This sample demonstrates the use of WebSocket (falling back SSE and to Long-Polling) using the @ManagedService annotation with Encoder and Decoder. The sample also demonstrates how to detect which transport are supported by the client and server by negotiating with the server. Chatroom Javascript Functions demonstrating WebSocket, falling back to Long-Polling. This is the recommended sample to start with.
cxf-node-client This sample demonstrates atmosphere.js with node.js. This client can be used agaist various samples such as chat, websocket-chat, ... Javascript Functions
cxf-chat This sample demonstrates the use of WebSocket (falling back SSE and to Long-Polling) in other framework using Atmosphere. CXF Javascript Functions
cxf-chat-osgi This sample is an OSGi version of cxf-chat that demonstrates the use of Atmosphere in an OSGi container. The code is identical to that of cxf-chat and it only differs in its pom.xml file so that the appropriate bundle descriptor is generated in its manifest.mf file. CXF OSGi Javascript Functions
di-guice-sample The sample demonstrates the use of Atmosphere's Dependencies Injection using Guice Jersey Resource Guice Javascript Callback
jersey2-chat This samples demonstrates the use of JAX RS Specification 2 with @AtmosphereService Jersey Resource Javascript Functions demonstrating WebSocket, falling back to Long-Polling
atmospherehandler-pubsub This sample demonstrate the use of AtmosphereHandler for implementing a pub sub application. The sample supports Long-Polling, Http Streaming and WebSocket AtmosphereHandler Javascript Function
atmosphere-meteor-pubsub This sample demonstrate the use of the Meteor API, from a Servlet, for implementing a pub sub application. The sample supports Long-Polling, Http Streaming and WebSocket Meteor Javascript Function
jquery-multirequest This sample demonstrates how multi requests can be made using the jQuery.atmosphere.js. The sample implements the pub sub application. Jersey Resource Per Request and Global callback
jquery-pubsub This sample demonstrates all transports (WebSockets, Server Side Events, Long-Polling, Http Streaming and JSONP using a super simple Jersey Resource. The sample implements a pub sub application. Jersey Resource Javascript Function
jquery-websockethandler-pubsub This sample demonstrates how to write WebSocket only application WebSocketHandler Javascript Funtion
jquery-pubsub This sample demonstrates a lot of server side functionality like broadcast/suspend/resume using a Jersey Resource. Jersey Resource
meteor-chat This sample demonstrates of the Meteor API, from a Servlet, can be used to implement a chat application Meteor Javascript Function
meteor-pubsub This sample demonstrates of the Meteor API, from a Servlet, can be used to implement a chat application Meteor Javascript Function
rest-chat This sample demonstrates the use of a Jersey Resource for implementing a chat application Jersey Resource Javascript Function
scala-chat This sample demonstrates how to use Scala to write a chat application Scala Resource Javascript Function
spring-tiles This sample demonstrates how to use the Spring and Tiles Framework with AtmosphereHandler. The sample implements a pubsub application Spring Controller Javascript Function
spring-websocket This sample demonstrates the use of Spring with Atmosphere WebSocketHandler, Meteor and AtmosphereHandler Meteor Service WebSocketProtocol Spring View
sse-chat This sample demonstrates how to use HTML 5 Server Sides Events to build a chat application using an AtmosphereHandler AtmosphereHandler Javascript Function
sse-rest-chat This sample demonstrates how to use HTML 5 Server Sides Events to build a chat application using a Jersey Resource Jersey Resource Javascript Function
twitter-live-feed This sample demonstrates how to use jQuery.atmosphere.js to implements a real time Twitter Search using a simple Jersey Resource. It also demonstrate how BroadcastFilter can be used to mark to handle large set of data to send back to the client Jersey Resource JavaScript Function
socketio-chat This sample demonstrates how the SocketIO library can be used, trsnaparently, using an AtmosphereHandler AtmosphereHandler SocketIO
native-socketio-chat This sample demonstrates how the SocketIO library and natively extending the SocketIO protocol on the server side AtmosphereHandler SocketIO
cometd/bayeux protocol This sample deploy the Cometd official demo on top of Atmosphere
websocket-chat This sample demonstrates how to write WebSocket ONLY applications WebSockerHandler JavaScript Function
websocket-stream This sample demonstrates how to write WebSocket streaming applications WebSockerHandler JavaScript Function
gwt2-jersey-rpc GWT RPC with Jersey Server Client
gwt20-json GWT with JSON Server Client
gwt20-managed-rpc GWT RPC using the @ManagedService annotation Server Client
gwt20-rpc GWT RPC using the an AtmosphereHandler Server Client
gwt20-websockets GWT client websockets using com.sksamuel.gwt websocket-stream Client

Note that for those samples using jQuery, version 2.x is used and they are not compatible with IE 6, 7, and 8. Try other browsers. For more information, see https://jquery.com/browser-support/