Wired GDataFileSystem::GetFile() method with internal cache.

chrome/browser/chromeos/gdata/gdata_documents_service.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.
 
 #ifndef CHROME_BROWSER_CHROMEOS_GDATA_GDATA_DOCUMENTS_SERVICE_H_
 #define CHROME_BROWSER_CHROMEOS_GDATA_GDATA_DOCUMENTS_SERVICE_H_
 #pragma once
 
 #include <string>
 
@@ skipping 79 matching lines @@
   //
   // Can be called on any thread.
   virtual void DeleteDocument(const GURL& document_url,
                               const EntryActionCallback& callback) = 0;
 
   // Downloads a document identified by its |content_url| in a given |format|.
   // Upon completion, invokes |callback| with results on the calling thread.
   //
   // Can be called on any thread.
   virtual void DownloadDocument(const FilePath& virtual_path,
+                                const FilePath& local_cache_path,
                                 const GURL& content_url,
                                 DocumentExportFormat format,
                                 const DownloadActionCallback& callback) = 0;
 
   // Makes a copy of a document identified by its 'self' link |document_url|.
   // The copy is named as the UTF-8 encoded |new_name| and is not added to any
   // collection. Use AddResourceToDirectory() to add the copy to a collection
   // when needed. Upon completion, invokes |callback| with results on the
   // calling thread.
   //
@@ skipping 36 matching lines @@
   // Creates new collection with |directory_name| under parent directory
   // identified with |parent_content_url|. If |parent_content_url| is empty,
   // the new collection will be created in the root. Upon completion,
   // invokes |callback| and passes newly created entry on the calling thread.
   //
   // Can be called on any thread.
   virtual void CreateDirectory(const GURL& parent_content_url,
                                const FilePath::StringType& directory_name,
                                const GetDataCallback& callback) = 0;
 
-  // Downloads a file identified by its |content_url|. Upon completion, invokes
+  // Downloads a file identified by its |content_url|. The downloaded file will
+  // be stored at |local_cache_path| location. Upon completion, invokes
   // |callback| with results on the calling thread.
   //
   // Can be called on any thread.
   virtual void DownloadFile(const FilePath& virtual_path,
+                            const FilePath& local_cache_path,
                             const GURL& content_url,
                             const DownloadActionCallback& callback) = 0;
 
   // Initiates uploading of a document/file.
   //
   // Can be called on any thread.
   virtual void InitiateUpload(const InitiateUploadParams& params,
                               const InitiateUploadCallback& callback) = 0;
 
   // Resumes uploading of a document/file on the calling thread.
@@ skipping 17 matching lines @@
   virtual GDataOperationRegistry* operation_registry() const OVERRIDE;
   virtual void CancelAll() OVERRIDE;
   virtual void Authenticate(const AuthStatusCallback& callback) OVERRIDE;
   virtual void GetDocuments(const GURL& feed_url,
                             const GetDataCallback& callback) OVERRIDE;
   virtual void GetAccountMetadata(const GetDataCallback& callback) OVERRIDE;
   virtual void DeleteDocument(const GURL& document_url,
                               const EntryActionCallback& callback) OVERRIDE;
   virtual void DownloadDocument(
       const FilePath& virtual_path,
+      const FilePath& local_cache_path,
       const GURL& content_url,
       DocumentExportFormat format,
       const DownloadActionCallback& callback) OVERRIDE;
+  virtual void DownloadFile(const FilePath& virtual_path,
+                            const FilePath& local_cache_path,
+                            const GURL& content_url,
+                            const DownloadActionCallback& callback) OVERRIDE;
   virtual void CopyDocument(const GURL& document_url,
                             const FilePath::StringType& new_name,
                             const GetDataCallback& callback) OVERRIDE;
   virtual void RenameResource(const GURL& document_url,
                               const FilePath::StringType& new_name,
                               const EntryActionCallback& callback) OVERRIDE;
   virtual void AddResourceToDirectory(
       const GURL& parent_content_url,
       const GURL& resource_url,
       const EntryActionCallback& callback) OVERRIDE;
   virtual void RemoveResourceFromDirectory(
       const GURL& parent_content_url,
       const GURL& resource_url,
       const std::string& resource_id,
       const EntryActionCallback& callback) OVERRIDE;
   virtual void CreateDirectory(const GURL& parent_content_url,
                                const FilePath::StringType& directory_name,
                                const GetDataCallback& callback) OVERRIDE;
-  virtual void DownloadFile(const FilePath& virtual_path,
-                            const GURL& content_url,
-                            const DownloadActionCallback& callback) OVERRIDE;
   virtual void InitiateUpload(const InitiateUploadParams& params,
                               const InitiateUploadCallback& callback) OVERRIDE;
   virtual void ResumeUpload(const ResumeUploadParams& params,
                             const ResumeUploadCallback& callback) OVERRIDE;
 
   GDataAuthService* gdata_auth_service() { return gdata_auth_service_.get(); }
 
  private:
   // GDataAuthService::Observer override.
   virtual void OnOAuth2RefreshTokenChanged() OVERRIDE;
@@ skipping 30 matching lines @@
   scoped_ptr<GDataOperationRegistry> operation_registry_;
   base::WeakPtrFactory<DocumentsService> weak_ptr_factory_;
   base::WeakPtr<DocumentsService> weak_ptr_bound_to_ui_thread_;
 
   DISALLOW_COPY_AND_ASSIGN(DocumentsService);
 };
 
 }  // namespace gdata
 
 #endif  // CHROME_BROWSER_CHROMEOS_GDATA_GDATA_DOCUMENTS_SERVICE_H_