org.atmosphere.cpr
Class Meteor

java.lang.Object
  org.atmosphere.cpr.Meteor

public class Meteor
extends Object

A Meteor is a simple class that can be used from a Servlet to suspend, broadcast and resume a response. A Meteor can be created by invoking the build() method.

Meteor.build(HttpServletRequest).suspend(-1);

A Meteor is usually created when an application need to suspend a response. A Meteor instance can then be cached and re-used later for either broadcasting a message, or when an application needs to resume the suspended response.

Author:

Jeanfrancois Arcand

Method Summary

void	attach(Object o) Attach an Object with this Meteor
Object	attachement() Return an Object with this Meteor
Meteor	broadcast(Object o) Broadcast an Object to all suspended response.
static Meteor	build(HttpServletRequest r) Create a Meteor using the HttpServletRequest
static Meteor	build(HttpServletRequest req, List<BroadcastFilter> l, Serializer s) Create a Meteor using the HttpServletRequest and use a list of BroadcastFilter and Serializer for writting the result of a broadcast operation the HttpServletResponse.
static Meteor	build(HttpServletRequest r, Serializer s) Create a Meteor using the HttpServletRequest and use the Serializer for writting the result of a broadcast operation using the HttpServletResponse
static Meteor	lookup(HttpServletRequest r) Retrieve an instance of Meteor based on the HttpServletRequest
Meteor	resume() Resume the underlying HttpServletResponse
Meteor	suspend(long l) Suspend the underlying HttpServletResponse.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

lookup

public static Meteor lookup(HttpServletRequest r)

Retrieve an instance of Meteor based on the HttpServletRequest

Parameters:

r - HttpServletRequest

Returns:

a Meteor or null if not found

build

public static final Meteor build(HttpServletRequest r)

Create a Meteor using the HttpServletRequest

Parameters:

r - an HttpServletRequest

Returns:

a Meteor than can be used to resume, suspend and broadcast Object

build

public static final Meteor build(HttpServletRequest r,
                                 Serializer s)

Create a Meteor using the HttpServletRequest and use the Serializer for writting the result of a broadcast operation using the HttpServletResponse

Parameters:

r - an HttpServletRequest

Returns:

a Meteor than can be used to resume, suspend and broadcast Object

build

public static final Meteor build(HttpServletRequest req,
                                 List<BroadcastFilter> l,
                                 Serializer s)

Create a Meteor using the HttpServletRequest and use a list of BroadcastFilter and Serializer for writting the result of a broadcast operation the HttpServletResponse.

Parameters:

r - an HttpServletRequest

Returns:

a Meteor than can be used to resume, suspend and broadcast Object

suspend

public Meteor suspend(long l)

Suspend the underlying HttpServletResponse. Passing value of -1 suspend the response forever.

Parameters:

l - the maximum time a response stay suspended.

Returns:

Meteor

resume

public Meteor resume()

Resume the underlying HttpServletResponse

Returns:

Meteor

broadcast

public Meteor broadcast(Object o)

Broadcast an Object to all suspended response.

Parameters:

o - an Object

Returns:

Meteor

attachement

public Object attachement()

Return an Object with this Meteor

Returns:

the Object

attach

public void attach(Object o)

Attach an Object with this Meteor