| Index: net/disk_cache/disk_cache.h
|
| diff --git a/net/disk_cache/disk_cache.h b/net/disk_cache/disk_cache.h
|
| index 4f64b9afb02ac4219532491f592d0c7b269985fb..769ab361b199695bc68827815fc3e481cf39666a 100644
|
| --- a/net/disk_cache/disk_cache.h
|
| +++ b/net/disk_cache/disk_cache.h
|
| @@ -13,6 +13,7 @@
|
|
|
| #include "base/basictypes.h"
|
| #include "base/memory/ref_counted.h"
|
| +#include "base/memory/scoped_ptr.h"
|
| #include "base/time/time.h"
|
| #include "net/base/cache_type.h"
|
| #include "net/base/completion_callback.h"
|
| @@ -64,6 +65,26 @@ class NET_EXPORT Backend {
|
| public:
|
| typedef net::CompletionCallback CompletionCallback;
|
|
|
| + class Iterator {
|
| + public:
|
| + virtual ~Iterator() {}
|
| +
|
| + // OpenNextEntry returns |net::OK| and provides |next_entry| if there is an
|
| + // entry to enumerate. It returns |net::ERR_FAILED| at the end of
|
| + // enumeration. If the function returns |net::ERR_IO_PENDING|, then the
|
| + // final result will be passed to the provided |callback|, otherwise
|
| + // |callback| will not be called. If any entry in the cache is modified
|
| + // during iteration, the result of this function is thereafter undefined.
|
| + //
|
| + // Calling OpenNextEntry after the backend which created it is destroyed
|
| + // may fail with |net::ERR_FAILED|; however it should not crash.
|
| + //
|
| + // Some cache backends make stronger guarantees about mutation during
|
| + // iteration, see top comment in simple_backend_impl.h for details.
|
| + virtual int OpenNextEntry(Entry** next_entry,
|
| + const CompletionCallback& callback) = 0;
|
| + };
|
| +
|
| // If the backend is destroyed when there are operations in progress (any
|
| // callback that has not been invoked yet), this method cancels said
|
| // operations so the callbacks are not invoked, possibly leaving the work
|
| @@ -123,31 +144,9 @@ class NET_EXPORT Backend {
|
| virtual int DoomEntriesSince(base::Time initial_time,
|
| const CompletionCallback& callback) = 0;
|
|
|
| - // Enumerates the cache. Initialize |iter| to NULL before calling this method
|
| - // the first time. That will cause the enumeration to start at the head of
|
| - // the cache. For subsequent calls, pass the same |iter| pointer again without
|
| - // changing its value. This method returns ERR_FAILED when there are no more
|
| - // entries to enumerate. When the entry pointer is no longer needed, its
|
| - // Close method should be called. The return value is a net error code. If
|
| - // this method returns ERR_IO_PENDING, the |callback| will be invoked when the
|
| - // |next_entry| is available. The pointer to receive the |next_entry| must
|
| - // remain valid until the operation completes.
|
| - //
|
| - // NOTE: This method does not modify the last_used field of the entry, and
|
| - // therefore it does not impact the eviction ranking of the entry. However,
|
| - // an enumeration will go through all entries on the cache only if the cache
|
| - // is not modified while the enumeration is taking place. Significantly
|
| - // altering the entry pointed by |iter| (for example, deleting the entry) will
|
| - // invalidate |iter|. Performing operations on an entry that modify the entry
|
| - // may result in loops in the iteration, skipped entries or similar.
|
| - virtual int OpenNextEntry(void** iter, Entry** next_entry,
|
| - const CompletionCallback& callback) = 0;
|
| -
|
| - // Releases iter without returning the next entry. Whenever OpenNextEntry()
|
| - // returns true, but the caller is not interested in continuing the
|
| - // enumeration by calling OpenNextEntry() again, the enumeration must be
|
| - // ended by calling this method with iter returned by OpenNextEntry().
|
| - virtual void EndEnumeration(void** iter) = 0;
|
| + // Returns an iterator which will enumerate all entries of the cache in an
|
| + // undefined order.
|
| + virtual scoped_ptr<Iterator> CreateIterator() = 0;
|
|
|
| // Return a list of cache statistics.
|
| virtual void GetStats(
|
|
|