[BlobAsync] Patch 4: Browser Classes & Logic.

storage/browser/blob/blob_data_builder.h

 // Copyright (c) 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 STORAGE_BROWSER_BLOB_BLOB_DATA_BUILDER_H_
 #define STORAGE_BROWSER_BLOB_BLOB_DATA_BUILDER_H_
 
 #include <stdint.h>
 #include <ostream>
 #include <string>
 #include <vector>
 
 #include "base/basictypes.h"
 #include "base/files/file_path.h"
 #include "base/memory/ref_counted.h"
 #include "storage/browser/blob/blob_data_item.h"
 #include "storage/browser/blob/blob_data_snapshot.h"
 #include "storage/browser/storage_browser_export.h"
 
 namespace disk_cache {
 class Entry;
 }
 
 namespace storage {
 class BlobStorageContext;
+class ShareableFileReference;
 
 class STORAGE_EXPORT BlobDataBuilder {
  public:
   using DataHandle = BlobDataItem::DataHandle;
 
+  // This is the filename used for the temporary file items added by
+  // AppendFutureFile.
+  const static char kAppendFutureFileTemporaryFileName[];
+
   explicit BlobDataBuilder(const std::string& uuid);
   ~BlobDataBuilder();
 
   const std::string& uuid() const { return uuid_; }
 
   // Validates the data element that was sent over IPC, and copies the data if
   // it's a 'bytes' element. Data elements of BYTES_DESCRIPTION or
   // DISK_CACHE_ENTRY types are not valid IPC data element types, and cannot be
   // given to this method.
   void AppendIPCDataElement(const DataElement& ipc_data);
 
   // Copies the given data into the blob.
   void AppendData(const std::string& data) {
     AppendData(data.c_str(), data.size());
   }
 
   // Copies the given data into the blob.
   void AppendData(const char* data, size_t length);
 
   // Adds an item that is flagged for future data population. The memory is not
   // allocated until the first call to PopulateFutureData. Returns the index of
-  // the item (to be used in PopulateFutureData).
-  // Length cannot be 0.
+  // the item (to be used in PopulateFutureData). |length| cannot be 0.
   size_t AppendFutureData(size_t length);
 
   // Populates a part of an item previously allocated with AppendFutureData.
   // The first call to PopulateFutureData lazily allocates the memory for the
   // data element.
   // Returns true if:
   // * The item was created by using AppendFutureData,
   // * The offset and length are valid, and
   // * data is a valid pointer.
   bool PopulateFutureData(size_t index,
                           const char* data,
                           size_t offset,
                           size_t length);
 
+  // Adds an item that is flagged for future data population. Use
+  // 'PopulateFutureFile' to set the file path and expected modification time
+  // of this file. Returns the index of the item (to be used in
+  // PopulateFutureFile). The temporary filename used by this method is
+  // kAppendFutureFileTemporaryFileName. |length| cannot be 0.
+  size_t AppendFutureFile(uint64_t offset, uint64_t length);
+
+  // Populates a part of an item previously allocated with AppendFutureFile.
+  // Returns true if:
+  // * The item was created by using AppendFutureFile and
+  // * The filepath is valid.
+  bool PopulateFutureFile(
+      size_t index,
+      const scoped_refptr<ShareableFileReference>& file_reference,
+      const base::Time& expected_modification_time);
+
   // You must know the length of the file, you cannot use kuint64max to specify
   // the whole file.  This method creates a ShareableFileReference to the given
   // file, which is stored in this builder.
   void AppendFile(const base::FilePath& file_path,
                   uint64_t offset,
                   uint64_t length,
                   const base::Time& expected_modification_time);
 
   void AppendBlob(const std::string& uuid, uint64_t offset, uint64_t length);
 
@@ skipping 71 matching lines @@
 }
 
 inline bool operator!=(const BlobDataBuilder& a, const BlobDataBuilder& b) {
   return !(a == b);
 }
 
 #endif  // defined(UNIT_TEST)
 
 }  // namespace storage
 #endif  // STORAGE_BROWSER_BLOB_BLOB_DATA_BUILDER_H_