discord4j.gateway.DiscordWebSocketHandler Maven / Gradle / Ivy

Go to download
/*
 * 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 .
 */
package discord4j.gateway;

import discord4j.common.close.CloseException;
import discord4j.common.close.CloseHandlerAdapter;
import discord4j.common.close.CloseStatus;
import io.netty.buffer.ByteBuf;
import io.netty.handler.codec.http.websocketx.CloseWebSocketFrame;
import io.netty.handler.codec.http.websocketx.TextWebSocketFrame;
import io.netty.handler.codec.http.websocketx.WebSocketFrame;
import reactor.core.publisher.Flux;
import reactor.core.publisher.FluxSink;
import reactor.core.publisher.Mono;
import reactor.core.publisher.MonoProcessor;
import reactor.netty.NettyPipeline;
import reactor.netty.http.websocket.WebsocketInbound;
import reactor.netty.http.websocket.WebsocketOutbound;
import reactor.util.Logger;
import reactor.util.Loggers;

import java.util.concurrent.atomic.AtomicReference;
import java.util.logging.Level;

/**
 * Represents a WebSocket handler specialized for Discord gateway operations.
 * 
 * Includes a zlib-based decompressor and dedicated handling of closing events that normally occur during Discord
 * gateway lifecycle.
 * 

 * This handler uses a {@link FluxSink} of {@link ByteBuf} to push inbound payloads and a {@link Flux} of
 * {@link ByteBuf} to pull outbound payloads.
 * 

 * The handler also provides two methods to control the lifecycle and proper cleanup, like {@link #close()} and
 * {@link #error(Throwable)} which perform operations on the current session. It is necessary to use these methods in
 * order to signal closure or errors and cleanly complete the session.
 */
public class DiscordWebSocketHandler {

    private final FluxSink inbound;
    private final Flux outbound;
    private final MonoProcessor closeTrigger;
    private final MonoProcessor completionNotifier = MonoProcessor.create();
    private final ZlibDecompressor decompressor = new ZlibDecompressor();
    private final Logger log;
    private final int shardIndex;

    /**
     * Create a new handler with the given data pipelines.
     *
     * @param inbound the {@link FluxSink} of {@link ByteBuf} to process inbound payloads
     * @param outbound the {@link Flux} of {@link ByteBuf} to process outbound payloads
     * @param closeTrigger a {@link MonoProcessor} that triggers the closing of this session
     * @param shardIndex the shard index of this connection, for tracing
     */
    public DiscordWebSocketHandler(FluxSink inbound, Flux outbound,
                                   MonoProcessor closeTrigger, int shardIndex) {
        this.inbound = inbound;
        this.outbound = outbound;
        this.closeTrigger = closeTrigger;
        this.shardIndex = shardIndex;
        this.log = shardLogger("");
    }

    public Mono handle(WebsocketInbound in, WebsocketOutbound out) {
        AtomicReference reason = new AtomicReference<>();
        in.withConnection(connection -> connection.addHandlerLast(HANDLER, new CloseHandlerAdapter(reason, log)));

        Mono completionFuture = completionNotifier
                .log(shardLogger(".zip"), Level.FINEST, false);

        Mono closeFuture = closeTrigger
                .map(status -> new CloseWebSocketFrame(status.getCode(), status.getReason()));

        Mono outboundEvents = out.options(NettyPipeline.SendOptions::flushOnEach)
                .sendObject(Flux.merge(closeFuture, outbound.map(TextWebSocketFrame::new)))
                .then()
                .log(shardLogger(".zip.out"), Level.FINEST, false);

        Mono inboundEvents = in.aggregateFrames()
                .receiveFrames()
                .map(WebSocketFrame::content)
                .compose(decompressor::completeMessages)
                .doOnNext(inbound::next)
                .doOnError(this::error)
                .then(Mono.defer(() -> {
                    shardLogger(".inbound").info("Receiver completed on shard {}", shardIndex);
                    CloseStatus closeStatus = reason.get();
                    if (closeStatus != null && !closeTrigger.isTerminated()) {
                        shardLogger(".inbound").info("Forwarding close reason: {}", closeStatus);
                        return Mono.error(new CloseException(closeStatus));
                    }
                    return Mono.empty();
                }))
                .log(shardLogger(".zip.in"), Level.FINEST, false);

        return Mono.zip(completionFuture, outboundEvents, inboundEvents)
                .doOnError(t -> log.debug("WebSocket session threw an error: {}", t.toString()))
                .then();
    }

    /**
     * Initiates a close sequence that will terminate this session. It will notify all exchanges and the session
     * completion {@link reactor.core.publisher.Mono} in
     * {@link #handle(reactor.netty.http.websocket.WebsocketInbound, reactor.netty.http.websocket.WebsocketOutbound)}
     * through a complete signal, dropping all future signals.
     */
    public void close() {
        log.info("Triggering close sequence");
        closeTrigger.onNext(CloseStatus.NORMAL_CLOSE);
        completionNotifier.onComplete();
    }

    /**
     * Initiates a close sequence with the given error. It will terminate this session with an error signal on the
     * {@link #handle(reactor.netty.http.websocket.WebsocketInbound, reactor.netty.http.websocket.WebsocketOutbound)}
     * method, while completing both exchanges through normal complete signals.
     * 
     * The error can then be channeled downstream and acted upon accordingly.
     *
     * @param error the cause for this session termination
     */
    public void error(Throwable error) {
        log.warn("Triggering error sequence ({})", error.toString());
        if (!completionNotifier.isTerminated()) {
            if (error instanceof CloseException) {
                completionNotifier.onError(error);
            } else {
                completionNotifier.onError(new CloseException(new CloseStatus(1006, error.toString()), error));
            }
        }
    }

    private Logger shardLogger(String gateway) {
        return Loggers.getLogger("discord4j.gateway" + gateway + "." + shardIndex);
    }

    private static final String HANDLER = "client.last.closeHandler";
}