1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
// 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.
// MemoryPressure provides static APIs for handling memory pressure on
// platforms that have such signals, such as Android and ChromeOS.
// The app will try to discard buffers that aren't deemed essential (individual
// modules will implement their own policy).
#ifndef BASE_MEMORY_MEMORY_PRESSURE_LISTENER_H_
#define BASE_MEMORY_MEMORY_PRESSURE_LISTENER_H_
#include "base/base_export.h"
#include "base/callback.h"
#include "base/macros.h"
namespace base {
// To start listening, create a new instance, passing a callback to a
// function that takes a MemoryPressureLevel parameter. To stop listening,
// simply delete the listener object. The implementation guarantees
// that the callback will always be called on the thread that created
// the listener.
// Note that even on the same thread, the callback is not guaranteed to be
// called synchronously within the system memory pressure broadcast.
// Please see notes in MemoryPressureLevel enum below: some levels are
// absolutely critical, and if not enough memory is returned to the system,
// it'll potentially kill the app, and then later the app will have to be
// cold-started.
//
// Example:
//
// void OnMemoryPressure(MemoryPressureLevel memory_pressure_level) {
// ...
// }
//
// // Start listening.
// MemoryPressureListener* my_listener =
// new MemoryPressureListener(base::Bind(&OnMemoryPressure));
//
// ...
//
// // Stop listening.
// delete my_listener;
//
class BASE_EXPORT MemoryPressureListener {
public:
// A Java counterpart will be generated for this enum.
// GENERATED_JAVA_ENUM_PACKAGE: org.chromium.base
enum MemoryPressureLevel {
// No problems, there is enough memory to use. This event is not sent via
// callback, but the enum is used in other places to find out the current
// state of the system.
MEMORY_PRESSURE_LEVEL_NONE = -1,
// Modules are advised to free buffers that are cheap to re-allocate and not
// immediately needed.
MEMORY_PRESSURE_LEVEL_MODERATE = 0,
// At this level, modules are advised to free all possible memory. The
// alternative is to be killed by the system, which means all memory will
// have to be re-created, plus the cost of a cold start.
MEMORY_PRESSURE_LEVEL_CRITICAL = 2,
};
typedef base::Callback<void(MemoryPressureLevel)> MemoryPressureCallback;
explicit MemoryPressureListener(
const MemoryPressureCallback& memory_pressure_callback);
~MemoryPressureListener();
// Intended for use by the platform specific implementation.
static void NotifyMemoryPressure(MemoryPressureLevel memory_pressure_level);
// These methods should not be used anywhere else but in memory measurement
// code, where they are intended to maintain stable conditions across
// measurements.
static bool AreNotificationsSuppressed();
static void SetNotificationsSuppressed(bool suppressed);
static void SimulatePressureNotification(
MemoryPressureLevel memory_pressure_level);
private:
void Notify(MemoryPressureLevel memory_pressure_level);
static void DoNotifyMemoryPressure(MemoryPressureLevel memory_pressure_level);
MemoryPressureCallback callback_;
DISALLOW_COPY_AND_ASSIGN(MemoryPressureListener);
};
} // namespace base
#endif // BASE_MEMORY_MEMORY_PRESSURE_LISTENER_H_
|
