1c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Copyright (c) 2006-2008 The Chromium Authors. All rights reserved. 2c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Use of this source code is governed by a BSD-style license that can be 3c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// found in the LICENSE file. 4c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 5c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#ifndef NET_HTTP_HTTP_VARY_DATA_H__ 6c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#define NET_HTTP_HTTP_VARY_DATA_H__ 73345a6884c488ff3a535c2c9acdd33d74b37e311Iain Merrick#pragma once 8c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 9c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#include "base/md5.h" 10c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 11c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scottclass Pickle; 12c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 13c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scottnamespace net { 14c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 15c407dc5cd9bdc5668497f21b26b09d988ab439deBen Murdochstruct HttpRequestInfo; 16c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scottclass HttpResponseHeaders; 17c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 18c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Used to implement the HTTP/1.1 Vary header. This class contains a MD5 hash 19c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// over the request headers indicated by a Vary header. 20c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// 21c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// While RFC 2616 requires strict request header comparisons, it is much 22c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// cheaper to store a MD5 sum, which should be sufficient. Storing a hash also 23c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// avoids messy privacy issues as some of the request headers could hold 24c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// sensitive data (e.g., cookies). 25c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// 26c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// NOTE: This class does not hold onto the contents of the Vary header. 27c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Instead, it relies on the consumer to store that and to supply it again to 28c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// the MatchesRequest function for comparing against future HTTP requests. 29c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// 30c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scottclass HttpVaryData { 31c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott public: 32c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott HttpVaryData(); 33c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 34c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott bool is_valid() const { return is_valid_; } 35c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 36c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Initialize from a request and its corresponding response headers. 37c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // 38c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Returns true if a Vary header was found in the response headers and that 39c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Vary header was not empty and did not contain the '*' value. Upon 40c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // success, the object is also marked as valid such that is_valid() will 41c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // return true. Otherwise, false is returned to indicate that this object 42c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // is marked as invalid. 43c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // 44c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott bool Init(const HttpRequestInfo& request_info, 45c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott const HttpResponseHeaders& response_headers); 46c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 47c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Initialize from a pickle that contains data generated by a call to the 48c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // vary data's Persist method. 49c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // 50c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Upon success, true is returned and the object is marked as valid such that 51c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // is_valid() will return true. Otherwise, false is returned to indicate 52c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // that this object is marked as invalid. 53c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // 54c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott bool InitFromPickle(const Pickle& pickle, void** pickle_iter); 55c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 56c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Call this method to persist the vary data. Illegal to call this on an 57c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // invalid object. 58c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott void Persist(Pickle* pickle) const; 59c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 60c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Call this method to test if the given request matches the previous request 61c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // with which this vary data corresponds. The |cached_response_headers| must 62c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // be the same response headers used to generate this vary data. 63c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott bool MatchesRequest(const HttpRequestInfo& request_info, 64c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott const HttpResponseHeaders& cached_response_headers) const; 65c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 66c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott private: 67c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Returns the corresponding request header value. 68c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott static std::string GetRequestValue(const HttpRequestInfo& request_info, 69c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott const std::string& request_header); 70c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 71c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Append to the MD5 context for the given request header. 72c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott static void AddField(const HttpRequestInfo& request_info, 73c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott const std::string& request_header, 74c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott MD5Context* context); 75c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 76c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // A digested version of the request headers corresponding to the Vary header. 77c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott MD5Digest request_digest_; 78c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 79c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // True when request_digest_ contains meaningful data. 80c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott bool is_valid_; 81c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott}; 82c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 83c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott} // namespace net 84c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 85c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#endif // NET_HTTP_HTTP_VARY_DATA_H__ 86