Interface for associating in-memory hint bytes with disk cache entries.

net/disk_cache/disk_cache.h

 // Copyright (c) 2012 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.
 
 // Defines the public interface of the disk cache. For more details see
 // http://dev.chromium.org/developers/design-documents/network-stack/disk-cache
 
 #ifndef NET_DISK_CACHE_DISK_CACHE_H_
 #define NET_DISK_CACHE_DISK_CACHE_H_
 
@@ skipping 205 matching lines @@
   virtual void GetStats(base::StringPairs* stats) = 0;
 
   // Called whenever an external cache in the system reuses the resource
   // referred to by |key|.
   virtual void OnExternalCacheHit(const std::string& key) = 0;
 
   // Returns the estimate of dynamically allocated memory in bytes.
   virtual size_t DumpMemoryStats(
       base::trace_event::ProcessMemoryDump* pmd,
       const std::string& parent_absolute_name) const = 0;
+
+  // Backends can optionally permit one to store, probabilistically, up to a
+  // byte associated with a key of an existing entry in memory.
+
+  // GetMemoryEntryData has the following behavior:
+  // - If the data is not available at this time for any reason, returns 0.
+  // - Otherwise, returns a value that was with very high probability
+  //   given to SetMemoryEntryData(|key|) (and with a very low probability
+  //   to a different key that collides in the in-memory index).
+  //
+  // Due to the probability of collisions, including those that can be induced
+  // by hostile 3rd parties, this interface should not be used to make decisions
+  // that affect correctness (especially security).
+  virtual uint8_t GetMemoryEntryData(const std::string& key);

[Maks Orlovich, 2017/08/23 19:18:11]

Suggestion from the impl CL:

pasko 2017/06/29 16:31:49
nit: maybe GetEntryInMemoryData, which would be closer to "Get Entry's In-Memory
Data"? Thous would be slightly more readable, I think.

[Maks Orlovich, 2017/08/25 18:36:26]

Done.

+  virtual void SetMemoryEntryData(const std::string& key, uint8_t data);
 };
 
 // This interface represents an entry in the disk cache.
 class NET_EXPORT Entry {
  public:
   typedef net::CompletionCallback CompletionCallback;
   typedef net::IOBuffer IOBuffer;
 
   // Marks this cache entry for deletion.
   virtual void Doom() = 0;
@@ skipping 156 matching lines @@
     entry->Close();
   }
 };
 
 // Automatically closes an entry when it goes out of scope.
 typedef std::unique_ptr<Entry, EntryDeleter> ScopedEntryPtr;
 
 }  // namespace disk_cache
 
 #endif  // NET_DISK_CACHE_DISK_CACHE_H_