Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(282)

Side by Side Diff: net/base/sdch_manager.h

Issue 1051933002: Split SdchManager::Dictionary out into separate class/file. (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Incorporated comments. Created 5 years, 8 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « net/base/sdch_dictionary_unittest.cc ('k') | net/base/sdch_manager.cc » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be 2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file. 3 // found in the LICENSE file.
4 4
5 // This file contains the SdchManager class and two nested classes 5 // This file contains the SdchManager class and the DictionarySet
6 // (Dictionary, DictionarySet). SdchManager::Dictionary contains all 6 // nested class. The manager is responsible for storing all
7 // of the information about an SDCH dictionary. The manager is 7 // SdchDictionarys, and provides access to them through DictionarySet
8 // responsible for storing those dictionaries, and provides access to 8 // objects. A DictionarySet is an object whose lifetime is under the
9 // them through DictionarySet objects. A DictionarySet is an object 9 // control of the consumer. It is a reference to a set of
10 // whose lifetime is under the control of the consumer. It is a 10 // dictionaries, and guarantees that none of those dictionaries will
11 // reference to a set of dictionaries, and guarantees that none of 11 // be destroyed while the DictionarySet reference is alive.
12 // those dictionaries will be destroyed while the DictionarySet
13 // reference is alive.
14 12
15 #ifndef NET_BASE_SDCH_MANAGER_H_ 13 #ifndef NET_BASE_SDCH_MANAGER_H_
16 #define NET_BASE_SDCH_MANAGER_H_ 14 #define NET_BASE_SDCH_MANAGER_H_
17 15
18 #include <map> 16 #include <map>
19 #include <set> 17 #include <set>
20 #include <string> 18 #include <string>
21 #include <vector> 19 #include <vector>
22 20
23 #include "base/gtest_prod_util.h" 21 #include "base/gtest_prod_util.h"
24 #include "base/memory/ref_counted.h" 22 #include "base/memory/ref_counted.h"
25 #include "base/memory/scoped_ptr.h" 23 #include "base/memory/scoped_ptr.h"
26 #include "base/memory/weak_ptr.h" 24 #include "base/memory/weak_ptr.h"
27 #include "base/observer_list.h" 25 #include "base/observer_list.h"
28 #include "base/threading/thread_checker.h" 26 #include "base/threading/thread_checker.h"
29 #include "base/time/time.h"
30 #include "net/base/net_export.h" 27 #include "net/base/net_export.h"
28 #include "net/base/sdch_dictionary.h"
31 #include "net/base/sdch_problem_codes.h" 29 #include "net/base/sdch_problem_codes.h"
32 #include "url/gurl.h" 30
31 class GURL;
33 32
34 namespace base { 33 namespace base {
35 class Clock;
36 class Value; 34 class Value;
37 } 35 }
38 36
39 namespace net { 37 namespace net {
40 38
41 class SdchObserver; 39 class SdchObserver;
42 40
43 // Provides global database of differential decompression dictionaries for the 41 // Provides global database of differential decompression dictionaries for the
44 // SDCH filter (processes sdch enconded content). 42 // SDCH filter (processes sdch enconded content).
45 // 43 //
46 // The SdchManager maintains a collection of memory resident dictionaries. It 44 // The SdchManager maintains a collection of memory resident dictionaries. It
47 // can find a dictionary (based on a server specification of a hash), store a 45 // can find a dictionary (based on a server specification of a hash), store a
48 // dictionary, and make judgements about what URLs can use, set, etc. a 46 // dictionary, and make judgements about what URLs can use, set, etc. a
49 // dictionary. 47 // dictionary.
50 48
51 // These dictionaries are acquired over the net, and include a header 49 // These dictionaries are acquired over the net, and include a header
52 // (containing metadata) as well as a VCDIFF dictionary (for use by a VCDIFF 50 // (containing metadata) as well as a VCDIFF dictionary (for use by a VCDIFF
53 // module) to decompress data. 51 // module) to decompress data.
54 // 52 //
55 // A dictionary held by the manager may nonetheless outlive the manager if 53 // A dictionary held by the manager may nonetheless outlive the manager if
56 // a DictionarySet object refers to it; see below. 54 // a DictionarySet object refers to it; see below.
57 class NET_EXPORT SdchManager { 55 class NET_EXPORT SdchManager {
58 public: 56 public:
59 class Dictionary; 57 typedef std::map<std::string,
60 typedef std::map<std::string, scoped_refptr<base::RefCountedData<Dictionary>>> 58 scoped_refptr<base::RefCountedData<SdchDictionary>>>
61 DictionaryMap; 59 DictionaryMap;
62 60
63 class NET_EXPORT_PRIVATE Dictionary {
64 public:
65 // Construct a vc-diff usable dictionary from the dictionary_text starting
66 // at the given offset. The supplied client_hash should be used to
67 // advertise the dictionary's availability relative to the suppplied URL.
68 Dictionary(const std::string& dictionary_text,
69 size_t offset,
70 const std::string& client_hash,
71 const std::string& server_hash,
72 const GURL& url,
73 const std::string& domain,
74 const std::string& path,
75 const base::Time& expiration,
76 const std::set<int>& ports);
77
78 ~Dictionary();
79
80 // Sdch filters can get our text to use in decoding compressed data.
81 const std::string& text() const { return text_; }
82
83 const GURL& url() const { return url_; }
84 const std::string& client_hash() const { return client_hash_; }
85 const std::string& server_hash() const { return server_hash_; }
86 const std::string& domain() const { return domain_; }
87 const std::string& path() const { return path_; }
88 const base::Time& expiration() const { return expiration_; }
89 const std::set<int>& ports() const { return ports_; }
90
91 // Security methods to check if we can establish a new dictionary with the
92 // given data, that arrived in response to get of dictionary_url.
93 static SdchProblemCode CanSet(const std::string& domain,
94 const std::string& path,
95 const std::set<int>& ports,
96 const GURL& dictionary_url);
97
98 // Security method to check if we can use a dictionary to decompress a
99 // target that arrived with a reference to this dictionary.
100 SdchProblemCode CanUse(const GURL& referring_url) const;
101
102 // Compare paths to see if they "match" for dictionary use.
103 static bool PathMatch(const std::string& path,
104 const std::string& restriction);
105
106 // Compare domains to see if the "match" for dictionary use.
107 static bool DomainMatch(const GURL& url, const std::string& restriction);
108
109 // Is this dictionary expired?
110 bool Expired() const;
111
112 void SetClockForTesting(scoped_ptr<base::Clock> clock);
113
114 private:
115 friend class base::RefCountedData<Dictionary>;
116
117 // Private copy-constructor to support RefCountedData<>, which requires
118 // that an object stored in it be either DefaultConstructible or
119 // CopyConstructible
120 Dictionary(const Dictionary& rhs);
121
122 // The actual text of the dictionary.
123 std::string text_;
124
125 // Part of the hash of text_ that the client uses to advertise the fact that
126 // it has a specific dictionary pre-cached.
127 std::string client_hash_;
128
129 // Part of the hash of text_ that the server uses to identify the
130 // dictionary it wants used for decoding.
131 std::string server_hash_;
132
133 // The GURL that arrived with the text_ in a URL request to specify where
134 // this dictionary may be used.
135 const GURL url_;
136
137 // Metadate "headers" in before dictionary text contained the following:
138 // Each dictionary payload consists of several headers, followed by the text
139 // of the dictionary. The following are the known headers.
140 const std::string domain_;
141 const std::string path_;
142 const base::Time expiration_; // Implied by max-age.
143 const std::set<int> ports_;
144
145 scoped_ptr<base::Clock> clock_;
146
147 void operator=(const Dictionary&) = delete;
148 };
149
150 // A handle for one or more dictionaries which will keep the dictionaries 61 // A handle for one or more dictionaries which will keep the dictionaries
151 // alive and accessible for the handle's lifetime. 62 // alive and accessible for the handle's lifetime.
152 class NET_EXPORT_PRIVATE DictionarySet { 63 class NET_EXPORT_PRIVATE DictionarySet {
153 public: 64 public:
154 ~DictionarySet(); 65 ~DictionarySet();
155 66
156 // Return a comma separated list of client hashes. 67 // Return a comma separated list of client hashes.
157 std::string GetDictionaryClientHashList() const; 68 std::string GetDictionaryClientHashList() const;
158 69
159 // Lookup a given dictionary based on server hash. Returned pointer 70 // Lookup a given dictionary based on server hash. Returned pointer
160 // is guaranteed to be valid for the lifetime of the DictionarySet. 71 // is guaranteed to be valid for the lifetime of the DictionarySet.
161 // Returns NULL if hash is not a valid server hash for a dictionary 72 // Returns NULL if hash is not a valid server hash for a dictionary
162 // named by DictionarySet. 73 // named by DictionarySet.
163 const SdchManager::Dictionary* GetDictionary(const std::string& hash) const; 74 const SdchDictionary* GetDictionary(const std::string& hash) const;
164 75
165 bool Empty() const; 76 bool Empty() const;
166 77
167 private: 78 private:
168 // A DictionarySet may only be constructed by the SdchManager. 79 // A DictionarySet may only be constructed by the SdchManager.
169 friend class SdchManager; 80 friend class SdchManager;
170 81
171 DictionarySet(); 82 DictionarySet();
172 void AddDictionary(const std::string& server_hash, 83 void AddDictionary(
173 const scoped_refptr<base::RefCountedData< 84 const std::string& server_hash,
174 SdchManager::Dictionary>>& dictionary); 85 const scoped_refptr<base::RefCountedData<SdchDictionary>>& dictionary);
175 86
176 DictionaryMap dictionaries_; 87 DictionaryMap dictionaries_;
177 88
178 DISALLOW_COPY_AND_ASSIGN(DictionarySet); 89 DISALLOW_COPY_AND_ASSIGN(DictionarySet);
179 }; 90 };
180 91
181 SdchManager(); 92 SdchManager();
182 ~SdchManager(); 93 ~SdchManager();
183 94
184 // Clear data (for browser data removal). 95 // Clear data (for browser data removal).
(...skipping 158 matching lines...) Expand 10 before | Expand all | Expand 10 after
343 base::ThreadChecker thread_checker_; 254 base::ThreadChecker thread_checker_;
344 255
345 base::WeakPtrFactory<SdchManager> factory_; 256 base::WeakPtrFactory<SdchManager> factory_;
346 257
347 DISALLOW_COPY_AND_ASSIGN(SdchManager); 258 DISALLOW_COPY_AND_ASSIGN(SdchManager);
348 }; 259 };
349 260
350 } // namespace net 261 } // namespace net
351 262
352 #endif // NET_BASE_SDCH_MANAGER_H_ 263 #endif // NET_BASE_SDCH_MANAGER_H_
OLDNEW
« no previous file with comments | « net/base/sdch_dictionary_unittest.cc ('k') | net/base/sdch_manager.cc » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698