Media Galleries API Picasa: Make PicasaDataProvider handle async PMP and INI parsing robustly.

chrome/browser/media_galleries/fileapi/safe_picasa_albums_indexer.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_SAFE_PICASA_ALBUMS_INDEXER_H_
 #define CHROME_BROWSER_MEDIA_GALLERIES_FILEAPI_SAFE_PICASA_ALBUMS_INDEXER_H_
 
 #include <queue>
 #include <vector>
 
 #include "base/callback.h"
 #include "base/compiler_specific.h"
+#include "base/memory/ref_counted.h"
 #include "base/memory/weak_ptr.h"
 #include "chrome/common/media_galleries/picasa_types.h"
 #include "content/public/browser/utility_process_host_client.h"
 
 namespace base {
 class FilePath;
 }
 
 namespace IPC {
 class Message;
 }
 
 namespace picasa {
 
+extern const char kPicasaINIFilename[];
+
 // SafePicasaAlbumsIndexer indexes the contents of Picasa Albums by parsing the
 // INI files found in Folders. The SafePicasaAlbumsIndexer object is ref-counted
 // and kept alive after Start() is called until the ParserCallback is called.
 // The ParserCallback is guaranteed to be called eventually either when the
 // utility process replies or when it dies.
 class SafePicasaAlbumsIndexer : public content::UtilityProcessHostClient {
  public:
-  typedef base::Callback<void(bool /* success */,
-                              const picasa::AlbumImagesMap&)> DoneCallback;
+  // PicasaDataProvider keeps a reference to the last-dispatched instance of
+  // this class so it can ignore callbacks from 'stale' instances. The callback
+  // also keeps a reference so it doesn't get destroyed prematurely.
+  typedef base::Callback<void(scoped_refptr<SafePicasaAlbumsIndexer>,
+                              bool parse_success,
+                              const picasa::AlbumImagesMap&)>
+      DoneCallback;
 
   SafePicasaAlbumsIndexer(const AlbumMap& albums,
                           const AlbumMap& folders,
                           const DoneCallback& callback);
 
   void Start();
 
  private:
   enum ParserState {
     INITIAL_STATE,
@@ skipping 33 matching lines @@
   // Verifies the messages from the utility process came at the right time.
   // Initialized on the Media Task Runner, but only accessed on the IO thread.
   ParserState parser_state_;
 
   DISALLOW_COPY_AND_ASSIGN(SafePicasaAlbumsIndexer);
 };
 
 }  // namespace picasa
 
 #endif  // CHROME_BROWSER_MEDIA_GALLERIES_FILEAPI_SAFE_PICASA_ALBUMS_INDEXER_H_