org.atmosphere.cpr

Class AtmosphereSession

java.lang.Object

org.atmosphere.cpr.AtmosphereSession

public class AtmosphereSession
extends Object

An AtmosphereSession allow an application to keep track of the AtmosphereResource associated with a remote client. For example, with the long-polling transport, a new AtmosphereResource will be created every time a reconnect occurs. If an application has a reference to the AtmosphereResource, the object will become out of scope, or unusable, after the reconnection. To fix this problem, you can use this class to track and invoke tryAcquire() ()} or acquire()} in order to get the AtmosphereResource.

AtmosphereResource are tracked using the list of associated Broadcaster, e.g you must make sure the AtmosphereResource has called Broadcaster.addAtmosphereResource(AtmosphereResource) once if you want this class to work.

Author:

Jeanfrancois Arcand

Constructor Summary

Constructors

Constructor and Description
AtmosphereSession(AtmosphereResource resource) Track the current AtmosphereResource with all created Broadcaster
AtmosphereSession(AtmosphereResource r, Broadcaster... broadcasters)

Method Summary

Methods

Modifier and Type	Method and Description
AtmosphereResource	acquire() Retrieve the AtmosphereResource associated with this session.
void	close()
AtmosphereResource	tryAcquire() Retrieve the AtmosphereResource associated with this session.
AtmosphereResource	tryAcquire(int timeInSecond) Retrieve the AtmosphereResource associated with this session.
String	uuid()

Methods inherited from class java.lang.Object

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

Constructor Detail

AtmosphereSession

public AtmosphereSession(AtmosphereResource r,
                 Broadcaster... broadcasters)

AtmosphereSession

public AtmosphereSession(AtmosphereResource resource)

Track the current AtmosphereResource with all created Broadcaster

Parameters:

resource - an AtmosphereResource

Method Detail

acquire

public AtmosphereResource acquire()

Retrieve the AtmosphereResource associated with this session. If there is no AtmosphereResource associated, return null.

Returns:

an AtmosphereResource

tryAcquire

public AtmosphereResource tryAcquire()
                              throws InterruptedException

Retrieve the AtmosphereResource associated with this session. If there is no AtmosphereResource associated, wait until the AtmosphereResource is retrieved. This method will wait 60 seconds and then return.

Returns:

an AtmosphereResource

Throws:

InterruptedException

tryAcquire

public AtmosphereResource tryAcquire(int timeInSecond)
                              throws InterruptedException

Retrieve the AtmosphereResource associated with this session. If there is no AtmosphereResource associated, wait until the AtmosphereResource is retrieved.

Parameters:

timeInSecond - The timeToWait before continuing the execution

Returns:

an AtmosphereResource

Throws:

InterruptedException

close

public void close()

uuid

public String uuid()