gdata: Add ability to fetch documents in a particular directory

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 57 matching lines @@
 
   // Authenticates the user by fetching the auth token as
   // needed. |callback| will be run with the error code and the auth
   // token, on the thread this function is run.
   virtual void Authenticate(const AuthStatusCallback& callback) = 0;
 
   // Fetches the document feed from |feed_url| with |start_changestamp|. If this
   // URL is empty, the call will fetch the default root or change document feed.
   // |start_changestamp| specifies the starting point from change feeds only.
   // Value different than 0, it would trigger delta feed fetching.
+  //
   // |search_query| specifies search query to be sent to the server. It will be
   // used only if |start_changestamp| is 0. If empty string is passed,
   // |search_query| is ignored.
+  //
+  // |directory_resource_id| specifies the directory from which documents are
+  // fetched. It will be used only if |start_changestamp| is 0. If empty
+  // string is passed, |directory_resource_id| is ignored.
+  //
   // Upon completion, invokes |callback| with results on the calling thread.
+  // TODO(satorux): Refactor this function: crbug.com/128746
   virtual void GetDocuments(const GURL& feed_url,
                             int start_changestamp,
                             const std::string& search_query,
+                            const std::string& directory_resource_id,
                             const GetDataCallback& callback) = 0;
 
   // 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 GetDataCallback& callback) = 0;
 
   // Deletes a document identified by its 'self' |url| and |etag|.
   // Upon completion, invokes |callback| with results on the calling thread.
   virtual void DeleteDocument(const GURL& document_url,
@@ skipping 81 matching lines @@
   virtual ~DocumentsService();
 
   // DocumentsServiceInterface Overrides
   virtual void Initialize(Profile* profile) OVERRIDE;
   virtual GDataOperationRegistry* operation_registry() const OVERRIDE;
   virtual void CancelAll() OVERRIDE;
   virtual void Authenticate(const AuthStatusCallback& callback) OVERRIDE;
   virtual void GetDocuments(const GURL& feed_url,
                             int start_changestamp,
                             const std::string& search_query,
+                            const std::string& directory_resource_id,
                             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;
@@ skipping 56 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_