public class BayeuxClient extends AbstractClientSession implements Bayeux
BayeuxClient
is the implementation of a client for the Bayeux protocol.
A BayeuxClient
can receive/publish messages from/to a Bayeux server, and
it is the counterpart in Java of the JavaScript library used in browsers (and as such
it is ideal for Swing applications, load testing tools, etc.).
A BayeuxClient
handshakes with a Bayeux server
and then subscribes ClientSessionChannel.MessageListener
to channels in order
to receive messages, and may also publish messages to the Bayeux server.
BayeuxClient
relies on pluggable transports for communication with the Bayeux
server, and the most common transport is LongPollingTransport
, which uses
HTTP to transport Bayeux messages and it is based on
Jetty's HTTP client.
When the communication with the server is finished, the BayeuxClient
can be
disconnected from the Bayeux server.
Typical usage:
// Handshake String url = "http://localhost:8080/cometd"; BayeuxClient client = new BayeuxClient(url, LongPollingTransport.create(null)); client.handshake(); client.waitFor(1000, BayeuxClient.State.CONNECTED); // Subscription to channels ClientSessionChannel channel = client.getChannel("/foo"); channel.subscribe(new ClientSessionChannel.MessageListener() { public void onMessage(ClientSessionChannel channel, Message message) { // Handle the message } }); // Publishing to channels Map<String, Object> data = new HashMap<String, Object>(); data.put("bar", "baz"); channel.publish(data); // Disconnecting client.disconnect(); client.waitFor(1000, BayeuxClient.State.DISCONNECTED);
Modifier and Type | Class and Description |
---|---|
protected class |
BayeuxClient.BayeuxClientChannel
A channel scoped to this BayeuxClient.
|
static class |
BayeuxClient.State
The states that a
BayeuxClient may assume |
AbstractClientSession.AbstractSessionChannel
Bayeux.BayeuxListener
ClientSession.Extension, ClientSession.MessageListener
Modifier and Type | Field and Description |
---|---|
static String |
BACKOFF_INCREMENT_OPTION |
static String |
BAYEUX_VERSION |
protected org.slf4j.Logger |
logger |
static String |
MAX_BACKOFF_OPTION |
Constructor and Description |
---|
BayeuxClient(String url,
ClientTransport transport,
ClientTransport... transports)
Creates a
BayeuxClient that will connect to the Bayeux server at the given URL
and with the given transport(s). |
BayeuxClient(String url,
ScheduledExecutorService scheduler,
ClientTransport transport,
ClientTransport... transports)
Creates a
BayeuxClient that will connect to the Bayeux server at the given URL,
with the given scheduler and with the given transport(s). |
Modifier and Type | Method and Description |
---|---|
void |
abort()
Interrupts abruptly the communication with the Bayeux server.
|
void |
disconnect() |
void |
disconnect(ClientSessionChannel.MessageListener callback) |
boolean |
disconnect(long timeout)
Performs a
disconnect and uses the given timeout
to wait for the disconnect to complete. |
protected void |
enqueueSend(Message.Mutable message) |
List<String> |
getAllowedTransports() |
long |
getBackoffIncrement() |
HttpCookie |
getCookie(String name)
Retrieves the first cookie with the given name, if available.
|
CookieStore |
getCookieStore() |
String |
getId() |
Set<String> |
getKnownTransportNames() |
long |
getMaxBackoff() |
Object |
getOption(String qualifiedName) |
Set<String> |
getOptionNames() |
Map<String,Object> |
getOptions() |
protected BayeuxClient.State |
getState() |
ClientTransport |
getTransport() |
ClientTransport |
getTransport(String transport) |
String |
getURL() |
void |
handshake() |
void |
handshake(ClientSessionChannel.MessageListener callback) |
BayeuxClient.State |
handshake(long waitMs)
Performs the handshake and waits at most the given time for the handshake to complete.
|
void |
handshake(Map<String,Object> handshakeFields) |
void |
handshake(Map<String,Object> fields,
ClientSessionChannel.MessageListener callback) |
BayeuxClient.State |
handshake(Map<String,Object> template,
long waitMs)
Performs the handshake with the given template and waits at most the given time for the handshake to complete.
|
protected void |
initialize() |
boolean |
isConnected() |
boolean |
isDisconnected() |
boolean |
isHandshook() |
protected void |
messagesFailure(Throwable cause,
List<? extends Message> messages) |
protected AbstractClientSession.AbstractSessionChannel |
newChannel(ChannelId channelId) |
protected ChannelId |
newChannelId(String channelId) |
void |
onFailure(Throwable failure,
List<? extends Message> messages)
Callback method invoked when the given messages have failed to be sent.
|
void |
onMessages(List<Message.Mutable> messages)
Callback method invoke when the given messages have just arrived from the Bayeux server.
|
void |
onSending(List<? extends Message> messages)
Callback method invoked when the given messages have hit the network towards the Bayeux server.
|
protected void |
onTransportFailure(Message message,
ClientTransport.FailureInfo failureInfo,
ClientTransport.FailureHandler handler) |
protected void |
onTransportFailure(String oldTransportName,
String newTransportName,
Throwable failure) |
protected void |
processConnect(Message.Mutable connect) |
protected void |
processDisconnect(Message.Mutable disconnect) |
protected void |
processHandshake(Message.Mutable handshake) |
protected void |
processMessage(Message.Mutable message) |
void |
putCookie(HttpCookie cookie) |
protected boolean |
scheduleConnect(long interval,
long backOff) |
protected boolean |
scheduleHandshake(long interval,
long backOff) |
protected void |
send(Message.Mutable message) |
protected void |
sendBatch() |
protected boolean |
sendConnect() |
protected boolean |
sendHandshake() |
protected boolean |
sendMessages(List<Message.Mutable> messages) |
void |
setOption(String qualifiedName,
Object value) |
protected void |
terminate() |
boolean |
waitFor(long waitMs,
BayeuxClient.State state,
BayeuxClient.State... states)
Waits for this
BayeuxClient to reach the given state(s) within the given time. |
addExtension, batch, dump, dump, endBatch, extendRcv, extendSend, getAttribute, getAttributeNames, getChannel, getChannel, getChannels, getExtensions, isBatching, newMessage, newMessageId, notifyListener, notifyListeners, receive, registerCallback, registerSubscriber, remoteCall, removeAttribute, removeExtension, resetSubscriptions, setAttribute, startBatch, unregisterCallback, unregisterSubscriber
public static final String BACKOFF_INCREMENT_OPTION
public static final String MAX_BACKOFF_OPTION
public static final String BAYEUX_VERSION
protected final org.slf4j.Logger logger
public BayeuxClient(String url, ClientTransport transport, ClientTransport... transports)
Creates a BayeuxClient
that will connect to the Bayeux server at the given URL
and with the given transport(s).
This constructor allocates a new scheduler
; it is recommended that
when creating a large number of BayeuxClient
s a shared scheduler is used.
url
- the Bayeux server URL to connect totransport
- the default (mandatory) transport to usetransports
- additional optional transports to use in case the default transport cannot be usedBayeuxClient(String, ScheduledExecutorService, ClientTransport, ClientTransport...)
public BayeuxClient(String url, ScheduledExecutorService scheduler, ClientTransport transport, ClientTransport... transports)
Creates a BayeuxClient
that will connect to the Bayeux server at the given URL,
with the given scheduler and with the given transport(s).
url
- the Bayeux server URL to connect toscheduler
- the scheduler to use for scheduling timed operationstransport
- the default (mandatory) transport to usetransports
- additional optional transports to use in case the default transport cannot be usedpublic String getURL()
public long getBackoffIncrement()
getMaxBackoff()
public long getMaxBackoff()
getBackoffIncrement()
public CookieStore getCookieStore()
public HttpCookie getCookie(String name)
Retrieves the first cookie with the given name, if available.
Note that currently only HTTP transports support cookies.
name
- the cookie nameputCookie(HttpCookie)
public void putCookie(HttpCookie cookie)
public boolean isHandshook()
isHandshook
in interface Session
public boolean isConnected()
isConnected
in interface Session
public boolean isDisconnected()
BayeuxClient
is disconnecting or disconnectedprotected BayeuxClient.State getState()
BayeuxClient
public void handshake()
handshake
in interface ClientSession
public void handshake(Map<String,Object> handshakeFields)
handshake
in interface ClientSession
public void handshake(ClientSessionChannel.MessageListener callback)
public void handshake(Map<String,Object> fields, ClientSessionChannel.MessageListener callback)
handshake
in interface ClientSession
public BayeuxClient.State handshake(long waitMs)
Performs the handshake and waits at most the given time for the handshake to complete.
When this method returns, the handshake may have failed (for example because the Bayeux server denied it), so it is important to check the return value to know whether the handshake completed or not.
waitMs
- the time to wait for the handshake to completeBayeuxClient
handshake(Map, long)
public BayeuxClient.State handshake(Map<String,Object> template, long waitMs)
Performs the handshake with the given template and waits at most the given time for the handshake to complete.
When this method returns, the handshake may have failed (for example because the Bayeux server denied it), so it is important to check the return value to know whether the handshake completed or not.
template
- the template object to be merged with the handshake messagewaitMs
- the time to wait for the handshake to completeBayeuxClient
handshake(long)
protected boolean sendHandshake()
public boolean waitFor(long waitMs, BayeuxClient.State state, BayeuxClient.State... states)
Waits for this BayeuxClient
to reach the given state(s) within the given time.
waitMs
- the time to wait to reach the given state(s)state
- the state to reachstates
- additional states to reach in alternativeprotected boolean sendConnect()
protected ChannelId newChannelId(String channelId)
newChannelId
in class AbstractClientSession
protected AbstractClientSession.AbstractSessionChannel newChannel(ChannelId channelId)
newChannel
in class AbstractClientSession
protected void sendBatch()
sendBatch
in class AbstractClientSession
protected boolean sendMessages(List<Message.Mutable> messages)
public void disconnect()
disconnect
in interface Session
disconnect(long)
public void disconnect(ClientSessionChannel.MessageListener callback)
disconnect
in interface ClientSession
public boolean disconnect(long timeout)
Performs a disconnect
and uses the given timeout
to wait for the disconnect to complete.
When a disconnect is sent to the server, the server also wakes up the long poll that may be outstanding, so that a connect reply message may arrive to the client later than the disconnect reply message.
This method waits for the given timeout
for the disconnect reply, but also
waits the same timeout for the last connect reply; in the worst case the
maximum time waited will therefore be twice the given timeout
parameter.
This method returns true if the disconnect reply message arrived within the
given timeout
parameter, no matter if the connect reply message arrived or not.
timeout
- the timeout to wait for the disconnect to completepublic void abort()
Interrupts abruptly the communication with the Bayeux server.
This method may be useful to simulate network failures.
disconnect()
protected void processHandshake(Message.Mutable handshake)
protected void processConnect(Message.Mutable connect)
protected void processDisconnect(Message.Mutable disconnect)
protected void processMessage(Message.Mutable message)
protected boolean scheduleHandshake(long interval, long backOff)
protected boolean scheduleConnect(long interval, long backOff)
public List<String> getAllowedTransports()
getAllowedTransports
in interface Bayeux
public Set<String> getKnownTransportNames()
getKnownTransportNames
in interface Bayeux
public ClientTransport getTransport(String transport)
getTransport
in interface Bayeux
public ClientTransport getTransport()
protected void initialize()
protected void terminate()
public Set<String> getOptionNames()
getOptionNames
in interface Bayeux
public Map<String,Object> getOptions()
BayeuxClient
protected void send(Message.Mutable message)
send
in class AbstractClientSession
protected void enqueueSend(Message.Mutable message)
public void onSending(List<? extends Message> messages)
Callback method invoked when the given messages have hit the network towards the Bayeux server.
The messages may not be modified, and any modification will be useless because the message have already been sent.
messages
- the messages sentpublic void onMessages(List<Message.Mutable> messages)
Callback method invoke when the given messages have just arrived from the Bayeux server.
The messages may be modified, but it's suggested to use Extension
s instead.
Extensions will be processed after the invocation of this method.
messages
- the messages arrivedpublic void onFailure(Throwable failure, List<? extends Message> messages)
Callback method invoked when the given messages have failed to be sent.
The default implementation logs the failure at DEBUG level.
failure
- the exception that caused the failuremessages
- the messages being sentprotected void onTransportFailure(Message message, ClientTransport.FailureInfo failureInfo, ClientTransport.FailureHandler handler)
Copyright © 2008–2017 The CometD Project. All rights reserved.