org.cometd.client
Class BayeuxClient

java.lang.Object
  org.eclipse.jetty.util.component.AbstractLifeCycle
      org.cometd.client.BayeuxClient

All Implemented Interfaces:

Client, org.eclipse.jetty.util.component.LifeCycle

public class BayeuxClient
extends org.eclipse.jetty.util.component.AbstractLifeCycle
implements Client

Bayeux protocol Client.

Implements a Bayeux Ajax Push client as part of the cometd project.

The HttpClient attributes are used to share a Timer and MessagePool instance between all Bayeux clients sharing the same HttpClient.

Author:

gregw

See Also:

http://cometd.org

Nested Class Summary

protected class	BayeuxClient.Connect The Bayeux Connect exchange.
protected class	BayeuxClient.Exchange The base class for all bayeux exchanges.
protected class	BayeuxClient.Handshake The Bayeux handshake exchange.
protected class	BayeuxClient.Publish Publish message exchange.

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

org.eclipse.jetty.util.component.LifeCycle.Listener

Field Summary

protected org.eclipse.jetty.client.Address	_cometdAddress
protected Extension[]	_extensions
protected org.eclipse.jetty.client.HttpClient	_httpClient
protected org.eclipse.jetty.util.ajax.JSON	_jsonOut
protected MessagePool	_msgPool

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

_listeners, FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Constructor Summary

BayeuxClient(org.eclipse.jetty.client.HttpClient client, org.eclipse.jetty.client.Address address, java.lang.String uri)

BayeuxClient(org.eclipse.jetty.client.HttpClient client, org.eclipse.jetty.client.Address address, java.lang.String path, java.util.Timer timer)

BayeuxClient(org.eclipse.jetty.client.HttpClient client, java.lang.String url)

BayeuxClient(org.eclipse.jetty.client.HttpClient client, java.lang.String url, java.util.Timer timer)

Method Summary

void	addExtension(Extension ext)
void	addListener(ClientListener listener)
protected void	customize(org.eclipse.jetty.client.HttpExchange exchange) Customize an Exchange.
void	deliver(Client from, Message message) (non-Javadoc)
void	deliver(Client from, java.lang.String toChannel, java.lang.Object data, java.lang.String id)
void	disconnect() Disconnect this client.
protected void	doStart()
protected void	doStop()
void	endBatch()
protected void	extendIn(Message message) Called to extend inbound messages
protected void	extendOut(Message message) Called to extend outbound messages
protected java.lang.String	extendOut(java.lang.String msg) Called to extend outbound string messages.
int	getBackoffInterval()
int	getBackoffMaxRetries()
java.lang.String	getId()
Listener	getListener() Deprecated.
int	getMaxQueue()
java.util.Queue<Message>	getQueue()
boolean	hasMessages()
protected boolean	isInitialized()
boolean	isLocal()
boolean	isPolling()
protected void	metaConnect(boolean success, Message message) Called with the results of a /meta/connect message
protected void	metaHandshake(boolean success, boolean reestablish, Message message) Called with the results of a /meta/handshake message
protected void	metaPublishFail(java.lang.Throwable e, Message[] messages) Called with the results of a failed publish
void	publish(java.lang.String toChannel, java.lang.Object data, java.lang.String msgId)
void	remove() Deprecated. use disconnect()
void	removeListener(ClientListener listener)
protected boolean	send(BayeuxClient.Exchange exchange, boolean backoff) Send the exchange, possibly using a backoff.
protected void	send(org.eclipse.jetty.client.HttpExchange exchange) Send the exchange.
void	setBackOffInterval(int interval) If unable to connect/handshake etc, even if following the interval in the advice, wait for this interval and try again, up to a maximum of _backoffRetries
void	setBackoffMaxRetries(int retries)
void	setCookie(javax.servlet.http.Cookie cookie)
protected void	setInitialized(boolean b) False when we have received a success=false message in response to a Connect, or we have had an exception when sending or receiving a Connect.
void	setListener(Listener listener) Deprecated.
void	setMaxQueue(int max)
void	startBatch()
void	subscribe(java.lang.String toChannel)
java.util.List<Message>	takeMessages()
void	unsubscribe(java.lang.String toChannel)

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Methods inherited from class java.lang.Object

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

Field Detail

_httpClient

protected org.eclipse.jetty.client.HttpClient _httpClient

_msgPool

protected MessagePool _msgPool

_cometdAddress

protected org.eclipse.jetty.client.Address _cometdAddress

_extensions

protected Extension[] _extensions

_jsonOut

protected org.eclipse.jetty.util.ajax.JSON _jsonOut

Constructor Detail

BayeuxClient

public BayeuxClient(org.eclipse.jetty.client.HttpClient client,
                    java.lang.String url)

BayeuxClient

public BayeuxClient(org.eclipse.jetty.client.HttpClient client,
                    java.lang.String url,
                    java.util.Timer timer)

BayeuxClient

