OLD | NEW |
| (Empty) |
1 // Copyright 2014 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 NET_SPDY_HPACK_ENCODER_H_ | |
6 #define NET_SPDY_HPACK_ENCODER_H_ | |
7 | |
8 #include <map> | |
9 #include <string> | |
10 #include <utility> | |
11 #include <vector> | |
12 | |
13 #include "base/basictypes.h" | |
14 #include "base/macros.h" | |
15 #include "base/strings/string_piece.h" | |
16 #include "net/base/net_export.h" | |
17 #include "net/spdy/hpack_header_table.h" | |
18 #include "net/spdy/hpack_output_stream.h" | |
19 | |
20 // An HpackEncoder encodes header sets as outlined in | |
21 // http://tools.ietf.org/html/draft-ietf-httpbis-header-compression-08 | |
22 | |
23 namespace net { | |
24 | |
25 class HpackHuffmanTable; | |
26 | |
27 namespace test { | |
28 class HpackEncoderPeer; | |
29 } // namespace test | |
30 | |
31 class NET_EXPORT_PRIVATE HpackEncoder { | |
32 public: | |
33 friend class test::HpackEncoderPeer; | |
34 | |
35 // |table| is an initialized HPACK Huffman table, having an | |
36 // externally-managed lifetime which spans beyond HpackEncoder. | |
37 explicit HpackEncoder(const HpackHuffmanTable& table); | |
38 ~HpackEncoder(); | |
39 | |
40 // Encodes the given header set into the given string. Returns | |
41 // whether or not the encoding was successful. | |
42 bool EncodeHeaderSet(const std::map<std::string, std::string>& header_set, | |
43 std::string* output); | |
44 | |
45 // Encodes the given header set into the given string. Only non-indexed | |
46 // literal representations are emitted, bypassing the header table. Huffman | |
47 // coding is also not used. Returns whether the encoding was successful. | |
48 // TODO(jgraettinger): Enable Huffman coding once the table as stablized. | |
49 bool EncodeHeaderSetWithoutCompression( | |
50 const std::map<std::string, std::string>& header_set, | |
51 std::string* output); | |
52 | |
53 // Called upon a change to SETTINGS_HEADER_TABLE_SIZE. Specifically, this | |
54 // is to be called after receiving (and sending an acknowledgement for) a | |
55 // SETTINGS_HEADER_TABLE_SIZE update from the remote decoding endpoint. | |
56 void ApplyHeaderTableSizeSetting(size_t size_setting) { | |
57 header_table_.SetSettingsHeaderTableSize(size_setting); | |
58 } | |
59 | |
60 // Sets externally-owned storage for aggregating character counts of emitted | |
61 // literal representations. | |
62 void SetCharCountsStorage(std::vector<size_t>* char_counts, | |
63 size_t* total_char_counts); | |
64 | |
65 private: | |
66 typedef std::pair<base::StringPiece, base::StringPiece> Representation; | |
67 typedef std::vector<Representation> Representations; | |
68 | |
69 // Emits a static/dynamic indexed representation (Section 7.1). | |
70 void EmitIndex(const HpackEntry* entry); | |
71 | |
72 // Emits a literal representation (Section 7.2). | |
73 void EmitIndexedLiteral(const Representation& representation); | |
74 void EmitNonIndexedLiteral(const Representation& representation); | |
75 void EmitLiteral(const Representation& representation); | |
76 | |
77 // Emits a Huffman or identity string (whichever is smaller). | |
78 void EmitString(base::StringPiece str); | |
79 | |
80 void UpdateCharacterCounts(base::StringPiece str); | |
81 | |
82 // Crumbles a cookie header into sorted, de-duplicated crumbs. | |
83 static void CookieToCrumbs(const Representation& cookie, | |
84 Representations* crumbs_out); | |
85 | |
86 // Crumbles other header field values at \0 delimiters. | |
87 static void DecomposeRepresentation(const Representation& header_field, | |
88 Representations* out); | |
89 | |
90 HpackHeaderTable header_table_; | |
91 HpackOutputStream output_stream_; | |
92 | |
93 bool allow_huffman_compression_; | |
94 const HpackHuffmanTable& huffman_table_; | |
95 | |
96 // Externally-owned, nullable storage for character counts of literals. | |
97 std::vector<size_t>* char_counts_; | |
98 size_t* total_char_counts_; | |
99 | |
100 DISALLOW_COPY_AND_ASSIGN(HpackEncoder); | |
101 }; | |
102 | |
103 } // namespace net | |
104 | |
105 #endif // NET_SPDY_HPACK_ENCODER_H_ | |
OLD | NEW |