Media Galleries API Picasa: Make PicasaFileUtil support album contents.

chrome/browser/media_galleries/fileapi/picasa/picasa_file_util.h

 // Copyright 2013 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_MEDIA_GALLERIES_FILEAPI_PICASA_PICASA_FILE_UTIL_H_
 #define CHROME_BROWSER_MEDIA_GALLERIES_FILEAPI_PICASA_PICASA_FILE_UTIL_H_
 
 #include "base/memory/scoped_ptr.h"
 #include "base/memory/weak_ptr.h"
 #include "chrome/browser/media_galleries/fileapi/native_media_file_util.h"
 
 namespace picasa {
 
 class PicasaDataProvider;
 
 extern const char kPicasaDirAlbums[];
 extern const char kPicasaDirFolders[];
 
+// PicasaFileUtil virtual directory structure example:
+//   - /albums/
+//   - /albums/albumname 2013-08-21/
+//   - /albums/albumname 2013-08-21/imagename.jpg
+//   - /albums/duplicatename 2013-08-21/
+//   - /albums/duplicatename 2013-08-21 (1)/
+//   - /folders/
+//   - /folders/My Pictures 2013-08-21/flower.jpg
+//   - /folders/Photos 2013-08-21/
 class PicasaFileUtil : public chrome::NativeMediaFileUtil {
  public:
   explicit PicasaFileUtil(chrome::MediaPathFilter* media_path_filter);
   virtual ~PicasaFileUtil();
 
  protected:
   // NativeMediaFileUtil overrides.
   virtual void GetFileInfoOnTaskRunnerThread(
       scoped_ptr<fileapi::FileSystemOperationContext> context,
       const fileapi::FileSystemURL& url,
@@ skipping 31 matching lines @@
   virtual PicasaDataProvider* GetDataProvider();
 
   base::WeakPtrFactory<PicasaFileUtil> weak_factory_;
 
   DISALLOW_COPY_AND_ASSIGN(PicasaFileUtil);
 };
 
 }  // namespace picasa
 
 #endif  // CHROME_BROWSER_MEDIA_GALLERIES_FILEAPI_PICASA_PICASA_FILE_UTIL_H_