Add support for persistent file access in apps.

apps/saved_files_service.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 APPS_SAVED_FILES_SERVICE_H_
+#define APPS_SAVED_FILES_SERVICE_H_
+
+#include <map>
+#include <set>
+#include <string>
+#include <vector>
+
+#include "base/files/file_path.h"
+#include "base/gtest_prod_util.h"
+#include "base/stl_util.h"
+#include "chrome/browser/profiles/profile_keyed_service.h"
+#include "content/public/browser/notification_observer.h"
+#include "content/public/browser/notification_registrar.h"
+
+class Profile;
+class SavedFilesServiceUnitTest;
+FORWARD_DECLARE_TEST(SavedFilesServiceUnitTest, EvictionTest);
+FORWARD_DECLARE_TEST(SavedFilesServiceUnitTest, SequenceNumberCompactionTest);
+FORWARD_DECLARE_TEST(SavedFilesServiceUnitTest,
+                     SequenceNumberCompactionFirstAboveOneTest);
+
+namespace extensions {
+class Extension;
+}  // namespace extensions
+
+namespace apps {
+
+// Represents a file entry that a user has given an app permission to
+// access. Intended to be persisted to disk (in the Preferences file), so should
+// remain serializable.
+struct SavedFileEntry {
+  SavedFileEntry()
+      : writable(false),
+        sequence_number(0) {}
+
+  SavedFileEntry(const std::string& id,
+                 const base::FilePath& path,
+                 bool writable,
+                 int sequence_number)
+      : id(id),
+        path(path),
+        writable(writable),
+        sequence_number(sequence_number) {}
+
+  // The opaque id of this file entry.
+  std::string id;
+  // The path to a file entry that an extension had permission to access.
+  base::FilePath path;
+  // Whether or not an extension had write access to a file entry.
+  bool writable;
+  // The sequence number in the LRU of the file entry.
+  int sequence_number;
+};
+
+class SavedFilesService : public ProfileKeyedService,
+                          public content::NotificationObserver {
+ public:
+  explicit SavedFilesService(Profile* profile);
+  virtual ~SavedFilesService();
+
+  static SavedFilesService* Get(Profile* profile);
+
+  // Adds a file entry to be retained, but does not add it to the queue of
+  // entries to be retained between app runs.
+  void RetainFileEntry(const std::string& extension_id,
+                       const std::string& id,
+                       const base::FilePath& file_path,
+                       bool writable);
+
+  // Moves the file entry with the specified |id| to the front of the LRU,
+  // evicting the least recently used entry if the queue is full and the entry
+  // specified by |id| is not already in the queue.
+  void MoveEntryToFrontOfQueue(const std::string& extension_id,
+                               const std::string& id);
+
+  // Returns whether the file entry with the given |id| is retained. This does
+  // not consider whether or not the file entry is in the queue.
+  bool IsRetained(const std::string& extension_id, const std::string& id);
+
+  // Stores the file entry with the specified |id| in |out| and returns true if
+  // the file entry is retained or returns false.
+  bool GetFileEntry(const std::string& extension_id,
+                    const std::string& id,
+                    SavedFileEntry* out);
+
+  // Returns all retained file entries.
+  std::vector<SavedFileEntry> GetAllFileEntries(
+      const std::string& extension_id);
+
+  // Flushes retained entries that have been evicted from the queue and clears
+  // the queue if the app does not have the fileSystem.retainFiles permission.
+  void FlushRetainedEntries(const extensions::Extension* extension);
+
+ private:
+  FRIEND_TEST_ALL_PREFIXES(::SavedFilesServiceUnitTest, EvictionTest);
+  FRIEND_TEST_ALL_PREFIXES(::SavedFilesServiceUnitTest,
+                           SequenceNumberCompactionTest);
+  FRIEND_TEST_ALL_PREFIXES(::SavedFilesServiceUnitTest,
+                           SequenceNumberCompactionFirstAboveOneTest);
+  friend class ::SavedFilesServiceUnitTest;
+
+  class SavedFiles;
+
+  // content::NotificationObserver.
+  virtual void Observe(int type,
+                       const content::NotificationSource& source,
+                       const content::NotificationDetails& details) OVERRIDE;
+
+  SavedFiles* GetOrInsert(const std::string& extension_id);
+
+  static void SetMaxSequenceNumberForTest(int max_value);
+  static void ClearMaxSequenceNumberForTest();
+  static void SetLruSizeForTest(int size);
+  static void ClearLruSizeForTest();
+
+  std::map<std::string, SavedFiles*> extension_id_to_saved_files_;
+  STLValueDeleter<std::map<std::string, SavedFiles*> >
+      extension_id_to_saved_files_deleter_;
+  content::NotificationRegistrar registrar_;
+  Profile* profile_;

[Matt Giuca, 2013/05/20 05:02:03]

Can this be a const reference?

+
+  DISALLOW_COPY_AND_ASSIGN(SavedFilesService);
+};
+
+}  // namespace apps
+
+#endif  // APPS_SAVED_FILES_SERVICE_H_