Add request header on gdata operation for testing ETag match.

chrome/browser/google_apis/drive_service_interface.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_GOOGLE_APIS_DRIVE_SERVICE_INTERFACE_H_
 #define CHROME_BROWSER_GOOGLE_APIS_DRIVE_SERVICE_INTERFACE_H_
 
 #include <string>
 
 // TODO(kochi): Further split gdata_operations.h and include only necessary
@@ skipping 127 matching lines @@
 
   // Gets the account metadata from the server using the default account
   // metadata URL. Upon completion, invokes |callback| with results on the
   // calling thread.
   virtual void GetAccountMetadata(const gdata::GetDataCallback& callback) = 0;
 
   // Gets the application information from the server.
   // Upon completion, invokes |callback| with results on the calling thread.
   virtual void GetApplicationInfo(const gdata::GetDataCallback& callback) = 0;
 
-  // Deletes a document identified by its 'self' |url| and |etag|.
+  // Deletes a document identified by its 'self' |document_url|.
+  // If |etag| is set, checks if it matches the document before deletion.

[satorux1, 2012/10/17 03:14:27]

If etag does not match, what happens? Please document. I guess the server
returns an error. If so, what error?

   // Upon completion, invokes |callback| with results on the calling thread.
   virtual void DeleteDocument(const GURL& document_url,
+                              const std::string& etag,
                               const gdata::EntryActionCallback& callback) = 0;
 
   // Downloads a document identified by its |content_url| in a given |format|.
+  // If |etag| is set, checks if it matches the document before downloading.

[satorux1, 2012/10/17 03:14:27]

ditto.

   // Upon completion, invokes |callback| with results on the calling thread.
   virtual void DownloadDocument(
       const FilePath& virtual_path,
       const FilePath& local_cache_path,
       const GURL& content_url,
       DocumentExportFormat format,
+      const std::string& etag,
       const gdata::DownloadActionCallback& callback) = 0;
 
   // Makes a copy of a document identified by its |resource_id|.
   // 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.
   virtual void CopyDocument(const std::string& resource_id,
                             const FilePath::StringType& new_name,
                             const gdata::GetDataCallback& callback) = 0;
@@ skipping 25 matching lines @@
       const gdata::EntryActionCallback& callback) = 0;
 
   // 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.
   virtual void CreateDirectory(const GURL& parent_content_url,
                                const FilePath::StringType& directory_name,
                                const gdata::GetDataCallback& callback) = 0;
 
-  // Downloads a file identified by its |content_url|. The downloaded file will
-  // be stored at |local_cache_path| location. Upon completion, invokes
-  // |download_action_callback| with results on the calling thread.
+  // Downloads a file identified by its |content_url|.
+  // If |etag| is set, checks if it matches the file before downloading.

[satorux1, 2012/10/17 03:14:27]

ditto.

+  // The downloaded file will be stored at |local_cache_path| location.
+  // Upon completion, invokes |download_action_callback| with results on the
+  // calling thread.
   // If |get_content_callback| is not empty,
   // URLFetcherDelegate::OnURLFetchDownloadData will be called, which will in
   // turn invoke |get_content_callback| on the calling thread.
   virtual void DownloadFile(
       const FilePath& virtual_path,
       const FilePath& local_cache_path,
       const GURL& content_url,
+      const std::string& etag,
       const gdata::DownloadActionCallback& download_action_callback,
       const gdata::GetContentCallback& get_content_callback) = 0;
 
   // Initiates uploading of a document/file.
   virtual void InitiateUpload(
       const gdata::InitiateUploadParams& params,
       const gdata::InitiateUploadCallback& callback) = 0;
 
   // Resumes uploading of a document/file on the calling thread.
   virtual void ResumeUpload(const gdata::ResumeUploadParams& params,
                             const gdata::ResumeUploadCallback& callback) = 0;
 
   // Authorizes a Drive app with the id |app_id| to open the given document.
   // Upon completion, invokes |callback| with results on the calling thread.
   virtual void AuthorizeApp(const GURL& resource_url,
                             const std::string& app_id,
                             const gdata::GetDataCallback& callback) = 0;
 };
 
 }  // namespace drive
 
 #endif  // CHROME_BROWSER_GOOGLE_APIS_DRIVE_SERVICE_INTERFACE_H_