1 // Copyright 2016 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
4 
5 #ifndef QUICHE_HTTP2_DECODER_PAYLOAD_DECODERS_SETTINGS_PAYLOAD_DECODER_H_
6 #define QUICHE_HTTP2_DECODER_PAYLOAD_DECODERS_SETTINGS_PAYLOAD_DECODER_H_
7 
8 // Decodes the payload of a SETTINGS frame; for the RFC, see:
9 //     http://httpwg.org/specs/rfc7540.html#SETTINGS
10 
11 #include "quiche/http2/decoder/decode_buffer.h"
12 #include "quiche/http2/decoder/decode_status.h"
13 #include "quiche/http2/decoder/frame_decoder_state.h"
14 #include "quiche/http2/http2_structures.h"
15 #include "quiche/common/platform/api/quiche_export.h"
16 
17 namespace http2 {
18 namespace test {
19 class SettingsPayloadDecoderPeer;
20 }  // namespace test
21 
22 class QUICHE_EXPORT SettingsPayloadDecoder {
23  public:
24   // Starts the decoding of a SETTINGS frame's payload, and completes it if
25   // the entire payload is in the provided decode buffer.
26   DecodeStatus StartDecodingPayload(FrameDecoderState* state, DecodeBuffer* db);
27 
28   // Resumes decoding a SETTINGS frame that has been split across decode
29   // buffers.
30   DecodeStatus ResumeDecodingPayload(FrameDecoderState* state,
31                                      DecodeBuffer* db);
32 
33  private:
34   friend class test::SettingsPayloadDecoderPeer;
35 
36   // Decodes as many settings as are available in the decode buffer, starting at
37   // the first byte of one setting; if a single setting is split across buffers,
38   // ResumeDecodingPayload will handle starting from where the previous call
39   // left off, and then will call StartDecodingSettings.
40   DecodeStatus StartDecodingSettings(FrameDecoderState* state,
41                                      DecodeBuffer* db);
42 
43   // Decoding a single SETTING returned a status other than kDecodeDone; this
44   // method just brings together the QUICHE_DCHECKs to reduce duplication.
45   DecodeStatus HandleNotDone(FrameDecoderState* state, DecodeBuffer* db,
46                              DecodeStatus status);
47 
48   Http2SettingFields setting_fields_;
49 };
50 
51 }  // namespace http2
52 
53 #endif  // QUICHE_HTTP2_DECODER_PAYLOAD_DECODERS_SETTINGS_PAYLOAD_DECODER_H_
54