| OLD | NEW |
| (Empty) |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. | |
| 2 // Use of this source code is governed by a BSD-style license that can be | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef ATHENA_RESOURCE_MANAGER_PUBLIC_RESOURCE_MANAGER_H_ | |
| 6 #define ATHENA_RESOURCE_MANAGER_PUBLIC_RESOURCE_MANAGER_H_ | |
| 7 | |
| 8 #include "athena/athena_export.h" | |
| 9 #include "base/basictypes.h" | |
| 10 | |
| 11 namespace athena { | |
| 12 | |
| 13 // The resource manager is monitoring activity changes, low memory conditions | |
| 14 // and other events to control the activity state (pre-/un-/re-/loading them) | |
| 15 // to keep enough memory free that no jank/lag will show when new applications | |
| 16 // are loaded and / or a navigation between applications takes place. | |
| 17 class ATHENA_EXPORT ResourceManager { | |
| 18 public: | |
| 19 // The reported memory pressure. Note: The value is intentionally abstracted | |
| 20 // since the real amount of free memory is only estimated (due to e.g. zram). | |
| 21 // Note: The bigger the index of the pressure level, the more resources are | |
| 22 // in use. | |
| 23 enum MemoryPressure { | |
| 24 MEMORY_PRESSURE_UNKNOWN = 0, // The memory pressure cannot be determined. | |
| 25 MEMORY_PRESSURE_LOW, // Single call if fill level is below 50%. | |
| 26 MEMORY_PRESSURE_MODERATE, // Polled for fill level of ~50 .. 75%. | |
| 27 MEMORY_PRESSURE_HIGH, // Polled for fill level of ~75% .. 90%. | |
| 28 MEMORY_PRESSURE_CRITICAL, // Polled for fill level of above ~90%. | |
| 29 }; | |
| 30 | |
| 31 // Creates the instance handling the resources. | |
| 32 static void Create(); | |
| 33 static ResourceManager* Get(); | |
| 34 static void Shutdown(); | |
| 35 | |
| 36 ResourceManager(); | |
| 37 virtual ~ResourceManager(); | |
| 38 | |
| 39 // Unit tests can simulate MemoryPressure changes with this call. | |
| 40 // Note: Even though the default unit test ResourceManagerDelegte | |
| 41 // implementation ensures that the MemoryPressure event will not go off, | |
| 42 // this call will also explicitly stop the MemoryPressureNotifier. | |
| 43 virtual void SetMemoryPressureAndStopMonitoring( | |
| 44 ResourceManager::MemoryPressure pressure) = 0; | |
| 45 | |
| 46 // Resource management calls require time to show effect (until memory | |
| 47 // gets actually released). This function lets override the time limiter | |
| 48 // between two calls to allow for more/less aggressive timeouts. | |
| 49 // By calling this function, the next call to the Resource manager will be | |
| 50 // executed immediately. | |
| 51 virtual void SetWaitTimeBetweenResourceManageCalls(int time_in_ms) = 0; | |
| 52 | |
| 53 // Suspend the resource manager temporarily if |pause| is set. This can be | |
| 54 // called before e.g. re-arranging the order of activities. Once called with | |
| 55 // |pause| == false any queued operations will be performed and the resource | |
| 56 // manager will continue its work. | |
| 57 virtual void Pause(bool pause) = 0; | |
| 58 | |
| 59 private: | |
| 60 DISALLOW_COPY_AND_ASSIGN(ResourceManager); | |
| 61 }; | |
| 62 | |
| 63 // Use this scoped object to pause/restart the resource manager. | |
| 64 class ScopedPauseResourceManager { | |
| 65 public: | |
| 66 ScopedPauseResourceManager() { | |
| 67 ResourceManager::Get()->Pause(true); | |
| 68 } | |
| 69 ~ScopedPauseResourceManager() { | |
| 70 ResourceManager::Get()->Pause(false); | |
| 71 } | |
| 72 private: | |
| 73 DISALLOW_COPY_AND_ASSIGN(ScopedPauseResourceManager); | |
| 74 }; | |
| 75 | |
| 76 } // namespace athena | |
| 77 | |
| 78 #endif // ATHENA_RESOURCE_MANAGER_PUBLIC_RESOURCE_MANAGER_H_ | |
| OLD | NEW |