| OLD | NEW |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef CHROME_BROWSER_STORAGE_MONITOR_STORAGE_MONITOR_H_ | 5 #ifndef CHROME_BROWSER_STORAGE_MONITOR_STORAGE_MONITOR_H_ |
| 6 #define CHROME_BROWSER_STORAGE_MONITOR_STORAGE_MONITOR_H_ | 6 #define CHROME_BROWSER_STORAGE_MONITOR_STORAGE_MONITOR_H_ |
| 7 | 7 |
| 8 #include <map> | 8 #include <map> |
| 9 #include <string> | 9 #include <string> |
| 10 #include <vector> | 10 #include <vector> |
| (...skipping 18 matching lines...) Expand all Loading... |
| 29 class MediaTransferProtocolManager; | 29 class MediaTransferProtocolManager; |
| 30 } | 30 } |
| 31 | 31 |
| 32 // Base class for platform-specific instances watching for removable storage | 32 // Base class for platform-specific instances watching for removable storage |
| 33 // attachments/detachments. | 33 // attachments/detachments. |
| 34 // Lifecycle contracts: This class is created in the browser process | 34 // Lifecycle contracts: This class is created in the browser process |
| 35 // before the profile is initialized, so listeners can be | 35 // before the profile is initialized, so listeners can be |
| 36 // created during profile construction. The platform-specific initialization, | 36 // created during profile construction. The platform-specific initialization, |
| 37 // which can lead to calling registered listeners with notifications of | 37 // which can lead to calling registered listeners with notifications of |
| 38 // attached volumes, are done lazily at first use through the async | 38 // attached volumes, are done lazily at first use through the async |
| 39 // |Initialize()| method. That must be done before any of the registered | 39 // |EnsureInitialized()| method. That must be done before any of the registered |
| 40 // listeners will receive updates or calls to other API methods return | 40 // listeners will receive updates or calls to other API methods return |
| 41 // meaningful results. | 41 // meaningful results. |
| 42 // A post-initialization |GetAttachedStorage()| call coupled with a | 42 // A post-initialization |GetAttachedStorage()| call coupled with a |
| 43 // registered listener will receive a complete set, albeit potentially with | 43 // registered listener will receive a complete set, albeit potentially with |
| 44 // duplicates. This is because there's no tracking between when listeners were | 44 // duplicates. This is because there's no tracking between when listeners were |
| 45 // registered and the state of initialization, and the fact that platforms | 45 // registered and the state of initialization, and the fact that platforms |
| 46 // behave differently in how these notifications are provided. | 46 // behave differently in how these notifications are provided. |
| 47 class StorageMonitor { | 47 class StorageMonitor { |
| 48 public: | 48 public: |
| 49 // This interface is provided to generators of storage notifications. | 49 // This interface is provided to generators of storage notifications. |
| (...skipping 19 matching lines...) Expand all Loading... |
| 69 static StorageMonitor* Create(); | 69 static StorageMonitor* Create(); |
| 70 | 70 |
| 71 // Returns a pointer to an object owned by BrowserProcess, with lifetime | 71 // Returns a pointer to an object owned by BrowserProcess, with lifetime |
| 72 // starting before main message loop start, and ending after main message loop | 72 // starting before main message loop start, and ending after main message loop |
| 73 // shutdown. Called outside it's lifetime (or with no browser process), | 73 // shutdown. Called outside it's lifetime (or with no browser process), |
| 74 // returns NULL. | 74 // returns NULL. |
| 75 static StorageMonitor* GetInstance(); | 75 static StorageMonitor* GetInstance(); |
| 76 | 76 |
| 77 virtual ~StorageMonitor(); | 77 virtual ~StorageMonitor(); |
| 78 | 78 |
| 79 // Ensures that the storage monitor is initialized. The provided callback, If | 79 // Ensures that the storage monitor is initialized. The provided callback, if |
| 80 // non-null, will be called when initialization is complete. If initialization | 80 // non-null, will be called when initialization is complete. If initialization |
| 81 // has already completed, this callback will be invoked within the calling | 81 // has already completed, this callback will be invoked within the calling |
| 82 // stack. Before the callback is run, calls to |GetAllAvailableStorages| and | 82 // stack. Before the callback is run, calls to |GetAllAvailableStorages| and |
| 83 // |GetStorageInfoForPath| may not return the correct results. In addition, | 83 // |GetStorageInfoForPath| may not return the correct results. In addition, |
| 84 // registered observers will not be notified on device attachment/detachment. | 84 // registered observers will not be notified on device attachment/detachment. |
| 85 // Should be invoked on the UI thread; callbacks will be run on the UI thread. | 85 // Should be invoked on the UI thread; callbacks will be run on the UI thread. |
| 86 void EnsureInitialized(base::Closure callback); | 86 void EnsureInitialized(base::Closure callback); |
| 87 | 87 |
| 88 // Return true if the storage monitor has already been initialized. | 88 // Return true if the storage monitor has already been initialized. |
| 89 bool IsInitialized(); | 89 bool IsInitialized() const; |
| 90 | 90 |
| 91 // Finds the device that contains |path| and populates |device_info|. | 91 // Finds the device that contains |path| and populates |device_info|. |
| 92 // Should be able to handle any path on the local system, not just removable | 92 // Should be able to handle any path on the local system, not just removable |
| 93 // storage. Returns false if unable to find the device. | 93 // storage. Returns false if unable to find the device. |
| 94 virtual bool GetStorageInfoForPath( | 94 virtual bool GetStorageInfoForPath( |
| 95 const base::FilePath& path, | 95 const base::FilePath& path, |
| 96 StorageInfo* device_info) const = 0; | 96 StorageInfo* device_info) const = 0; |
| 97 | 97 |
| 98 // TODO(gbillock): make this either unnecessary (implementation-specific) or | 98 // TODO(gbillock): make this either unnecessary (implementation-specific) or |
| 99 // platform-independent. | 99 // platform-independent. |
| (...skipping 71 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 171 // For manipulating storage_map_ structure. | 171 // For manipulating storage_map_ structure. |
| 172 mutable base::Lock storage_lock_; | 172 mutable base::Lock storage_lock_; |
| 173 | 173 |
| 174 // Map of all known storage devices,including fixed and removable storages. | 174 // Map of all known storage devices,including fixed and removable storages. |
| 175 StorageMap storage_map_; | 175 StorageMap storage_map_; |
| 176 | 176 |
| 177 scoped_ptr<TransientDeviceIds> transient_device_ids_; | 177 scoped_ptr<TransientDeviceIds> transient_device_ids_; |
| 178 }; | 178 }; |
| 179 | 179 |
| 180 #endif // CHROME_BROWSER_STORAGE_MONITOR_STORAGE_MONITOR_H_ | 180 #endif // CHROME_BROWSER_STORAGE_MONITOR_STORAGE_MONITOR_H_ |
| OLD | NEW |