Offline By Default

services/url_response_disk_cache/url_response_disk_cache_impl.h

 // Copyright 2015 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.
 
 #ifndef SERVICES_URL_RESPONSE_DISK_CACHE_URL_RESPONSE_DISK_CACHE_IMPL_H_
 #define SERVICES_URL_RESPONSE_DISK_CACHE_URL_RESPONSE_DISK_CACHE_IMPL_H_
 
 #include "base/files/file_path.h"
 #include "base/macros.h"
+#include "base/memory/ref_counted.h"
 #include "base/task_runner.h"
 #include "mojo/public/cpp/bindings/strong_binding.h"
 #include "mojo/services/url_response_disk_cache/public/interfaces/url_response_disk_cache.mojom.h"
+#include "services/url_response_disk_cache/url_response_disk_cache_db.h"
 
 namespace mojo {
 
 class URLResponseDiskCacheImpl : public URLResponseDiskCache {
  public:
   using FilePathPairCallback =

[ppi, 2015/09/15 15:21:23]

nit: wdyt about calling this by meaning, ie. ResponseFileAndCacheDirCallback?

[qsr, 2015/09/16 11:46:38]

Done.

       base::Callback<void(const base::FilePath&, const base::FilePath&)>;
 
-  // Cleares the cached content. The actual deletion will be performed using the
-  // given task runner, but cache appears as cleared immediately after the
-  // function returns.
-  static void ClearCache(base::TaskRunner* task_runner);
+  // Create the disk cache database. If |force_clean| is true, or the database

[ppi, 2015/09/15 15:21:23]

nit: Creates

[qsr, 2015/09/16 11:46:39]

Done.

+  // is outdated, it will clear the cached content. The actual deletion will be
+  // performed using the given task runner, but cache appears as cleared
+  // immediately after the function returns.
+  static scoped_refptr<URLResponseDiskCacheDB> CreateDB(
+      scoped_refptr<base::TaskRunner> task_runner,
+      bool force_clean);
 
-  URLResponseDiskCacheImpl(base::TaskRunner* task_runner,
+  URLResponseDiskCacheImpl(scoped_refptr<base::TaskRunner> task_runner,
+                           scoped_refptr<URLResponseDiskCacheDB> db,
                            const std::string& remote_application_url,
                            InterfaceRequest<URLResponseDiskCache> request);
   ~URLResponseDiskCacheImpl() override;
 
  private:
   // URLResponseDiskCache
-  void GetFile(mojo::URLResponsePtr response,
-               const GetFileCallback& callback) override;
-  void GetExtractedContent(
-      mojo::URLResponsePtr response,
-      const GetExtractedContentCallback& callback) override;
+  void Get(const String& url, const GetCallback& callback) override;
+  void Update(URLResponsePtr response) override;
+  void UpdateAndGet(URLResponsePtr response,
+                    const UpdateAndGetCallback& callback) override;
+  void UpdateAndGetExtracted(
+      URLResponsePtr response,
+      const UpdateAndGetExtractedCallback& callback) override;
 
-  // As |GetFile|, but uses FilePath instead of mojo arrays.
-  void GetFileInternal(mojo::URLResponsePtr response,
-                       const FilePathPairCallback& callback);
+  // As |UpdateAndGet|, but uses FilePath instead of mojo arrays.

[ppi, 2015/09/15 15:21:23]

nit: this comment forces the reader to go back all the way to the mojom file to
know the meaning of the FilePaths.

I'd suggest saying:
"Internal implementation of |UpdateAndGet| using a pair of base::FilePath to
represent the paths the the response body and to the per-response client cache
directory." 

[qsr, 2015/09/16 11:46:38]

Done.

+  void UpdateAndGetInternal(URLResponsePtr response,
+                            const FilePathPairCallback& callback);
 
-  // Internal implementation of |GetExtractedContent|. The parameters are:
+  // Internal implementation of |UpdateAndGetExtracted|. The parameters are:
   // |callback|: The callback to return values to the caller. It uses FilePath
   //             instead of mojo arrays.
-  // |base_dir|: The base directory for caching data associated to the response.
-  // |extracted_dir|: The directory where the file content must be extracted. It
-  //                  will be  returned to the consumer.
   // |content|: The content of the body of the response.
-  // |cache_dir|: The directory the user can user to cache its own content.
-  void GetExtractedContentInternal(const FilePathPairCallback& callback,
-                                   const base::FilePath& base_dir,
-                                   const base::FilePath& extracted_dir,
-                                   const base::FilePath& content,
-                                   const base::FilePath& cache_dir);
+  // |cache_directory|: The directory the user can user to cache its own
+  // content.
+  void UpdateAndGetExtractedInternal(
+      const FilePathPairCallback& callback,
+      const base::FilePath& content_path,
+      const base::FilePath& consumer_cache_directory);
 
-  base::TaskRunner* task_runner_;
-  base::FilePath base_directory_;
+  scoped_refptr<base::TaskRunner> task_runner_;
+  std::string request_origin_;
+  base::FilePath cache_directory_;
+  scoped_refptr<URLResponseDiskCacheDB> db_;
   StrongBinding<URLResponseDiskCache> binding_;
 
   DISALLOW_COPY_AND_ASSIGN(URLResponseDiskCacheImpl);
 };
 
 }  // namespace mojo
 
 #endif  // SERVICES_URL_RESPONSE_DISK_CACHE_URL_RESPONSE_DISK_CACHE_IMPL_H_