io.muserver.Exchange Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of mu-server Show documentation

A simple but powerful web server framework

The newest version!

package io.muserver;

import io.netty.channel.ChannelHandlerContext;
import io.netty.handler.timeout.IdleStateEvent;

/**
 * Either a request and response exchange between a client and server, or a websocket session
 */
interface Exchange {

    void onMessage(ChannelHandlerContext ctx, Object message, DoneCallback doneCallback) throws UnexpectedMessageException;

    void onIdleTimeout(ChannelHandlerContext ctx, IdleStateEvent ise);

    boolean onException(ChannelHandlerContext ctx, Throwable cause);

    void onConnectionEnded(ChannelHandlerContext ctx);

    /**
     * @return The connection that this exchange takes place on
     */
    HttpConnection connection();

    /**
     * Called when this exchange is the upgraded exchange, ready to be used
     */
    void onUpgradeComplete(ChannelHandlerContext ctx);
}

class ExchangeUpgradeEvent {
    final Exchange newExchange;

    ExchangeUpgradeEvent(Exchange newExchange) {
        this.newExchange = newExchange;
    }
    boolean success() {
        return newExchange != null;
    }
}