discord4j.gateway.DefaultGatewayClient Maven / Gradle / Ivy
/*
* This file is part of Discord4J.
*
* Discord4J is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Discord4J is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with Discord4J. If not, see
* Keeps track of a single websocket session by wrapping an instance of {@link DiscordWebSocketHandler} each time a
* new WebSocket connection to Discord is made, therefore only one instance of this class is enough to
* handle the lifecycle of the Gateway operations, that could span multiple WebSocket sessions over time.
*
* Provides automatic reconnecting through a configurable retry policy, allows consumers to receive inbound events
* through {@link #dispatch()}, mapped payloads through {@link #receiver()} and allows a producer to
* submit events through {@link #sender()}.
*
* Provides sending raw {@link ByteBuf} payloads through {@link #sendBuffer(Publisher)} and receiving raw
* {@link ByteBuf} payloads mapped in-flight using a specified mapper using {@link #receiver(Function)}.
*/
public class DefaultGatewayClient implements GatewayClient {
// basic properties
private final Logger log;
private final HttpClient httpClient;
private final PayloadReader payloadReader;
private final PayloadWriter payloadWriter;
private final RetryOptions retryOptions;
private final IdentifyOptions identifyOptions;
private final String token;
private final GatewayObserver initialObserver;
private final PayloadTransformer identifyLimiter;
// reactive pipelines
private final EmitterProcessor receiver = EmitterProcessor.create(false);
private final EmitterProcessor sender = EmitterProcessor.create(false);
private final EmitterProcessor dispatch = EmitterProcessor.create(false);
private final EmitterProcessor> outbound = EmitterProcessor.create(false);
private final EmitterProcessor> heartbeats = EmitterProcessor.create(false);
private final FluxSink receiverSink;
private final FluxSink senderSink;
private final FluxSink dispatchSink;
private final FluxSink> outboundSink;
private final FluxSink> heartbeatSink;
// mutable state
private final AtomicBoolean connected = new AtomicBoolean(false);
private final AtomicBoolean resumable = new AtomicBoolean(true);
private final AtomicInteger sequence = new AtomicInteger(0);
private final AtomicLong lastSent = new AtomicLong(0);
private final AtomicLong lastAck = new AtomicLong(0);
private final AtomicLong responseTime = new AtomicLong(0);
private final ResettableInterval heartbeat = new ResettableInterval();
private final AtomicReference sessionId = new AtomicReference<>("");
private volatile GatewayObserver observer;
private volatile MonoProcessor disconnectNotifier;
private volatile MonoProcessor closeTrigger;
/**
* Initializes a new GatewayClient.
*
* @param httpClient the underlying HttpClient used to perform the connection
* @param payloadReader strategy to read and decode incoming gateway messages
* @param payloadWriter strategy to encode and write outgoing gateway messages
* @param retryOptions reconnect policy used in this client
* @param token Discord bot token
* @param identifyOptions used to IDENTIFY or RESUME a gateway connection, specifying the sharding options
* and to set an initial presence
* @param observer consumer observing gateway and underlying websocket lifecycle changes, can be {@code null}
* @param identifyLimiter rate-limiting policy used for IDENTIFY requests, allowing shard coordination
*/
public DefaultGatewayClient(HttpClient httpClient, PayloadReader payloadReader, PayloadWriter payloadWriter,
RetryOptions retryOptions, String token, IdentifyOptions identifyOptions,
@Nullable GatewayObserver observer, PayloadTransformer identifyLimiter) {
this.httpClient = Objects.requireNonNull(httpClient);
this.payloadReader = Objects.requireNonNull(payloadReader);
this.payloadWriter = Objects.requireNonNull(payloadWriter);
this.retryOptions = Objects.requireNonNull(retryOptions);
this.token = Objects.requireNonNull(token);
this.identifyOptions = Objects.requireNonNull(identifyOptions);
this.initialObserver = observer;
this.identifyLimiter = Objects.requireNonNull(identifyLimiter);
this.receiverSink = receiver.sink(FluxSink.OverflowStrategy.LATEST);
this.senderSink = sender.sink(FluxSink.OverflowStrategy.LATEST);
this.dispatchSink = dispatch.sink(FluxSink.OverflowStrategy.LATEST);
this.outboundSink = outbound.sink(FluxSink.OverflowStrategy.LATEST);
this.heartbeatSink = heartbeats.sink(FluxSink.OverflowStrategy.LATEST);
this.log = shardLogger(".client");
}
@Override
public Mono execute(String gatewayUrl) {
return execute(gatewayUrl, GatewayObserver.NOOP_LISTENER);
}
@Override
public Mono execute(String gatewayUrl, GatewayObserver additionalObserver) {
return Mono.defer(() -> {
disconnectNotifier = MonoProcessor.create();
closeTrigger = MonoProcessor.create();
observer = initialObserver == null ? additionalObserver : initialObserver.then(additionalObserver);
lastAck.set(0);
Logger senderLog = shardLogger(".sender");
Logger receiverLog = shardLogger(".receiver");
// Setup the sending logic from multiple sources into one merged Flux
Flux identifyFlux = outbound.filter(payload -> Opcode.IDENTIFY.equals(payload.getOp()))
.flatMap(payload -> Flux.from(payloadWriter.write(payload)))
.transform(identifyLimiter);
PayloadTransformer limiter = new RateLimiterTransformer(
new SimpleBucket(outboundLimiterCapacity(), Duration.ofSeconds(60)));
Flux payloadFlux = outbound.filter(payload -> !Opcode.IDENTIFY.equals(payload.getOp()))
.log(shardLogger(".outbound"), Level.FINE, false)
.flatMap(payload -> Flux.from(payloadWriter.write(payload)))
.transform(buf -> Flux.merge(buf, sender))
.transform(limiter);
Flux heartbeatFlux = heartbeats.flatMap(payload -> Flux.from(payloadWriter.write(payload)));
Flux outFlux = Flux.merge(heartbeatFlux, identifyFlux, payloadFlux)
.doOnNext(buf -> trace(senderLog, buf));
int shard = identifyOptions.getShardIndex();
DiscordWebSocketHandler handler = new DiscordWebSocketHandler(receiverSink, outFlux, closeTrigger, shard);
if (identifyOptions.getResumeSequence() != null) {
this.sequence.set(identifyOptions.getResumeSequence());
this.sessionId.set(identifyOptions.getResumeSessionId());
} else {
resumable.set(false);
}
Mono readyHandler = dispatch.filter(DefaultGatewayClient::isReadyOrResume)
.flatMap(event -> {
connected.compareAndSet(false, true);
RetryContext retryContext = retryOptions.getRetryContext();
ConnectionObserver.State state;
if (retryContext.getResetCount() == 0) {
log.info("Connected to Gateway");
dispatchSink.next(GatewayStateChange.connected());
state = GatewayObserver.CONNECTED;
} else {
log.info("Reconnected to Gateway");
dispatchSink.next(GatewayStateChange.retrySucceeded(retryContext.getAttempts()));
state = GatewayObserver.RETRY_SUCCEEDED;
}
retryContext.reset();
identifyOptions.setResumeSessionId(sessionId.get());
resumable.set(true);
notifyObserver(state, identifyOptions);
return Mono.just(event);
})
.then()
.log(shardLogger(".zip.ready"), Level.FINEST, false);
// Subscribe the receiver to process and transform the inbound payloads into Dispatch events
Mono receiverFuture = receiver.doOnNext(buf -> trace(receiverLog, buf))
.flatMap(payloadReader::read)
.log(shardLogger(".inbound"), Level.FINE, false)
.map(this::updateSequence)
.map(payload -> new PayloadContext<>(payload, handler, this))
.doOnNext(PayloadHandlers::handle)
.then()
.log(shardLogger(".zip.receiver"), Level.FINEST, false);
// Subscribe the handler's outbound exchange with our outgoing signals
// routing completion signals to close the gateway
Mono senderFuture = outbound.doOnComplete(handler::close)
.doOnNext(payload -> {
if (Opcode.RECONNECT.equals(payload.getOp())) {
handler.error(new RuntimeException("Reconnecting due to user action"));
}
})
.then()
.log(shardLogger(".zip.sender"), Level.FINEST, false);
// Create the heartbeat loop, and subscribe it using the sender sink
Mono heartbeatHandler = heartbeat.ticks()
.flatMap(t -> {
long now = System.currentTimeMillis();
lastAck.compareAndSet(0, now);
long delay = now - lastAck.get();
if (delay > heartbeat.getPeriod().toMillis() + getResponseTime()) {
log.warn("Missing heartbeat ACK for {} ms", delay);
handler.error(new RuntimeException("Reconnecting due to zombie or failed connection"));
return Mono.empty();
} else {
log.debug("Sending heartbeat {} ms after last ACK", delay);
lastSent.set(now);
return Mono.just(GatewayPayload.heartbeat(new Heartbeat(sequence.get())));
}
})
.doOnNext(heartbeatSink::next)
.then()
.log(shardLogger(".zip.heartbeat"), Level.FINEST, false);
Mono httpFuture = httpClient
.headers(headers -> headers.add(USER_AGENT, initUserAgent()))
.observe(getObserver())
.websocket(Integer.MAX_VALUE)
.uri(gatewayUrl)
.handle(handler::handle)
.doOnTerminate(heartbeat::stop)
.then()
.log(shardLogger(".zip.http"), Level.FINEST, false);
return Mono.zip(httpFuture, readyHandler, receiverFuture, senderFuture, heartbeatHandler)
.doOnError(logReconnectReason())
.then();
})
.retryWhen(retryFactory())
.doOnCancel(() -> closeTrigger.onNext(CloseStatus.NORMAL_CLOSE))
.then(Mono.defer(() -> disconnectNotifier));
}
private String initUserAgent() {
final Properties properties = GitProperties.getProperties();
final String version = properties.getProperty(GitProperties.APPLICATION_VERSION, "3");
final String url = properties.getProperty(GitProperties.APPLICATION_URL, "https://discord4j.com");
return "DiscordBot(" + url + ", " + version + ")";
}
private void trace(Logger log, ByteBuf buf) {
if (log.isTraceEnabled()) {
log.trace(buf.toString(StandardCharsets.UTF_8)
.replaceAll("(\"token\": ?\")([A-Za-z0-9.-]*)(\")", "$1hunter2$3"));
}
}
private Logger shardLogger(String gateway) {
return Loggers.getLogger("discord4j.gateway" + gateway + "." + identifyOptions.getShardIndex());
}
private static boolean isReadyOrResume(Dispatch d) {
return Ready.class.isAssignableFrom(d.getClass()) || Resumed.class.isAssignableFrom(d.getClass());
}
private GatewayPayload updateSequence(GatewayPayload payload) {
if (payload.getSequence() != null) {
sequence.set(payload.getSequence());
identifyOptions.setResumeSequence(sequence.get());
notifyObserver(GatewayObserver.SEQUENCE, identifyOptions);
}
return payload;
}
private Retry retryFactory() {
return Retry.onlyIf(t -> isRetryable(t.exception()))
.withApplicationContext(retryOptions.getRetryContext())
.withBackoffScheduler(retryOptions.getBackoffScheduler())
.backoff(retryOptions.getBackoff())
.jitter(retryOptions.getJitter())
.retryMax(retryOptions.getMaxRetries())
.doOnRetry(context -> {
connected.compareAndSet(true, false);
int attempt = context.applicationContext().getAttempts();
long backoff = context.backoff().toMillis();
log.info("Retry attempt {} in {} ms", attempt, backoff);
if (attempt == 1) {
dispatchSink.next(GatewayStateChange.retryStarted(Duration.ofMillis(backoff)));
if (!resumable.get() || !isResumableError(context.exception())) {
resumable.compareAndSet(true, false);
notifyObserver(GatewayObserver.RETRY_STARTED, identifyOptions);
} else {
notifyObserver(GatewayObserver.RETRY_RESUME_STARTED, identifyOptions);
}
} else {
dispatchSink.next(GatewayStateChange.retryFailed(attempt - 1,
Duration.ofMillis(backoff)));
// TODO: add attempt/backoff values to GatewayObserver
notifyObserver(GatewayObserver.RETRY_FAILED, identifyOptions);
resumable.set(false);
}
context.applicationContext().next();
});
}
private boolean isRetryable(Throwable t) {
if (t instanceof CloseException) {
CloseException closeException = (CloseException) t;
return closeException.getCode() != 4004;
}
return !(t instanceof PartialDisconnectException);
}
private boolean isResumableError(Throwable t) {
if (t instanceof CloseException) {
CloseException closeException = (CloseException) t;
return closeException.getCode() < 4000;
}
return true;
}
private Consumer logReconnectReason() {
return t -> {
if ((t instanceof CloseException && isResumableError(t)) || t instanceof PartialDisconnectException) {
log.error("Gateway client error: {}", t.toString());
} else {
log.error("Gateway client error", t);
}
};
}
private ConnectionObserver getObserver() {
return (connection, newState) -> {
log.debug("{} {}", newState, connection);
if (closeTrigger.isTerminated() && newState == ConnectionObserver.State.DISCONNECTING) {
log.info("Disconnected from Gateway");
retryOptions.getRetryContext().clear();
connected.compareAndSet(true, false);
lastSent.set(0);
lastAck.set(0);
responseTime.set(0);
dispatchSink.next(GatewayStateChange.disconnected());
if (closeTrigger.isError()) {
notifyObserver(GatewayObserver.DISCONNECTED_RESUME, identifyOptions);
} else {
resumable.set(false);
sequence.set(0);
sessionId.set("");
notifyObserver(GatewayObserver.DISCONNECTED, identifyOptions);
}
disconnectNotifier.onComplete();
}
notifyObserver(newState, identifyOptions);
};
}
private void notifyObserver(ConnectionObserver.State state, IdentifyOptions options) {
observer.onStateChange(state, options);
}
@Override
public Mono close(boolean allowResume) {
return Mono.defer(() -> {
if (closeTrigger == null || disconnectNotifier == null) {
return Mono.error(new IllegalStateException("Gateway client is not active!"));
}
if (allowResume) {
closeTrigger.onError(new PartialDisconnectException());
} else {
closeTrigger.onNext(CloseStatus.NORMAL_CLOSE);
}
return disconnectNotifier
.log(shardLogger(".disconnect"), Level.FINE, false);
});
}
@Override
public Flux dispatch() {
return dispatch;
}
@Override
public Flux> receiver() {
return receiver.flatMap(payloadReader::read);
}
@Override
public Flux receiver(Function> mapper) {
return receiver.flatMap(mapper);
}
@Override
public FluxSink> sender() {
return outboundSink;
}
@Override
public Mono sendBuffer(Publisher publisher) {
return Flux.from(publisher).doOnNext(senderSink::next).then();
}
@Override
public String getSessionId() {
return sessionId.get();
}
@Override
public int getSequence() {
return sequence.get();
}
@Override
public boolean isConnected() {
return connected.get();
}
@Override
public long getResponseTime() {
return responseTime.get();
}
/////////////////////////////////
// Methods for PayloadHandlers //
/////////////////////////////////
void ackHeartbeat() {
responseTime.set(lastAck.updateAndGet(x -> System.currentTimeMillis()) - lastSent.get());
}
////////////////////////////////
// Fields for PayloadHandlers //
////////////////////////////////
/**
* Obtains the FluxSink to send Dispatch events towards GatewayClient's users.
*
* @return a {@link FluxSink} for {@link Dispatch}
* objects
*/
FluxSink dispatchSink() {
return dispatchSink;
}
/**
* Gets the atomic reference for the current heartbeat sequence.
*
* @return an AtomicInteger representing the current gateway sequence
*/
AtomicInteger sequence() {
return sequence;
}
/**
* Gets the atomic reference for the current session ID.
*
* @return an AtomicReference of the String representing the current session ID
*/
AtomicReference sessionId() {
return sessionId;
}
/**
* Gets the heartbeat manager bound to this GatewayClient.
*
* @return a {@link ResettableInterval} to manipulate heartbeat operations
*/
ResettableInterval heartbeat() {
return heartbeat;
}
/**
* Gets the token used to connect to the gateway.
*
* @return a token String
*/
String token() {
return token;
}
/**
* An boolean value indicating if this client will attempt to RESUME.
*
* @return an AtomicBoolean representing resume capabilities
*/
AtomicBoolean resumable() {
return resumable;
}
/**
* Gets the configuration object for gateway identifying procedure.
*
* @return an IdentifyOptions configuration object
*/
IdentifyOptions identifyOptions() {
return identifyOptions;
}
/**
* Gets the configuration object for gateway reconnection procedure.
*
* @return a RetryOptions configuration object
*/
RetryOptions retryOptions() {
return retryOptions;
}
// Initializers to customize internal outbound rate-limiter
/**
* JVM property that allows modifying the number of outbound payloads permitted before activating the
* rate-limiter and delaying every following payload for 60 seconds. Default value: 115 permits
*/
private static final String OUTBOUND_CAPACITY_PROPERTY = "discord4j.gateway.outbound.capacity";
private long outboundLimiterCapacity() {
String capacityValue = System.getProperty(OUTBOUND_CAPACITY_PROPERTY);
if (capacityValue != null) {
try {
long capacity = Long.valueOf(capacityValue);
shardLogger("").info("Overriding default outbound limiter capacity: {}", capacity);
} catch (NumberFormatException e) {
shardLogger("").warn("Invalid custom outbound limiter capacity: {}", capacityValue);
}
}
return 115;
}
}