org.atmosphere.wasync
Class OptionsBuilder<U extends Options,T extends OptionsBuilder<U,T>>

java.lang.Object
  org.atmosphere.wasync.OptionsBuilder<U,T>

Type Parameters:

T -

Direct Known Subclasses:

DefaultOptionsBuilder, SerializedOptionsBuilder

public abstract class OptionsBuilder<U extends Options,T extends OptionsBuilder<U,T>>
extends Object

Base class for building Options

Author:

Jeanfrancois Arcand

Field Summary

protected Class<T>

derived

Constructor Summary

protected

OptionsBuilder(Class<T> derived)

Method Summary

abstract U	build() Build an Options
T	pauseBeforeReconnectInSeconds(int reconnectInSecond) The time in second, before the reconnection occurs.
boolean	reconnect() Reconnect after a network failure or when the server close the connection.
T	reconnect(boolean reconnect) Automatically reconnect in case the connection get closed.
int	reconnectInSeconds() The delay, in second, before reconnecting.
T	registerTransport(Transport transport) Register a new Transport implementation.
int	requestTimeoutInSeconds() The time, in seconds to wait before closing the connection.
T	requestTimeoutInSeconds(int requestTimeout) The time, in seconds, the connection will stay open when waiting for new messages.
com.ning.http.client.AsyncHttpClient	runtime() The AsyncHttpClient used to communicate with server.
T	runtime(com.ning.http.client.AsyncHttpClient client) Allow an application that want to share AsyncHttpClient or configure it before it gets used by the library.
T	runtime(com.ning.http.client.AsyncHttpClient client, boolean runtimeShared) Allow an application that want to share AsyncHttpClient or configure it before it gets used by the library.
boolean	runtimeShared() Return true is the AsyncHttpClient is shared between Socket.
T	runtimeShared(boolean runtimeShared) Set to true if your AsyncHttpClient is shared between clients.
Transport	transport() The used Transport
long	waitBeforeUnlocking() The delay before considering the http connection has been fully processed by the server.
T	waitBeforeUnlocking(long waitBeforeUnlocking) For streaming and long-polling, the server may not send the headers so the client never knows if the connection succeeded or not.

Methods inherited from class java.lang.Object

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

Field Detail

derived

protected final Class<T extends OptionsBuilder<U,T>> derived

Constructor Detail

OptionsBuilder

protected OptionsBuilder(Class<T> derived)

Method Detail

requestTimeoutInSeconds

public T requestTimeoutInSeconds(int requestTimeout)

The time, in seconds, the connection will stay open when waiting for new messages. This can be seen as the idle time.

Returns:

this

registerTransport

public T registerTransport(Transport transport)

Register a new Transport implementation. Register a transport only if you are planning to use a different transport than the supported one.

Parameters:

transport - Transport

Returns:

this

reconnect

public T reconnect(boolean reconnect)

Automatically reconnect in case the connection get closed. Default is true

Parameters:

reconnect - reconnect in case the connection get closed. Default is true

Returns:

this

pauseBeforeReconnectInSeconds

public T pauseBeforeReconnectInSeconds(int reconnectInSecond)

The time in second, before the reconnection occurs. Default is 1 second

Parameters:

reconnectInSecond - time in second, before the reconnection occurs. Default is 1 second

Returns:

this

waitBeforeUnlocking

public T waitBeforeUnlocking(long waitBeforeUnlocking)

For streaming and long-polling, the server may not send the headers so the client never knows if the connection succeeded or not. By default the library will wait for 2500 milliseconds before considering the connection established.

Parameters:

waitBeforeUnlocking - the time in millisecond

Returns:

this

runtimeShared

public T runtimeShared(boolean runtimeShared)

Set to true if your AsyncHttpClient is shared between clients. by the library.

Parameters:

runtimeShared - true if your AsyncHttpClient is shared between clients.

Returns:

this;

runtime

public T runtime(com.ning.http.client.AsyncHttpClient client)

Allow an application that want to share AsyncHttpClient or configure it before it gets used by the library. Application must call AsyncHttpClient.close() at the end of their execution as the library won't close it since shared.

Parameters:

client -

Returns:

this;

runtime

public T runtime(com.ning.http.client.AsyncHttpClient client,
                 boolean runtimeShared)

Allow an application that want to share AsyncHttpClient or configure it before it gets used by the library.

Parameters:

client -

runtimeShared - to true if the runtime is shared between clients. If shared, the asyncHttpClient.close() must be invoked by the application itself.

Returns:

this;

build

public abstract U build()

Build an Options

Returns:

Options

transport

public Transport transport()

The used Transport

Returns:

Transport

reconnect

public boolean reconnect()

Reconnect after a network failure or when the server close the connection.

Returns:

reconnect

reconnectInSeconds

public int reconnectInSeconds()

The delay, in second, before reconnecting.

Returns:

The delay, in second, before reconnecting.

waitBeforeUnlocking

public long waitBeforeUnlocking()

The delay before considering the http connection has been fully processed by the server. By default, the library will wait 2 seconds before allowing the Socket.fire(Object) to send message. Server side framework that aren't sending any data when suspending a connection may not be ready to fullfil request, hence some data may be lost. Framework like Atmosphere, Socket.io, Cometd do send some "handshake data" allow the fire operation to be available fast without loosing ant data.

runtime

public com.ning.http.client.AsyncHttpClient runtime()

The AsyncHttpClient used to communicate with server.

Returns:

AsyncHttpClient used to communicate with server.

runtimeShared

public boolean runtimeShared()

Return true is the AsyncHttpClient is shared between Socket. Default is false. You need to invoke runtime(com.ning.http.client.AsyncHttpClient) to make it shared.

Returns:

true is the AsyncHttpClient

requestTimeoutInSeconds

public int requestTimeoutInSeconds()

The time, in seconds to wait before closing the connection.

Returns:

The time, in seconds to wait before closing the connection.