public BayeuxClient(org.eclipse.jetty.client.HttpClient client,
                    org.eclipse.jetty.client.Address address,
                    java.lang.String path,
                    java.util.Timer timer)

BayeuxClient

public BayeuxClient(org.eclipse.jetty.client.HttpClient client,
                    org.eclipse.jetty.client.Address address,
                    java.lang.String uri)

Method Detail

addExtension

public void addExtension(Extension ext)

Specified by:

addExtension in interface Client

setBackOffInterval

public void setBackOffInterval(int interval)

If unable to connect/handshake etc, even if following the interval in the advice, wait for this interval and try again, up to a maximum of _backoffRetries

Parameters:

interval -

getBackoffInterval

public int getBackoffInterval()

setBackoffMaxRetries

public void setBackoffMaxRetries(int retries)

getBackoffMaxRetries

public int getBackoffMaxRetries()

getId

public java.lang.String getId()

Specified by:

getId in interface Client

doStart

protected void doStart()
                throws java.lang.Exception

Overrides:

doStart in class org.eclipse.jetty.util.component.AbstractLifeCycle

Throws:

java.lang.Exception

doStop

protected void doStop()
               throws java.lang.Exception

Overrides:

doStop in class org.eclipse.jetty.util.component.AbstractLifeCycle

Throws:

java.lang.Exception

isPolling

public boolean isPolling()

deliver

public void deliver(Client from,
                    Message message)

(non-Javadoc)

deliver

public void deliver(Client from,
                    java.lang.String toChannel,
                    java.lang.Object data,
                    java.lang.String id)

Specified by:

deliver in interface Client

getListener

public Listener getListener()

Deprecated.

hasMessages

public boolean hasMessages()

Specified by:

hasMessages in interface Client

isLocal

public boolean isLocal()

Specified by:

isLocal in interface Client

publish

public void publish(java.lang.String toChannel,
                    java.lang.Object data,
                    java.lang.String msgId)

subscribe

public void subscribe(java.lang.String toChannel)

unsubscribe

public void unsubscribe(java.lang.String toChannel)

remove

public void remove()

Deprecated. use disconnect()

Disconnect this client.

disconnect

public void disconnect()

Disconnect this client.

Specified by:

disconnect in interface Client

setListener

public void setListener(Listener listener)

Deprecated.

takeMessages

public java.util.List<Message> takeMessages()

Specified by:

takeMessages in interface Client

endBatch

public void endBatch()

Specified by:

endBatch in interface Client

startBatch

public void startBatch()

Specified by:

startBatch in interface Client

customize

protected void customize(org.eclipse.jetty.client.HttpExchange exchange)

Customize an Exchange. Called when an exchange is about to be sent to allow Cookies and Credentials to be customized. Default implementation sets any cookies

setCookie

public void setCookie(javax.servlet.http.Cookie cookie)

addListener

public void addListener(ClientListener listener)

Specified by:

addListener in interface Client

removeListener

public void removeListener(ClientListener listener)

Specified by:

removeListener in interface Client

getMaxQueue

public int getMaxQueue()

Specified by:

getMaxQueue in interface Client

getQueue

public java.util.Queue<Message> getQueue()

Specified by:

getQueue in interface Client

setMaxQueue

public void setMaxQueue(int max)

Specified by:

setMaxQueue in interface Client

send

protected boolean send(BayeuxClient.Exchange exchange,
                       boolean backoff)

Send the exchange, possibly using a backoff.

Parameters:

exchange -

backoff - if true, use backoff algorithm to send

Returns:

send

protected void send(org.eclipse.jetty.client.HttpExchange exchange)
             throws java.io.IOException

Send the exchange.

Parameters:

exchange -

Throws:

java.io.IOException

setInitialized

protected void setInitialized(boolean b)

False when we have received a success=false message in response to a Connect, or we have had an exception when sending or receiving a Connect. True when handshake and then connect has happened.

Parameters:

b -

isInitialized

protected boolean isInitialized()

metaConnect

protected void metaConnect(boolean success,
                           Message message)

Called with the results of a /meta/connect message

Parameters:

success - connect was returned with this status

metaHandshake

protected void metaHandshake(boolean success,
                             boolean reestablish,
                             Message message)

Called with the results of a /meta/handshake message

Parameters:

success - connect was returned with this status

reestablish - the client was previously connected.

metaPublishFail

protected void metaPublishFail(java.lang.Throwable e,
                               Message[] messages)

Called with the results of a failed publish

extendOut

protected java.lang.String extendOut(java.lang.String msg)

Called to extend outbound string messages. Some messages are sent as preformatted JSON strings (eg handshake and connect messages). This extendOut method is a variation of the extendOut(Message) method to efficiently cater for these preformatted strings.

This method calls the Extensions added by addExtension(Extension)

Parameters:

msg -

Returns:

the extended message

extendOut

protected void extendOut(Message message)

Called to extend outbound messages

This method calls the Extensions added by addExtension(Extension)

extendIn

protected void extendIn(Message message)

Called to extend inbound messages

This method calls the Extensions added by addExtension(Extension)