org.cometd.client.BayeuxClient Maven / Gradle / Ivy
/*
* Copyright (c) 2008-2020 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.cometd.client;
import java.io.IOException;
import java.net.CookieManager;
import java.net.CookieStore;
import java.net.HttpCookie;
import java.net.URI;
import java.util.ArrayDeque;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.EnumSet;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import java.util.Queue;
import java.util.Set;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.CopyOnWriteArrayList;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.RejectedExecutionException;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.ScheduledThreadPoolExecutor;
import java.util.concurrent.TimeUnit;
import org.cometd.bayeux.Bayeux;
import org.cometd.bayeux.Channel;
import org.cometd.bayeux.ChannelId;
import org.cometd.bayeux.Message;
import org.cometd.bayeux.Promise;
import org.cometd.bayeux.client.ClientSession;
import org.cometd.bayeux.client.ClientSessionChannel;
import org.cometd.client.transport.ClientTransport;
import org.cometd.client.transport.HttpClientTransport;
import org.cometd.client.transport.MessageClientTransport;
import org.cometd.client.transport.TransportListener;
import org.cometd.client.transport.TransportRegistry;
import org.cometd.common.AbstractClientSession;
import org.cometd.common.AsyncFoldLeft;
import org.cometd.common.TransportException;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* 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 {@link 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.
* When the communication with the server is finished, the BayeuxClient can be
* disconnected from the Bayeux server.
* Typical usage:
*
* // Setup Jetty's HttpClient.
* HttpClient httpClient = new HttpClient();
* httpClient.start();
*
* // Handshake
* String url = "http://localhost:8080/cometd";
* BayeuxClient client = new BayeuxClient(url, new JettyHttpClientTransport(null, httpClient));
* client.handshake();
* client.waitFor(1000, BayeuxClient.State.CONNECTED);
*
* // Subscription to channels
* ClientSessionChannel channel = client.getChannel("/foo");
* channel.subscribe((channel, message) -> {
* // Handle the message
* });
*
* // Publishing to channels
* Map<String, Object> data = new HashMap<>();
* data.put("bar", "baz");
* channel.publish(data);
*
* // Disconnecting
* client.disconnect();
* client.waitFor(1000, BayeuxClient.State.DISCONNECTED);
*
*/
public class BayeuxClient extends AbstractClientSession implements Bayeux {
public static final String BACKOFF_INCREMENT_OPTION = "backoffIncrement";
public static final String MAX_BACKOFF_OPTION = "maxBackoff";
public static final String BAYEUX_VERSION = "1.0";
private final Logger logger = LoggerFactory.getLogger(getClass().getName() + "." + Integer.toHexString(System.identityHashCode(this)));
private final CopyOnWriteArrayList transportListeners = new CopyOnWriteArrayList<>();
private final TransportRegistry transportRegistry = new TransportRegistry();
private final Map options = new ConcurrentHashMap<>();
private final List messageQueue = new ArrayList<>(32);
private final CookieStore cookieStore = new CookieManager().getCookieStore();
private final TransportListener messageListener = new MessageTransportListener();
private final SessionState sessionState = new SessionState();
private final String url;
private ScheduledExecutorService scheduler;
private boolean ownScheduler;
private BackOffStrategy backOffStrategy = new BackOffStrategy.Linear();
/**
* 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 {@link ScheduledExecutorService scheduler}; it is recommended that
* when creating a large number of BayeuxClients a shared scheduler is used.
*
* @param url the Bayeux server URL to connect to
* @param transport the default (mandatory) transport to use
* @param transports additional optional transports to use in case the default transport cannot be used
* @see #BayeuxClient(String, ScheduledExecutorService, ClientTransport, ClientTransport...)
*/
public BayeuxClient(String url, ClientTransport transport, ClientTransport... transports) {
this(url, null, transport, 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).
*
* @param url the Bayeux server URL to connect to
* @param scheduler the scheduler to use for scheduling timed operations
* @param transport the default (mandatory) transport to use
* @param transports additional optional transports to use in case the default transport cannot be used
*/
public BayeuxClient(String url, ScheduledExecutorService scheduler, ClientTransport transport, ClientTransport... transports) {
this.url = Objects.requireNonNull(url);
this.scheduler = scheduler;
Objects.requireNonNull(transport);
transportRegistry.add(transport);
for (ClientTransport t : transports) {
transportRegistry.add(t);
}
for (String transportName : transportRegistry.getKnownTransports()) {
ClientTransport clientTransport = transportRegistry.getTransport(transportName);
clientTransport.setOption(ClientTransport.URL_OPTION, url);
if (clientTransport instanceof MessageClientTransport) {
((MessageClientTransport)clientTransport).setMessageTransportListener(messageListener);
}
if (clientTransport instanceof HttpClientTransport) {
HttpClientTransport httpTransport = (HttpClientTransport)clientTransport;
httpTransport.setCookieStore(cookieStore);
}
}
}
/**
* @return the URL passed when constructing this instance
*/
public String getURL() {
return url;
}
public BackOffStrategy getBackOffStrategy() {
return backOffStrategy;
}
public void setBackOffStrategy(BackOffStrategy backOffStrategy) {
this.backOffStrategy = backOffStrategy;
}
public CookieStore getCookieStore() {
return cookieStore;
}
/**
* Retrieves the first cookie with the given name, if available.
* Note that currently only HTTP transports support cookies.
*
* @param name the cookie name
* @return the cookie, or null if no such cookie is found
* @see #putCookie(HttpCookie)
*/
public HttpCookie getCookie(String name) {
for (HttpCookie cookie : getCookieStore().get(URI.create(getURL()))) {
if (name.equals(cookie.getName())) {
return cookie;
}
}
return null;
}
public void putCookie(HttpCookie cookie) {
URI uri = URI.create(getURL());
if (cookie.getPath() == null) {
String path = uri.getPath();
if (path == null || !path.contains("/")) {
path = "/";
} else {
path = path.substring(0, path.lastIndexOf("/") + 1);
}
cookie.setPath(path);
}
if (cookie.getDomain() == null) {
cookie.setDomain(uri.getHost());
}
getCookieStore().add(uri, cookie);
}
@Override
public String getId() {
return sessionState.getSessionId();
}
@Override
public boolean isHandshook() {
State state = getState();
return state == State.HANDSHAKEN || state == State.CONNECTING || state == State.CONNECTED || state == State.UNCONNECTED;
}
@Override
public boolean isConnected() {
return getState() == State.CONNECTED;
}
/**
* @return whether this BayeuxClient is terminating or disconnected
*/
public boolean isDisconnected() {
State state = getState();
return state == State.TERMINATING || state == State.DISCONNECTED;
}
/**
* @return the current state of this BayeuxClient
*/
protected State getState() {
return sessionState.getState();
}
/**
* @param listener the {@link TransportListener} to add
*/
public void addTransportListener(TransportListener listener) {
transportListeners.add(listener);
}
/**
* @param listener the {@link TransportListener} to remove
*/
public void removeTransportListener(TransportListener listener) {
transportListeners.remove(listener);
}
private void notifyTransportSending(List messages) {
for (TransportListener listener : transportListeners) {
try {
listener.onSending(messages);
} catch (Throwable x) {
logger.info("Exception while invoking listener " + listener, x);
}
}
}
private void notifyTransportMessages(List messages) {
for (TransportListener listener : transportListeners) {
try {
listener.onMessages(messages);
} catch (Throwable x) {
logger.info("Exception while invoking listener " + listener, x);
}
}
}
private void notifyTransportFailure(Throwable failure, List messages) {
for (TransportListener listener : transportListeners) {
try {
listener.onFailure(failure, messages);
} catch (Throwable x) {
logger.info("Exception while invoking listener " + listener, x);
}
}
}
private void notifyTransportTimeout(List messages, Promise promise) {
AsyncFoldLeft.run(transportListeners, 0L, (result, listener, loop) -> {
try {
listener.onTimeout(messages, Promise.from(r -> {
if (r > 0) {
loop.leave(r);
} else {
loop.proceed(0L);
}
}, loop::fail));
} catch (Throwable x) {
logger.info("Exception while invoking listener " + listener, x);
loop.fail(x);
}
}, promise);
}
/**
* @param callback the message listener to notify of the handshake result
*/
public void handshake(MessageListener callback) {
handshake(null, callback);
}
@Override
public void handshake(Map fields, MessageListener callback) {
if (getState() == State.DISCONNECTED) {
sessionState.submit(() -> sessionState.handshaking(fields, callback));
} else {
throw new IllegalStateException();
}
}
/**
* 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.
*
* @param waitMs the time to wait for the handshake to complete
* @return the state of this BayeuxClient
* @see #handshake(Map, long)
*/
public State handshake(long waitMs) {
return handshake(null, 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.
*
* @param template the template object to be merged with the handshake message
* @param waitMs the time to wait for the handshake to complete
* @return the state of this BayeuxClient
* @see #handshake(long)
*/
public State handshake(Map template, long waitMs) {
handshake(template);
waitFor(waitMs, State.CONNECTING, State.CONNECTED, State.DISCONNECTED);
return getState();
}
protected void sendHandshake() {
List transports = transportRegistry.negotiate(getAllowedTransports().toArray(), BAYEUX_VERSION);
List transportNames = new ArrayList<>(transports.size());
for (ClientTransport transport : transports) {
transportNames.add(transport.getName());
}
Message.Mutable message = newMessage();
Map handshakeFields = sessionState.getHandshakeFields();
if (handshakeFields != null) {
message.putAll(handshakeFields);
}
String messageId = newMessageId();
message.setId(messageId);
message.setChannel(Channel.META_HANDSHAKE);
message.put(Message.SUPPORTED_CONNECTION_TYPES_FIELD, transportNames);
message.put(Message.VERSION_FIELD, BayeuxClient.BAYEUX_VERSION);
registerCallback(messageId, sessionState.getHandshakeCallback());
if (logger.isDebugEnabled()) {
logger.debug("Handshaking on transport {}: {}", getTransport(), message);
}
List messages = new ArrayList<>(1);
messages.add(message);
sendMessages(messages, Promise.complete((r, x) -> {
if (logger.isDebugEnabled()) {
logger.debug("{} handshake {}", x == null ? "Sent" : "Failed", message);
}
}));
}
/**
* Waits for this BayeuxClient to reach the given state(s) within the given time.
*
* @param waitMs the time to wait to reach the given state(s)
* @param state the state to reach
* @param states additional states to reach in alternative
* @return true if one of the state(s) has been reached within the given time, false otherwise
*/
public boolean waitFor(long waitMs, State state, State... states) {
List waitForStates = new ArrayList<>();
waitForStates.add(state);
waitForStates.addAll(Arrays.asList(states));
synchronized (sessionState) {
while (waitMs > 0) {
// This check is needed to avoid that we return from waitFor() too early,
// when the state has been set, but its effects (like notifying listeners)
// are not completed yet (issue #212).
// Transient states (like CONNECTING or DISCONNECTING) may "miss" the
// wake up in this way:
// * T1 goes in wait - releases lock
// * T2 finishes update to CONNECTING - notifies lock
// * T3 starts a state update to CONNECTED - releases lock
// * T1 wakes up, takes lock, but sees update in progress, waits - releases lock
// * T3 finishes update to CONNECTED - notifies lock
// * T1 wakes up, takes lock, sees status == CONNECTED - CONNECTING has been "missed"
// To avoid this, we use State.implies()
if (sessionState.isIdle()) {
State currentState = getState();
for (State s : waitForStates) {
if (currentState.implies(s)) {
return true;
}
}
}
if (logger.isDebugEnabled()) {
logger.debug("Waiting {}ms for {}", waitMs, waitForStates);
}
long start = System.nanoTime();
if (sessionState.await(waitMs)) {
break;
}
long elapsed = TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - start);
if (logger.isDebugEnabled()) {
logger.debug("Waited {}/{}ms for {}, state is {}", elapsed, waitMs, waitForStates, sessionState.getState());
}
waitMs -= elapsed;
}
return false;
}
}
protected void sendConnect() {
ClientTransport transport = getTransport();
if (transport == null) {
return;
}
Message.Mutable message = newMessage();
message.setId(newMessageId());
message.setChannel(Channel.META_CONNECT);
message.put(Message.CONNECTION_TYPE_FIELD, transport.getName());
State state = getState();
if (state == State.CONNECTING || state == State.UNCONNECTED) {
// First connect after handshake or after failure, add advice.
message.getAdvice(true).put("timeout", 0);
}
if (logger.isDebugEnabled()) {
logger.debug("Connecting, transport {}", transport);
}
List messages = new ArrayList<>(1);
messages.add(message);
sendMessages(messages, Promise.complete((r, x) -> {
if (logger.isDebugEnabled()) {
logger.debug("{} connect {}", x == null ? "Sent" : "Failed", message);
}
}));
}
@Override
protected ChannelId newChannelId(String channelId) {
// Save some parsing by checking if there is already one
AbstractSessionChannel channel = getChannels().get(channelId);
return channel == null ? new ChannelId(channelId) : channel.getChannelId();
}
@Override
protected AbstractSessionChannel newChannel(ChannelId channelId) {
return new BayeuxClientChannel(channelId);
}
@Override
protected void sendBatch() {
if (canSend()) {
List messages = takeMessages();
if (!messages.isEmpty()) {
sendMessages(messages, Promise.complete((r, x) -> {
if (logger.isDebugEnabled()) {
logger.debug("{} batch {}", x == null ? "Sent" : "Failed", messages);
}
}));
}
}
}
protected void sendMessages(List messages, Promise promise) {
AsyncFoldLeft.run(messages, new ArrayList(messages.size()), (toSend, message, loop) -> {
String messageId = message.getId();
message.setClientId(sessionState.sessionId);
extendOutgoing(message, Promise.from(extPass -> {
// Extensions may have changed the messageId.
message.setId(messageId);
if (extPass) {
toSend.add(message);
}
loop.proceed(toSend);
}, loop::fail));
}, Promise.from(toSend -> {
List deleted = Collections.emptyList();
if (toSend.size() != messages.size()) {
deleted = new ArrayList<>(messages);
deleted.removeAll(toSend);
}
// Fail the deleted messages first, to avoid a
// race with the replies of the sent messages.
AsyncFoldLeft.run(deleted, null, (result, message, loop) -> {
Message.Mutable failed = newReply(message);
failed.setSuccessful(false);
failed.put(Message.ERROR_FIELD, "404::message_deleted");
receive(failed, Promise.from(loop::proceed, loop::fail));
}, Promise.from(r -> {
// Send the messages.
if (toSend.isEmpty()) {
promise.succeed(false);
} else {
if (logger.isDebugEnabled()) {
logger.debug("Sending messages {}", toSend);
}
promise.succeed(sessionState.send(messageListener, toSend));
}
}, promise::fail));
}, promise::fail));
}
private List takeMessages() {
// Multiple threads can call this method concurrently (for example
// a batched publish() is executed exactly when a message arrives
// and a listener also performs a batched publish() in response to
// the message).
// The queue must be drained atomically, otherwise we risk that the
// same message is drained twice.
List messages;
synchronized (messageQueue) {
messages = new ArrayList<>(messageQueue);
messageQueue.clear();
}
return messages;
}
@Override
public void disconnect(final ClientSession.MessageListener callback) {
sessionState.submit(() -> sessionState.disconnecting(callback));
}
/**
* Performs a {@link #disconnect() disconnect} and uses the given {@code 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 {@code 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 {@code timeout} parameter.
* This method returns true if the disconnect reply message arrived within the
* given {@code timeout} parameter, no matter if the connect reply message arrived or not.
*
* @param timeout the timeout to wait for the disconnect to complete
* @return true if the disconnect completed within the given timeout
*/
public boolean disconnect(long timeout) {
if (isDisconnected()) {
return true;
}
final CountDownLatch latch = new CountDownLatch(1);
ClientSessionChannel.MessageListener lastConnectListener = (channel, message) -> {
final Map advice = message.getAdvice();
if (!message.isSuccessful() ||
advice != null && Message.RECONNECT_NONE_VALUE.equals(advice.get(Message.RECONNECT_FIELD))) {
latch.countDown();
}
};
getChannel(Channel.META_CONNECT).addListener(lastConnectListener);
disconnect();
boolean disconnected = waitFor(timeout, BayeuxClient.State.DISCONNECTED);
// There is a possibility that we are in the window where the server
// has returned the long poll and the client has not issued it again,
// so wait for the timeout, but do not complain if the latch does not trigger.
try {
latch.await(timeout, TimeUnit.MILLISECONDS);
} catch (InterruptedException x) {
Thread.currentThread().interrupt();
}
getChannel(Channel.META_CONNECT).removeListener(lastConnectListener);
// Force termination.
sessionState.submit(sessionState::terminating);
return disconnected;
}
/**
* Interrupts abruptly the communication with the Bayeux server.
* This method may be useful to simulate network failures.
*
* @see #disconnect()
*/
public void abort() {
abort(new IOException("Abort"));
}
private void abort(Throwable failure) {
sessionState.submit(() -> {
if (sessionState.update(State.TERMINATING)) {
sessionState.terminate(failure);
}
});
}
private void processMessages(List messages) {
for (Message.Mutable message : messages) {
if (logger.isDebugEnabled()) {
logger.debug("Processing {}", message);
}
String channel = message.getChannel();
if (Channel.META_HANDSHAKE.equals(channel)) {
processHandshake(message);
} else if (Channel.META_CONNECT.equals(channel)) {
processConnect(message);
} else if (Channel.META_DISCONNECT.equals(channel)) {
processDisconnect(message);
} else {
processMessage(message);
}
}
}
protected void messagesFailure(Throwable cause, List messages) {
for (Message message : messages) {
if (logger.isDebugEnabled()) {
logger.debug("Failing {}", message);
}
Message.Mutable failed = newReply(message);
failed.setSuccessful(false);
Map failure = new HashMap<>();
failed.put("failure", failure);
failure.put("message", message);
if (cause != null) {
failure.put("exception", cause);
}
if (cause instanceof TransportException) {
Map fields = ((TransportException)cause).getFields();
if (fields != null) {
failure.putAll(fields);
}
}
ClientTransport transport = getTransport();
if (transport != null) {
failure.put(Message.CONNECTION_TYPE_FIELD, transport.getName());
}
String channel = message.getChannel();
if (Channel.META_HANDSHAKE.equals(channel)) {
handshakeFailure(failed, cause);
} else if (Channel.META_CONNECT.equals(channel)) {
connectFailure(failed, cause);
} else if (Channel.META_DISCONNECT.equals(channel)) {
disconnectFailure(failed, cause);
} else {
messageFailure(failed, cause);
}
}
}
private Message.Mutable newReply(Message message) {
Message.Mutable reply = newMessage();
reply.setId(message.getId());
reply.setChannel(message.getChannel());
if (message.containsKey(Message.SUBSCRIPTION_FIELD)) {
reply.put(Message.SUBSCRIPTION_FIELD, message.get(Message.SUBSCRIPTION_FIELD));
}
return reply;
}
protected void processHandshake(final Message.Mutable handshake) {
if (handshake.isSuccessful()) {
final ClientTransport oldTransport = getTransport();
Object field = handshake.get(Message.SUPPORTED_CONNECTION_TYPES_FIELD);
Object[] serverTransports = field instanceof List ? ((List)field).toArray() : (Object[])field;
List negotiatedTransports = transportRegistry.negotiate(serverTransports, BAYEUX_VERSION);
if (negotiatedTransports.isEmpty()) {
ClientTransport.FailureInfo failureInfo = new ClientTransport.FailureInfo();
failureInfo.transport = null;
failureInfo.cause = null;
failureInfo.error = String.format("405:c%s,s%s:no_transport", getAllowedTransports(), Arrays.toString(serverTransports));
failureInfo.action = Message.RECONNECT_NONE_VALUE;
handshake.setSuccessful(false);
handshake.put(Message.ERROR_FIELD, failureInfo.error);
failHandshake(handshake, failureInfo);
} else {
Number messagesField = (Number)handshake.get("x-messages");
final int messages = messagesField == null ? 0 : messagesField.intValue();
final ClientTransport newTransport = negotiatedTransports.get(0);
if (newTransport != oldTransport) {
prepareTransport(oldTransport, newTransport);
}
sessionState.submit(() -> sessionState.handshaken(newTransport, handshake, messages));
}
} else {
ClientTransport.FailureInfo failureInfo = new ClientTransport.FailureInfo();
failureInfo.transport = getTransport();
failureInfo.cause = null;
failureInfo.error = null;
failureInfo.action = sessionState.getAdviceAction(handshake.getAdvice(), Message.RECONNECT_HANDSHAKE_VALUE);
failHandshake(handshake, failureInfo);
}
}
private void handshakeFailure(Message.Mutable handshake, final Throwable failure) {
ClientTransport.FailureInfo failureInfo = new ClientTransport.FailureInfo();
failureInfo.transport = null;
failureInfo.cause = failure;
failureInfo.error = null;
failureInfo.action = Message.RECONNECT_HANDSHAKE_VALUE;
failHandshake(handshake, failureInfo);
}
private void failHandshake(Message.Mutable handshake, ClientTransport.FailureInfo failureInfo) {
receive(handshake, Promise.from(r -> {
// The listeners may have disconnected.
if (isDisconnected()) {
failureInfo.action = Message.RECONNECT_NONE_VALUE;
}
onTransportFailure(handshake, failureInfo, sessionState);
}, x -> logger.info("Failure while receiving " + handshake, x)));
}
protected void processConnect(final Message.Mutable connect) {
if (sessionState.matchMetaConnect(connect)) {
if (connect.isSuccessful()) {
receive(connect, Promise.from(r -> sessionState.submit(() -> {
sessionState.connected(connect);
}), x -> logger.info("Failure while receiving " + connect, x)));
} else {
ClientTransport.FailureInfo failureInfo = new ClientTransport.FailureInfo();
failureInfo.transport = getTransport();
failureInfo.cause = null;
failureInfo.error = null;
failureInfo.action = sessionState.getAdviceAction(connect.getAdvice(), Message.RECONNECT_RETRY_VALUE);
failConnect(connect, failureInfo);
}
} else {
if (logger.isDebugEnabled()) {
logger.debug("Mismatched /meta/connect reply: expected reply for {}, received {}", sessionState.getMetaConnect(), connect);
}
}
}
private void connectFailure(Message.Mutable connect, Throwable failure) {
if (sessionState.matchMetaConnect(connect)) {
ClientTransport.FailureInfo failureInfo = new ClientTransport.FailureInfo();
failureInfo.transport = null;
failureInfo.cause = failure;
failureInfo.error = null;
failureInfo.action = Message.RECONNECT_RETRY_VALUE;
failConnect(connect, failureInfo);
} else {
if (logger.isDebugEnabled()) {
logger.debug("Mismatched /meta/connect failure: expected {}, got {}", sessionState.getMetaConnect(), connect);
}
}
}
private void failConnect(Message.Mutable connect, ClientTransport.FailureInfo failureInfo) {
receive(connect, Promise.from(r -> {
// The listeners may have disconnected.
if (isDisconnected()) {
failureInfo.action = Message.RECONNECT_NONE_VALUE;
}
onTransportFailure(connect, failureInfo, sessionState);
}, x -> logger.info("Failure while receiving " + connect, x)));
}
protected void processDisconnect(final Message.Mutable disconnect) {
if (disconnect.isSuccessful()) {
receive(disconnect, Promise.complete((r, x) -> sessionState.submit(sessionState::terminating)));
} else {
disconnectFailure(disconnect, null);
}
}
private void disconnectFailure(Message.Mutable disconnect, Throwable failure) {
ClientTransport.FailureInfo failureInfo = new ClientTransport.FailureInfo();
failureInfo.transport = getTransport();
failureInfo.cause = failure;
failureInfo.error = null;
failureInfo.action = Message.RECONNECT_NONE_VALUE;
failDisconnect(disconnect, failureInfo);
}
private void failDisconnect(Message.Mutable disconnect, ClientTransport.FailureInfo failureInfo) {
receive(disconnect, Promise.complete((r, x) -> onTransportFailure(disconnect, failureInfo, sessionState)));
}
protected void processMessage(Message.Mutable message) {
receive(message, Promise.from(r -> {
if (getState() == State.HANDSHAKEN) {
sessionState.submit(sessionState::afterHandshaken);
}
}, this::abort));
}
private void messageFailure(Message.Mutable message, Throwable failure) {
failMessage(message);
}
private void failMessage(Message.Mutable message) {
receive(message, Promise.from(r -> {
}, x -> logger.info("Failure while receiving " + message, x)));
}
protected boolean scheduleHandshake(long interval, long backOff) {
if (logger.isDebugEnabled()) {
logger.debug("Scheduled handshake in {}+{} ms", interval, backOff);
}
return scheduleAction(this::sendHandshake, interval, backOff);
}
protected boolean scheduleConnect(long interval, long backOff) {
if (logger.isDebugEnabled()) {
logger.debug("Scheduled connect in {}+{} ms", interval, backOff);
}
return scheduleAction(this::sendConnect, interval, backOff);
}
private boolean scheduleAction(Runnable action, long interval, long backoff) {
// Prevent NPE in case of concurrent disconnect
ScheduledExecutorService scheduler = this.scheduler;
if (scheduler != null) {
try {
scheduler.schedule(action, interval + backoff, TimeUnit.MILLISECONDS);
return true;
} catch (RejectedExecutionException x) {
// It has been shut down
logger.trace("", x);
}
}
if (logger.isDebugEnabled()) {
logger.debug("Could not schedule action {} to scheduler {}", action, scheduler);
}
return false;
}
@Override
public List getAllowedTransports() {
return transportRegistry.getAllowedTransports();
}
@Override
public Set getKnownTransportNames() {
return transportRegistry.getKnownTransports();
}
@Override
public ClientTransport getTransport(String transport) {
return transportRegistry.getTransport(transport);
}
public ClientTransport getTransport() {
return sessionState.getTransport();
}
protected void initialize() {
BackOffStrategy backOffStrategy = getBackOffStrategy();
if (backOffStrategy instanceof BackOffStrategy.Linear) {
BackOffStrategy.Linear linear = (BackOffStrategy.Linear)backOffStrategy;
Number value = (Number)getOption(BACKOFF_INCREMENT_OPTION);
long increment = linear.increment;
if (value != null) {
increment = value.longValue();
}
value = (Number)getOption(MAX_BACKOFF_OPTION);
long maximum = linear.maximum;
if (value != null) {
maximum = value.longValue();
}
if (increment > 0 && increment != linear.increment || maximum != linear.maximum) {
setBackOffStrategy(new BackOffStrategy.Linear(increment, maximum));
}
}
if (scheduler == null) {
scheduler = new Scheduler(1);
ownScheduler = true;
}
setOption(ClientTransport.SCHEDULER_OPTION, scheduler);
}
protected void terminate(Throwable failure) {
List messages = takeMessages();
messagesFailure(failure, messages);
cookieStore.removeAll();
if (ownScheduler) {
scheduler.shutdown();
scheduler = null;
ownScheduler = false;
}
}
@Override
public Object getOption(String qualifiedName) {
return options.get(qualifiedName);
}
@Override
public void setOption(String qualifiedName, Object value) {
options.put(qualifiedName, value);
// Forward the option to the transports.
for (String name : transportRegistry.getKnownTransports()) {
ClientTransport transport = transportRegistry.getTransport(name);
transport.setOption(qualifiedName, value);
}
}
@Override
public Set getOptionNames() {
return options.keySet();
}
/**
* @return the options that configure with BayeuxClient.
*/
public Map getOptions() {
return Collections.unmodifiableMap(options);
}
@Override
protected void send(Message.Mutable message) {
enqueueSend(message);
}
protected void enqueueSend(Message.Mutable message) {
if (canSend()) {
List messages = new ArrayList<>(1);
messages.add(message);
sendMessages(messages, Promise.complete((r, x) -> {
if (logger.isDebugEnabled()) {
logger.debug("{} message {}", x == null ? "Sent" : "Failed", message);
}
}));
} else {
synchronized (messageQueue) {
messageQueue.add(message);
}
if (logger.isDebugEnabled()) {
logger.debug("Enqueued message {} (batching: {})", message, isBatching());
}
}
}
private boolean canSend() {
State state = getState();
boolean handshaking = state == State.HANDSHAKING || state == State.REHANDSHAKING;
return !isBatching() && !handshaking;
}
/**
* 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.
*
* @param messages the messages sent
* @deprecated use {@link #addTransportListener(TransportListener)} instead
*/
@Deprecated
public void onSending(List 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 {@link Extension}s instead.
* Extensions will be processed after the invocation of this method.
*
* @param messages the messages arrived
* @deprecated use {@link #addTransportListener(TransportListener)} instead
*/
@Deprecated
public void onMessages(List messages) {
}
/**
* Callback method invoked when the given messages have failed to be sent.
* The default implementation logs the failure at DEBUG level.
*
* @param failure the exception that caused the failure
* @param messages the messages being sent
* @deprecated use {@link #addTransportListener(TransportListener)} instead
*/
@Deprecated
public void onFailure(Throwable failure, List messages) {
if (logger.isDebugEnabled()) {
logger.debug("Messages failed " + messages, failure);
}
}
private void prepareTransport(ClientTransport oldTransport, ClientTransport newTransport) {
if (oldTransport != null) {
oldTransport.terminate();
}
newTransport.init();
}
protected void onTransportFailure(Message message, ClientTransport.FailureInfo failureInfo, final ClientTransport.FailureHandler handler) {
if (logger.isDebugEnabled()) {
logger.debug("Transport failure: {} for {}", failureInfo, message);
}
if (Message.RECONNECT_NONE_VALUE.equals(failureInfo.action)) {
if (Channel.META_HANDSHAKE.equals(message.getChannel())) {
ClientTransport transport = getTransport();
if (transport != null && failureInfo.transport == null) {
onTransportFailure(transport.getName(), null, failureInfo.cause);
}
}
} else {
failureInfo.delay = getBackOffStrategy().current();
if (Channel.META_HANDSHAKE.equals(message.getChannel())) {
// Invalid transport, try to negotiate a new one.
if (failureInfo.transport == null) {
List transports = transportRegistry.negotiate(getAllowedTransports().toArray(), BAYEUX_VERSION);
if (transports.isEmpty()) {
onTransportFailure(getTransport().getName(), null, failureInfo.cause);
failureInfo.action = Message.RECONNECT_NONE_VALUE;
} else {
ClientTransport oldTransport = getTransport();
ClientTransport newTransport = transports.get(0);
if (newTransport != oldTransport) {
prepareTransport(oldTransport, newTransport);
}
onTransportFailure(oldTransport.getName(), newTransport.getName(), failureInfo.cause);
failureInfo.transport = newTransport;
failureInfo.action = Message.RECONNECT_HANDSHAKE_VALUE;
}
}
if (!Message.RECONNECT_NONE_VALUE.equals(failureInfo.action)) {
sessionState.increaseBackOff();
}
} else {
sessionState.initUnconnectTime();
if (Message.RECONNECT_RETRY_VALUE.equals(failureInfo.action)) {
failureInfo.delay = sessionState.increaseBackOff();
if (sessionState.nextConnectExceedsMaxInterval()) {
if (logger.isDebugEnabled()) {
logger.debug("Switching to handshake retries");
}
failureInfo.action = Message.RECONNECT_HANDSHAKE_VALUE;
}
}
if (Message.RECONNECT_HANDSHAKE_VALUE.equals(failureInfo.action)) {
failureInfo.delay = 0;
sessionState.resetBackOff();
}
}
}
handler.handle(failureInfo);
}
protected void onTransportFailure(String oldTransportName, String newTransportName, Throwable failure) {
}
@Override
public String toString() {
return String.format("%s@%x[%s][%s]", getClass().getSimpleName(), hashCode(), getId(), sessionState);
}
/**
* The states that a BayeuxClient may assume.
*/
public enum State {
/**
* State assumed after the handshake when the connection is broken
*/
UNCONNECTED,
/**
* State assumed when the handshake is being sent
*/
HANDSHAKING,
/**
* State assumed when a first handshake failed and the handshake is retried,
* or when the Bayeux server requests a re-handshake
*/
REHANDSHAKING,
/**
* State assumed when the handshake is received, but before connecting
*/
HANDSHAKEN(HANDSHAKING, REHANDSHAKING),
/**
* State assumed when the connect is being sent for the first time
*/
CONNECTING(HANDSHAKING, REHANDSHAKING, HANDSHAKEN),
/**
* State assumed when this BayeuxClient is connected to the Bayeux server
*/
CONNECTED(HANDSHAKING, REHANDSHAKING, HANDSHAKEN, CONNECTING),
/**
* State assumed when the disconnect is being sent
*/
DISCONNECTING,
/**
* State assumed when the disconnect is received but terminal actions must be performed
*/
TERMINATING(DISCONNECTING),
/**
* State assumed before the handshake and when the disconnect is completed
*/
DISCONNECTED(DISCONNECTING, TERMINATING);
private final State[] implieds;
private State(State... implieds) {
this.implieds = implieds;
}
private boolean implies(State state) {
if (state == this) {
return true;
}
for (State implied : implieds) {
if (state == implied) {
return true;
}
}
return false;
}
private boolean isUpdateableTo(State newState) {
switch (this) {
case DISCONNECTED:
return newState == HANDSHAKING;
case HANDSHAKING:
case REHANDSHAKING:
return EnumSet.of(REHANDSHAKING, HANDSHAKEN, DISCONNECTING, TERMINATING).contains(newState);
case HANDSHAKEN:
return EnumSet.of(CONNECTING, DISCONNECTING, TERMINATING).contains(newState);
case CONNECTING:
case CONNECTED:
case UNCONNECTED:
return EnumSet.of(REHANDSHAKING, CONNECTED, UNCONNECTED, DISCONNECTING, TERMINATING).contains(newState);
case DISCONNECTING:
return newState == TERMINATING;
case TERMINATING:
return newState == DISCONNECTED;
default:
throw new IllegalStateException();
}
}
}
/**
* A strategy to controls wait times of the retry attempts in case of heartbeat failures.
* Method {@link #next()} is invoked when a retry attempt has failed and returns the wait time
* before the next retry attempt.
*/
public interface BackOffStrategy {
/**
* @return the current wait time
* @see #next()
* @see #reset()
*/
public long current();
/**
* @return the next wait time
* @see #current()
*/
public long next();
/**
* Resets the wait time.
*/
public void reset();
/**
* A back off strategy that always returns the same wait time.
*/
public class Constant implements BackOffStrategy {
private final long delay;
private long backOff;
public Constant(long delay) {
this.delay = delay;
}
@Override
public long current() {
synchronized (this) {
return backOff;
}
}
@Override
public long next() {
synchronized (this) {
return backOff = delay;
}
}
@Override
public void reset() {
synchronized (this) {
backOff = 0;
}
}
}
/**
* A strategy that increases the wait time linearly up to a maximum.
*/
public static class Linear implements BackOffStrategy {
private final long increment;
private final long maximum;
private long backOff;
public Linear() {
this(1000, 30000);
}
public Linear(long increment, long maximum) {
this.increment = increment;
this.maximum = maximum;
}
@Override
public long current() {
synchronized (this) {
return backOff;
}
}
@Override
public long next() {
synchronized (this) {
long newBackOff = backOff + increment;
if (maximum > 0 && newBackOff > maximum) {
newBackOff = maximum;
}
return backOff = newBackOff;
}
}
@Override
public void reset() {
synchronized (this) {
backOff = 0;
}
}
}
}
private class MessageTransportListener implements TransportListener {
@Override
public void onSending(List messages) {
BayeuxClient.this.onSending(messages);
notifyTransportSending(messages);
}
@Override
public void onMessages(List messages) {
BayeuxClient.this.onMessages(messages);
notifyTransportMessages(messages);
processMessages(messages);
}
@Override
public void onFailure(Throwable failure, List messages) {
BayeuxClient.this.onFailure(failure, messages);
notifyTransportFailure(failure, messages);
messagesFailure(failure, messages);
}
@Override
public void onTimeout(List messages, Promise promise) {
notifyTransportTimeout(messages, promise);
}
}
/**
* A channel scoped to this BayeuxClient.
*/
protected class BayeuxClientChannel extends AbstractSessionChannel {
protected BayeuxClientChannel(ChannelId channelId) {
super(channelId);
}
@Override
public ClientSession getSession() {
throwIfReleased();
return BayeuxClient.this;
}
@Override
protected void nonFirstSubscribe(Message.Mutable message, MessageListener listener, ClientSession.MessageListener callback) {
// Keep the semantic that the callback is notified asynchronously.
scheduleAction(() -> super.nonFirstSubscribe(message, listener, callback), 0, 0);
}
@Override
protected void nonLastUnSubscribe(Message.Mutable message, MessageListener listener, ClientSession.MessageListener callback) {
// Keep the semantic that the callback is notified asynchronously.
scheduleAction(() -> super.nonLastUnSubscribe(message, listener, callback), 0, 0);
}
}
private class SessionState implements ClientTransport.FailureHandler {
private final Queue actions = new ArrayDeque<>();
private State state = State.DISCONNECTED;
private ClientTransport transport;
private Map handshakeFields;
private ClientSession.MessageListener handshakeCallback;
private Map advice;
private String sessionId;
private long unconnectTime;
private boolean active;
private int handshakeMessages;
private Message metaConnect;
private void reset() {
actions.clear();
state = State.DISCONNECTED;
transport = null;
handshakeFields = null;
handshakeCallback = null;
advice = null;
sessionId = null;
resetBackOff();
unconnectTime = 0;
active = false;
handshakeMessages = 0;
metaConnect = null;
}
private State getState() {
synchronized (this) {
return state;
}
}
private ClientTransport getTransport() {
synchronized (this) {
return transport;
}
}
private Map getHandshakeFields() {
synchronized (this) {
return handshakeFields;
}
}
private ClientSession.MessageListener getHandshakeCallback() {
synchronized (this) {
return handshakeCallback;
}
}
private Map getAdvice() {
synchronized (this) {
return advice;
}
}
private String getSessionId() {
synchronized (this) {
return sessionId;
}
}
private long getUnconnectTime() {
synchronized (this) {
if (unconnectTime == 0) {
return 0;
}
return TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - unconnectTime);
}
}
private long getTimeout() {
return getAdviceLong(Message.TIMEOUT_FIELD);
}
private long getInterval() {
return getAdviceLong(Message.INTERVAL_FIELD);
}
private long getMaxInterval() {
return getAdviceLong(Message.MAX_INTERVAL_FIELD);
}
private String getAdviceAction(Map advice, String defaultAction) {
String result = null;
if (advice == null) {
advice = getAdvice();
}
if (advice != null) {
result = (String)advice.get(Message.RECONNECT_FIELD);
}
return result == null ? defaultAction : result;
}
private long getAdviceLong(String field) {
synchronized (this) {
long result = 0;
if (advice != null && advice.containsKey(field)) {
result = ((Number)advice.get(field)).longValue();
}
return result;
}
}
private long increaseBackOff() {
synchronized (this) {
return getBackOffStrategy().next();
}
}
private void resetBackOff() {
synchronized (this) {
getBackOffStrategy().reset();
}
}
private void handshaking(Map handshakeFields, ClientSession.MessageListener handshakeCallback) {
if (update(State.HANDSHAKING)) {
initialize();
List allowedTransports = getAllowedTransports();
// Pick the first transport for the handshake, it will renegotiate if not right
final ClientTransport transport = transportRegistry.negotiate(allowedTransports.toArray(), BAYEUX_VERSION).get(0);
prepareTransport(null, transport);
if (logger.isDebugEnabled()) {
logger.debug("Using initial transport {} from {}", transport.getName(), allowedTransports);
}
synchronized (this) {
this.transport = transport;
this.handshakeFields = handshakeFields;
this.handshakeCallback = handshakeCallback;
}
resetSubscriptions();
sendHandshake();
}
}
private void rehandshaking(long backOff) {
State oldState;
boolean result;
synchronized (this) {
oldState = state;
result = update(State.REHANDSHAKING);
}
if (result) {
if (oldState != State.HANDSHAKING) {
resetSubscriptions();
}
scheduleHandshake(getInterval(), backOff);
}
}
private void handshaken(ClientTransport transport, Message.Mutable handshake, int messages) {
boolean updated;
synchronized (this) {
updated = update(State.HANDSHAKEN);
if (updated) {
this.transport = transport;
this.advice = handshake.getAdvice();
this.sessionId = handshake.getClientId();
this.handshakeMessages = messages;
resetBackOff();
}
}
if (updated) {
receive(handshake, Promise.from(r -> {
sendBatch();
if (messages == 0) {
connecting();
}
}, x -> logger.info("Failure while receiving " + handshake, x)));
}
}
private void afterHandshaken() {
boolean connect = false;
synchronized (this) {
if (getState() == State.HANDSHAKEN) {
if (handshakeMessages > 0) {
--handshakeMessages;
}
connect = handshakeMessages == 0;
}
}
if (connect) {
connecting();
}
}
private void connecting() {
if (update(State.CONNECTING)) {
scheduleConnect(getInterval(), 0);
}
}
private void connected(Message connect) {
boolean updated;
synchronized (this) {
updated = update(State.CONNECTED);
if (updated) {
resetBackOff();
this.unconnectTime = 0;
Map advice = connect.getAdvice();
if (advice != null) {
this.advice = advice;
}
}
}
if (updated) {
scheduleConnect(getInterval(), 0);
}
}
private void unconnected(long backOff) {
if (update(State.UNCONNECTED)) {
scheduleConnect(getInterval(), backOff);
}
}
private boolean nextConnectExceedsMaxInterval() {
synchronized (this) {
long maxInterval = getMaxInterval();
if (maxInterval > 0) {
long expiration = getTimeout() + getInterval() + maxInterval;
return getUnconnectTime() + getBackOffStrategy().current() > expiration;
}
return false;
}
}
private void disconnecting(ClientSession.MessageListener callback) {
if (update(State.DISCONNECTING)) {
Message.Mutable message = newMessage();
String messageId = newMessageId();
message.setId(messageId);
message.setChannel(Channel.META_DISCONNECT);
registerCallback(messageId, callback);
List messages = new ArrayList<>(1);
messages.add(message);
sendMessages(messages, Promise.complete((r, x) -> {
if (logger.isDebugEnabled()) {
logger.debug("{} disconnect {}", x == null ? "Sent" : "Failed", message);
}
}));
}
}
private void terminating() {
if (update(State.TERMINATING)) {
terminate(null);
}
}
private boolean update(State newState) {
synchronized (this) {
State oldState = state;
boolean result = state.isUpdateableTo(newState);
if (result) {
state = newState;
}
if (logger.isDebugEnabled()) {
logger.debug("State {}updated: {} -> {}", result ? "" : "not ", oldState, newState);
}
return result;
}
}
private void terminate(Throwable failure) {
if (failure != null) {
transport.abort(failure);
} else {
transport.terminate();
}
BayeuxClient.this.terminate(failure);
synchronized (this) {
update(State.DISCONNECTED);
reset();
}
}
private void submit(Runnable action) {
boolean empty;
synchronized (this) {
empty = actions.isEmpty();
actions.offer(action);
}
if (empty && process()) {
synchronized (this) {
if (logger.isDebugEnabled()) {
logger.debug("Notifying threads in waitFor()");
}
notifyAll();
}
}
}
private boolean process() {
boolean looping = false;
while (true) {
Runnable action;
synchronized (this) {
// Reentering is a no-operation.
if (!looping && active) {
return false;
}
action = actions.poll();
if (action == null) {
active = false;
return true;
}
if (!looping) {
active = looping = true;
}
}
action.run();
}
}
private boolean send(TransportListener messageListener, List messages) {
if (isDisconnected()) {
messagesFailure(new TransportException(null), messages);
return false;
} else {
for (Message.Mutable message : messages) {
if (Channel.META_CONNECT.equals(message.getChannel())) {
Message existing;
synchronized (this) {
existing = metaConnect;
metaConnect = message;
}
if (logger.isDebugEnabled()) {
if (existing != null) {
logger.debug("Overwriting existing /meta/connect {}", existing);
}
logger.debug("Sending /meta/connect {}", message);
}
}
}
transport.send(messageListener, messages);
return true;
}
}
private boolean matchMetaConnect(Message.Mutable connect) {
synchronized (this) {
if (State.DISCONNECTED.implies(state)) {
return true;
}
if (metaConnect != null && metaConnect.getId().equals(connect.getId())) {
metaConnect = null;
return true;
}
}
return false;
}
private Message getMetaConnect() {
synchronized (this) {
return metaConnect;
}
}
private boolean isIdle() {
synchronized (this) {
return !active;
}
}
private boolean await(long time) {
synchronized (this) {
try {
wait(time);
return false;
} catch (InterruptedException x) {
return true;
}
}
}
private void initUnconnectTime() {
synchronized (this) {
if (unconnectTime == 0) {
unconnectTime = System.nanoTime();
}
}
}
@Override
public void handle(final ClientTransport.FailureInfo failureInfo) {
if (logger.isDebugEnabled()) {
logger.debug("Transport failure handling: {}", failureInfo);
}
submit(() -> {
State newState = failureInfo.actionToState();
synchronized (this) {
ClientTransport newTransport = failureInfo.transport;
if (newTransport != null) {
transport = newTransport;
}
String url = failureInfo.url;
if (url != null) {
transport.setURL(url);
}
}
switch (newState) {
case REHANDSHAKING: {
rehandshaking(failureInfo.delay);
break;
}
case UNCONNECTED: {
unconnected(failureInfo.delay);
break;
}
case TERMINATING: {
terminating();
break;
}
default: {
throw new IllegalStateException();
}
}
});
}
@Override
public String toString() {
return String.format("%s@%x[%s]", getClass().getSimpleName(), hashCode(), state);
}
}
public static class Scheduler extends ScheduledThreadPoolExecutor {
public Scheduler(int threads) {
super(threads);
setExecuteExistingDelayedTasksAfterShutdownPolicy(false);
setRemoveOnCancelPolicy(true);
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy