Index: net/http2/decoder/http2_frame_decoder.h |
diff --git a/net/http2/decoder/http2_frame_decoder.h b/net/http2/decoder/http2_frame_decoder.h |
deleted file mode 100644 |
index f440993a3b6765b99591f4aa4b949de4877706b2..0000000000000000000000000000000000000000 |
--- a/net/http2/decoder/http2_frame_decoder.h |
+++ /dev/null |
@@ -1,203 +0,0 @@ |
-// Copyright 2016 The Chromium Authors. All rights reserved. |
-// Use of this source code is governed by a BSD-style license that can be |
-// found in the LICENSE file. |
- |
-#ifndef NET_HTTP2_DECODER_HTTP2_FRAME_DECODER_H_ |
-#define NET_HTTP2_DECODER_HTTP2_FRAME_DECODER_H_ |
- |
-// Http2FrameDecoder decodes the available input until it reaches the end of |
-// the input or it reaches the end of the first frame in the input. |
-// Note that Http2FrameDecoder does only minimal validation; for example, |
-// stream ids are not checked, nor is the sequence of frames such as |
-// CONTINUATION frame placement. |
-// |
-// Http2FrameDecoder enters state kError once it has called the listener's |
-// OnFrameSizeError or OnPaddingTooLong methods, and at this time has no |
-// provision for leaving that state. While the HTTP/2 spec (RFC7540) allows |
-// for some such errors to be considered as just stream errors in some cases, |
-// this implementation treats them all as connection errors. |
- |
-#include <stddef.h> |
- |
-#include "base/logging.h" |
-#include "base/macros.h" |
-#include "net/base/net_export.h" |
-#include "net/http2/decoder/decode_buffer.h" |
-#include "net/http2/decoder/decode_status.h" |
-#include "net/http2/decoder/frame_decoder_state.h" |
-#include "net/http2/decoder/http2_frame_decoder_listener.h" |
-#include "net/http2/decoder/payload_decoders/altsvc_payload_decoder.h" |
-#include "net/http2/decoder/payload_decoders/continuation_payload_decoder.h" |
-#include "net/http2/decoder/payload_decoders/data_payload_decoder.h" |
-#include "net/http2/decoder/payload_decoders/goaway_payload_decoder.h" |
-#include "net/http2/decoder/payload_decoders/headers_payload_decoder.h" |
-#include "net/http2/decoder/payload_decoders/ping_payload_decoder.h" |
-#include "net/http2/decoder/payload_decoders/priority_payload_decoder.h" |
-#include "net/http2/decoder/payload_decoders/push_promise_payload_decoder.h" |
-#include "net/http2/decoder/payload_decoders/rst_stream_payload_decoder.h" |
-#include "net/http2/decoder/payload_decoders/settings_payload_decoder.h" |
-#include "net/http2/decoder/payload_decoders/unknown_payload_decoder.h" |
-#include "net/http2/decoder/payload_decoders/window_update_payload_decoder.h" |
-#include "net/http2/http2_structures.h" |
- |
-namespace net { |
-namespace test { |
-class Http2FrameDecoderPeer; |
-} // namespace test |
- |
-class NET_EXPORT_PRIVATE Http2FrameDecoder { |
- public: |
- explicit Http2FrameDecoder(Http2FrameDecoderListener* listener); |
- Http2FrameDecoder() : Http2FrameDecoder(nullptr) {} |
- |
- // The decoder will call the listener's methods as it decodes a frame. |
- void set_listener(Http2FrameDecoderListener* listener); |
- Http2FrameDecoderListener* listener() const; |
- |
- // The decoder will reject frame's whose payload |
- // length field exceeds the maximum payload size. |
- void set_maximum_payload_size(size_t v) { maximum_payload_size_ = v; } |
- size_t maximum_payload_size() const { return maximum_payload_size_; } |
- |
- // Decodes the input up to the next frame boundary (i.e. at most one frame). |
- // |
- // Returns kDecodeDone if it decodes the final byte of a frame, OR if there |
- // is no input and it is awaiting the start of a new frame (e.g. if this |
- // is the first call to DecodeFrame, or if the previous call returned |
- // kDecodeDone). |
- // |
- // Returns kDecodeInProgress if it decodes all of the decode buffer, but has |
- // not reached the end of the frame. |
- // |
- // Returns kDecodeError if the frame's padding or length wasn't valid (i.e. if |
- // the decoder called either the listener's OnPaddingTooLong or |
- // OnFrameSizeError method). |
- DecodeStatus DecodeFrame(DecodeBuffer* db); |
- |
- ////////////////////////////////////////////////////////////////////////////// |
- // Methods that support Http2FrameDecoderAdapter. |
- |
- // Is the remainder of the frame's payload being discarded? |
- bool IsDiscardingPayload() const { return state_ == State::kDiscardPayload; } |
- |
- // Returns the number of bytes of the frame's payload that remain to be |
- // decoded, excluding any trailing padding. This method must only be called |
- // after the frame header has been decoded AND DecodeFrame has returned |
- // kDecodeInProgress. |
- size_t remaining_payload() const; |
- |
- // Returns the number of bytes of trailing padding after the payload that |
- // remain to be decoded. This method must only be called if the frame type |
- // allows padding, and after the frame header has been decoded AND |
- // DecodeFrame has returned. Will return 0 if the Pad Length field has not |
- // yet been decoded. |
- uint32_t remaining_padding() const; |
- |
- private: |
- enum class State { |
- // Ready to start decoding a new frame's header. |
- kStartDecodingHeader, |
- // Was in state kStartDecodingHeader, but unable to read the entire frame |
- // header, so needs more input to complete decoding the header. |
- kResumeDecodingHeader, |
- |
- // Have decoded the frame header, and started decoding the available bytes |
- // of the frame's payload, but need more bytes to finish the job. |
- kResumeDecodingPayload, |
- |
- // Decoding of the most recently started frame resulted in an error: |
- // OnPaddingTooLong or OnFrameSizeError was called to indicate that the |
- // decoder detected a problem, or OnFrameHeader returned false, indicating |
- // that the listener detected a problem. Regardless of which, the decoder |
- // will stay in state kDiscardPayload until it has been passed the rest |
- // of the bytes of the frame's payload that it hasn't yet seen, after |
- // which it will be ready to decode another frame. |
- kDiscardPayload, |
- }; |
- |
- friend class test::Http2FrameDecoderPeer; |
- friend std::ostream& operator<<(std::ostream& out, State v); |
- |
- DecodeStatus StartDecodingPayload(DecodeBuffer* db); |
- DecodeStatus ResumeDecodingPayload(DecodeBuffer* db); |
- DecodeStatus DiscardPayload(DecodeBuffer* db); |
- |
- const Http2FrameHeader& frame_header() const { |
- return frame_decoder_state_.frame_header(); |
- } |
- |
- // Clear any of the flags in the frame header that aren't set in valid_flags. |
- void RetainFlags(uint8_t valid_flags); |
- |
- // Clear all of the flags in the frame header; for use with frame types that |
- // don't define any flags, such as WINDOW_UPDATE. |
- void ClearFlags(); |
- |
- // These methods call the StartDecodingPayload() method of the frame type's |
- // payload decoder, after first clearing invalid flags in the header. The |
- // caller must ensure that the decode buffer does not extend beyond the |
- // end of the payload (handled by Http2FrameDecoder::StartDecodingPayload). |
- DecodeStatus StartDecodingAltSvcPayload(DecodeBuffer* db); |
- DecodeStatus StartDecodingContinuationPayload(DecodeBuffer* db); |
- DecodeStatus StartDecodingDataPayload(DecodeBuffer* db); |
- DecodeStatus StartDecodingGoAwayPayload(DecodeBuffer* db); |
- DecodeStatus StartDecodingHeadersPayload(DecodeBuffer* db); |
- DecodeStatus StartDecodingPingPayload(DecodeBuffer* db); |
- DecodeStatus StartDecodingPriorityPayload(DecodeBuffer* db); |
- DecodeStatus StartDecodingPushPromisePayload(DecodeBuffer* db); |
- DecodeStatus StartDecodingRstStreamPayload(DecodeBuffer* db); |
- DecodeStatus StartDecodingSettingsPayload(DecodeBuffer* db); |
- DecodeStatus StartDecodingUnknownPayload(DecodeBuffer* db); |
- DecodeStatus StartDecodingWindowUpdatePayload(DecodeBuffer* db); |
- |
- // These methods call the ResumeDecodingPayload() method of the frame type's |
- // payload decoder; they are called only if the preceding call to the |
- // corresponding Start method (above) returned kDecodeInProgress, as did any |
- // subsequent calls to the resume method. |
- // Unlike the Start methods, the decode buffer may extend beyond the |
- // end of the payload, so the method will create a DecodeBufferSubset |
- // before calling the ResumeDecodingPayload method of the frame type's |
- // payload decoder. |
- DecodeStatus ResumeDecodingAltSvcPayload(DecodeBuffer* db); |
- DecodeStatus ResumeDecodingContinuationPayload(DecodeBuffer* db); |
- DecodeStatus ResumeDecodingDataPayload(DecodeBuffer* db); |
- DecodeStatus ResumeDecodingGoAwayPayload(DecodeBuffer* db); |
- DecodeStatus ResumeDecodingHeadersPayload(DecodeBuffer* db); |
- DecodeStatus ResumeDecodingPingPayload(DecodeBuffer* db); |
- DecodeStatus ResumeDecodingPriorityPayload(DecodeBuffer* db); |
- DecodeStatus ResumeDecodingPushPromisePayload(DecodeBuffer* db); |
- DecodeStatus ResumeDecodingRstStreamPayload(DecodeBuffer* db); |
- DecodeStatus ResumeDecodingSettingsPayload(DecodeBuffer* db); |
- DecodeStatus ResumeDecodingUnknownPayload(DecodeBuffer* db); |
- DecodeStatus ResumeDecodingWindowUpdatePayload(DecodeBuffer* db); |
- |
- FrameDecoderState frame_decoder_state_; |
- |
- // We only need one payload decoder at a time, so they share the same storage. |
- union { |
- AltSvcPayloadDecoder altsvc_payload_decoder_; |
- ContinuationPayloadDecoder continuation_payload_decoder_; |
- DataPayloadDecoder data_payload_decoder_; |
- GoAwayPayloadDecoder goaway_payload_decoder_; |
- HeadersPayloadDecoder headers_payload_decoder_; |
- PingPayloadDecoder ping_payload_decoder_; |
- PriorityPayloadDecoder priority_payload_decoder_; |
- PushPromisePayloadDecoder push_promise_payload_decoder_; |
- RstStreamPayloadDecoder rst_stream_payload_decoder_; |
- SettingsPayloadDecoder settings_payload_decoder_; |
- UnknownPayloadDecoder unknown_payload_decoder_; |
- WindowUpdatePayloadDecoder window_update_payload_decoder_; |
- }; |
- |
- State state_; |
- size_t maximum_payload_size_; |
- |
- // Listener used whenever caller passes nullptr to set_listener. |
- Http2FrameDecoderNoOpListener no_op_listener_; |
- |
- DISALLOW_COPY_AND_ASSIGN(Http2FrameDecoder); |
-}; |
- |
-} // namespace net |
- |
-#endif // NET_HTTP2_DECODER_HTTP2_FRAME_DECODER_H_ |