chrome/browser/media_galleries/linux/snapshot_file_details.h

   1 // Copyright 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_BROWSER_MEDIA_GALLERIES_LINUX_SNAPSHOT_FILE_DETAILS_H_
   6 #define CHROME_BROWSER_MEDIA_GALLERIES_LINUX_SNAPSHOT_FILE_DETAILS_H_
   7
   8 #include <string>
   9
  10 #include "base/basictypes.h"
  11 #include "base/callback.h"
  12 #include "base/files/file_path.h"
  13 #include "base/platform_file.h"
  14 #include "chrome/browser/media_galleries/fileapi/mtp_device_async_delegate.h"
  15
  16 // Used to represent snapshot file request params.
  17 struct SnapshotRequestInfo {
  18   SnapshotRequestInfo(
  19       const std::string& device_file_path,
  20       const base::FilePath& snapshot_file_path,
  21       const MTPDeviceAsyncDelegate::CreateSnapshotFileSuccessCallback&
  22           success_callback,
  23       const MTPDeviceAsyncDelegate::ErrorCallback& error_callback);
  24   ~SnapshotRequestInfo();
  25
  26   // MTP device file path.
  27   const std::string device_file_path;
  28
  29   // Local platform path of the snapshot file.
  30   const base::FilePath snapshot_file_path;
  31
  32   // A callback to be called when CreateSnapshotFile() succeeds.
  33   const MTPDeviceAsyncDelegate::CreateSnapshotFileSuccessCallback
  34       success_callback;
  35
  36   // A callback to be called when CreateSnapshotFile() fails.
  37   const MTPDeviceAsyncDelegate::ErrorCallback error_callback;
  38 };
  39
  40 // SnapshotFileDetails tracks the current state of the snapshot file (e.g how
  41 // many bytes written to the snapshot file, source file details, snapshot file
  42 // metadata information, etc).
  43 class SnapshotFileDetails {
  44  public:
  45   SnapshotFileDetails(const SnapshotRequestInfo& request_info,
  46                       const base::PlatformFileInfo& file_info);
  47
  48   ~SnapshotFileDetails();
  49
  50   std::string device_file_path() const {
  51     return request_info_.device_file_path;
  52   }
  53
  54   base::FilePath snapshot_file_path() const {
  55     return request_info_.snapshot_file_path;
  56   }
  57
  58   uint32 bytes_written() const {
  59     return bytes_written_;
  60   }
  61
  62   const base::PlatformFileInfo file_info() const {
  63     return file_info_;
  64   }
  65
  66   const MTPDeviceAsyncDelegate::CreateSnapshotFileSuccessCallback
  67       success_callback() const {
  68     return request_info_.success_callback;
  69   }
  70
  71   const MTPDeviceAsyncDelegate::ErrorCallback error_callback() const {
  72     return request_info_.error_callback;
  73   }
  74
  75   bool error_occurred() const {
  76     return error_occurred_;
  77   }
  78
  79   void set_error_occurred(bool error);
  80
  81   // Adds |bytes_written| to |bytes_written_|.
  82   // |bytes_written| specifies the total number of bytes transferred during the
  83   // last write operation.
  84   // If |bytes_written| is valid, returns true and adds |bytes_written| to
  85   // |bytes_written_|.
  86   // If |bytes_written| is invalid, returns false and does not add
  87   // |bytes_written| to |bytes_written_|.
  88   bool AddBytesWritten(uint32 bytes_written);
  89
  90   // Returns true if the snapshot file is created successfully (no more write
  91   // operation is required to complete the snapshot file).
  92   bool IsSnapshotFileWriteComplete() const;
  93
  94   uint32 BytesToRead() const;
  95
  96  private:
  97   // Snapshot file request params.
  98   const SnapshotRequestInfo request_info_;
  99
 100   // Metadata of the snapshot file (such as name, size, type, etc).
 101   const base::PlatformFileInfo file_info_;
 102
 103   // Number of bytes written into the snapshot file.
 104   uint32 bytes_written_;
 105
 106   // Whether an error occurred during file transfer.
 107   bool error_occurred_;
 108
 109   DISALLOW_COPY_AND_ASSIGN(SnapshotFileDetails);
 110 };
 111
 112 #endif  // CHROME_BROWSER_MEDIA_GALLERIES_LINUX_SNAPSHOT_FILE_DETAILS_H_