Http3RequestStreamEncodeStateValidator Class — netty Architecture

Source Code

codec-http3/src/main/java/io/netty/handler/codec/http3/Http3RequestStreamEncodeStateValidator.java lines 26–124

final class Http3RequestStreamEncodeStateValidator extends ChannelOutboundHandlerAdapter
        implements Http3RequestStreamCodecState {
    enum State {
        None,
        Headers,
        FinalHeaders,
        Trailers
    }
    private State state = State.None;

    @Override
    public void write(ChannelHandlerContext ctx, Object msg, ChannelPromise promise) throws Exception {
        if (!(msg instanceof Http3RequestStreamFrame)) {
            super.write(ctx, msg, promise);
            return;
        }
        final Http3RequestStreamFrame frame = (Http3RequestStreamFrame) msg;
        final State nextState = evaluateFrame(state, frame);
        if (nextState == null) {
            frameTypeUnexpected(ctx, msg);
            return;
        }
        state = nextState;
        super.write(ctx, msg, promise);
    }

    @Override
    public boolean started() {
        return isStreamStarted(state);
    }

    @Override
    public boolean receivedFinalHeaders() {
        return isFinalHeadersReceived(state);
    }

    @Override
    public boolean terminated() {
        return isTrailersReceived(state);
    }

    /**
     * Evaluates the passed frame and returns the following:
     * <ul>
     *     <li>Modified {@link State} if the state should be changed.</li>
     *     <li>Same {@link State} as the passed {@code state} if no state change is necessary</li>
     *     <li>{@code null} if the frame is unexpected</li>
     * </ul>
     *
     * @param state Current state.
     * @param frame to evaluate.
     * @return Next {@link State} or {@code null} if the frame is invalid.
     */
    @Nullable
    static State evaluateFrame(State state, Http3RequestStreamFrame frame) {
        if (frame instanceof Http3PushPromiseFrame || frame instanceof Http3UnknownFrame) {
            // always allow push promise frames.
            return state;
        }
        switch (state) {
            case None:
            case Headers:
                if (!(frame instanceof Http3HeadersFrame)) {
                    return null;
                }
                return isInformationalResponse((Http3HeadersFrame) frame) ? State.Headers : State.FinalHeaders;
            case FinalHeaders:
                if (frame instanceof Http3HeadersFrame) {
                    if (isInformationalResponse((Http3HeadersFrame) frame)) {
                        // Information response after final response headers
                        return null;
                    }
                    // trailers
                    return State.Trailers;
                }
                return state;
            case Trailers:
                return null;
            default:
                throw new Error("Unexpected frame state: " + state);
        }