OLD | NEW |
---|---|
1 // Copyright 2013 The Chromium Authors. All rights reserved. | 1 // Copyright 2013 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_PROFILE_RESETTER_AUTOMATIC_PROFILE_RESETTER_H_ | 5 #ifndef CHROME_BROWSER_PROFILE_RESETTER_AUTOMATIC_PROFILE_RESETTER_H_ |
6 #define CHROME_BROWSER_PROFILE_RESETTER_AUTOMATIC_PROFILE_RESETTER_H_ | 6 #define CHROME_BROWSER_PROFILE_RESETTER_AUTOMATIC_PROFILE_RESETTER_H_ |
7 | 7 |
8 #include <string> | 8 #include <string> |
9 | 9 |
10 #include "base/basictypes.h" | 10 #include "base/basictypes.h" |
11 #include "base/memory/ref_counted.h" | |
11 #include "base/memory/scoped_ptr.h" | 12 #include "base/memory/scoped_ptr.h" |
12 #include "base/memory/weak_ptr.h" | 13 #include "base/memory/weak_ptr.h" |
13 #include "base/strings/string_piece.h" | 14 #include "base/strings/string_piece.h" |
14 #include "base/values.h" | 15 #include "base/task_runner.h" |
15 #include "chrome/browser/profile_resetter/automatic_profile_resetter_mementos.h" | 16 #include "chrome/browser/profile_resetter/automatic_profile_resetter_mementos.h" |
16 #include "components/browser_context_keyed_service/browser_context_keyed_service .h" | 17 #include "components/browser_context_keyed_service/browser_context_keyed_service .h" |
17 | 18 |
19 class AutomaticProfileResetterDelegate; | |
18 class Profile; | 20 class Profile; |
19 | 21 |
20 // Defines the interface for the delegate that will actually show the prompt | 22 namespace base { |
21 // and/or report statistics on behalf of the AutomaticProfileResetter. | 23 class DictionaryValue; |
22 // The primary reason for this separation is to facilitate unit testing. | 24 class ListValue; |
23 class AutomaticProfileResetterDelegate { | 25 } |
24 public: | |
25 virtual ~AutomaticProfileResetterDelegate() {} | |
26 | |
27 // Triggers showing the one-time profile settings reset prompt. | |
28 virtual void ShowPrompt() = 0; | |
29 | |
30 // Reports the given metrics through UMA. | |
31 virtual void ReportStatistics(uint32 satisfied_criteria_mask, | |
32 uint32 combined_status_mask) = 0; | |
33 }; | |
34 | 26 |
35 // This service becomes busy shortly after start-up, and is responsible for | 27 // This service becomes busy shortly after start-up, and is responsible for |
36 // evaluating if the criteria for showing the one-time profile reset prompt | 28 // evaluating if the criteria for showing the one-time profile reset prompt |
37 // are satisfied, and will potentially trigger the prompt, but only a single | 29 // are satisfied, and will potentially trigger the prompt, but only a single |
38 // time during the lifetime of a profile on disk (this is achieved by storing | 30 // time during the lifetime of a profile on disk (this is achieved by storing |
39 // "mementos"). All methods in this class shall be called on the UI thread. | 31 // "memento"-s, see "automatic_profile_resetter_mementos.h" for details). |
32 // All methods in this class shall be called on the UI thread. | |
40 class AutomaticProfileResetter : public BrowserContextKeyedService { | 33 class AutomaticProfileResetter : public BrowserContextKeyedService { |
41 public: | 34 public: |
35 struct EvaluationResults; | |
36 | |
37 // Number of bits, and maximum value (exclusive) for the mask whose bits | |
38 // indicate which of reset criteria were satisfied. | |
39 static const size_t kSatisfiedCriteriaMaskNumberOfBits; | |
40 static const uint32 kSatisfiedCriteriaMaskMaximumValue; | |
41 | |
42 // Number of bits, and maximum value (exclusive) for the mask whose bits | |
43 // indicate if any of reset criteria were satisfied, and which of the mementos | |
44 // were already present. | |
45 static const size_t kCombinedStatusMaskNumberOfBits; | |
46 static const uint32 kCombinedStatusMaskMaximumValue; | |
47 | |
42 explicit AutomaticProfileResetter(Profile* profile); | 48 explicit AutomaticProfileResetter(Profile* profile); |
43 virtual ~AutomaticProfileResetter(); | 49 virtual ~AutomaticProfileResetter(); |
44 | 50 |
45 // Initializes the service, and sets up the asynchronous evaluation flow. | 51 // Fires up the service by unleashing the asynchronous evaluation flow, unless |
46 // Called by AutomaticProfileResetterFactory. | 52 // the service has been already disabled in Initialize() or there is no |
47 void Initialize(); | 53 // |program_| to run (in which case the service also gets disabled). |
54 // Called by the AutomaticProfileResetterFactory. | |
55 void Activate(); | |
48 | 56 |
49 // Should be called after Initialize(). | 57 // Should be called before Activate(). |
50 void SetHashSeedForTesting(const base::StringPiece& hash_seed); | 58 void SetHashSeedForTesting(const base::StringPiece& hash_seed); |
51 | 59 |
52 // Should be called after Initialize(). | 60 // Should be called before Activate(). |
53 void SetProgramForTesting(const base::StringPiece& program); | 61 void SetProgramForTesting(const base::StringPiece& program); |
54 | 62 |
55 // Should be called after Initialize(). Takes ownership. | 63 // Should be called before Activate(). |
56 void SetDelegateForTesting(AutomaticProfileResetterDelegate* delegate); | 64 void SetDelegateForTesting( |
65 scoped_ptr<AutomaticProfileResetterDelegate> delegate); | |
66 | |
67 // Should be called before Activate(). Sets the task runner to be used to post | |
68 // task |PrepareEvaluationFlow| in a delayed manner. | |
69 void SetTaskRunnerForWaitingForTesting( | |
70 const scoped_refptr<base::TaskRunner>& task_runner); | |
57 | 71 |
58 private: | 72 private: |
59 struct EvaluationResults; | |
60 | |
61 enum State { | 73 enum State { |
62 STATE_UNINITIALIZED, | 74 STATE_UNINITIALIZED, |
75 STATE_INITIALIZED, | |
63 STATE_DISABLED, | 76 STATE_DISABLED, |
77 STATE_WAITING_ON_DEPENDENCIES, | |
64 STATE_READY, | 78 STATE_READY, |
65 STATE_WORKING, | 79 STATE_WORKING, |
66 STATE_DONE | 80 STATE_DONE |
67 }; | 81 }; |
68 | 82 |
69 // Returns whether or not a dry-run shall be performed. | 83 // Initializes the service if it is enabled in the field trial, otherwise, |
70 bool ShouldPerformDryRun() const; | 84 // skips the initialization steps and also permanently disables the service. |
85 void Initialize(); | |
71 | 86 |
72 // Returns whether or not a live-run shall be performed. | 87 // Prepares the asynchronous evaluation flow by requesting services that it |
73 bool ShouldPerformLiveRun() const; | 88 // depends on to make themselves ready. |
89 void PrepareEvaluationFlow(); | |
90 | |
91 // Called back by |resetter_delegate_| when the template URL service is ready. | |
92 void OnTemplateURLServiceIsLoaded(); | |
93 | |
94 // Called back by |resetter_delegate_| when the loaded modules have been | |
95 // enumerated. | |
96 void OnLoadedModulesAreEnumerated(); | |
97 | |
98 // Invoked by the above two methods. Kicks off the actual evaluation flow. | |
99 void OnDependencyIsReady(); | |
74 | 100 |
75 // Begins the asynchronous evaluation flow, which will assess whether the | 101 // Begins the asynchronous evaluation flow, which will assess whether the |
76 // criteria for showing the reset prompt are met, whether we have already | 102 // criteria for showing the reset prompt are met, whether we have already |
77 // shown the prompt, and, in the end, will potentially trigger the prompt. | 103 // shown the prompt, and, in the end, will potentially trigger the prompt. |
78 void BeginEvaluationFlow(); | 104 void BeginEvaluationFlow(); |
79 | 105 |
80 // Called back by |memento_in_file_| once it has finished reading the value of | 106 // Called back by |memento_in_file_| once it has finished reading the value of |
81 // the file-based memento. Continues the evaluation flow with collecting state | 107 // the file-based memento. Continues the evaluation flow with collecting state |
82 // information and assembling it as the input for the evaluator program. | 108 // information and assembling it as the input for the evaluator program. |
83 void ContinueWithEvaluationFlow(const std::string& memento_value_in_file); | 109 void ContinueWithEvaluationFlow(const std::string& memento_value_in_file); |
84 | 110 |
85 // Prepare the input of the evaluator program. This will contain all the state | 111 // Prepare the input of the evaluator program. This will contain all the state |
86 // information required to assess whether or not the conditions for showing | 112 // information required to assess whether or not the conditions for showing |
87 // the reset prompt are met. | 113 // the reset prompt are met. |
88 scoped_ptr<base::DictionaryValue> BuildEvaluatorProgramInput( | 114 scoped_ptr<base::DictionaryValue> BuildEvaluatorProgramInput( |
vasilii
2013/10/17 10:57:57
Order of declaration should math the order of defi
engedy
2013/10/17 15:13:47
Done.
| |
89 const std::string& memento_value_in_file); | 115 const std::string& memento_value_in_file); |
90 | 116 |
91 // Performs the bulk of the work. Invokes the interpreter to run the |program| | |
92 // that will evaluate whether the conditions are met for showing the reset | |
93 // prompt. The program will make this decision based on the state information | |
94 // contained in |input| in the form of key-value pairs. The program will only | |
95 // see hashed keys and values that are produced using |hash_seed| as a key. | |
96 static scoped_ptr<EvaluationResults> EvaluateConditionsOnWorkerPoolThread( | |
97 const base::StringPiece& hash_seed, | |
98 const base::StringPiece& program, | |
99 scoped_ptr<base::DictionaryValue> program_input); | |
100 | |
101 // Called back when EvaluateConditionsOnWorkerPoolThread completes executing | 117 // Called back when EvaluateConditionsOnWorkerPoolThread completes executing |
102 // the program with |results|. Finishes the evaluation flow, and, based on the | 118 // the program with |results|. Finishes the evaluation flow, and, based on the |
103 // result, will potentially show the reset prompt. | 119 // result, will potentially show the reset prompt. |
104 void FinishEvaluationFlow(scoped_ptr<EvaluationResults> results); | 120 void FinishEvaluationFlow(scoped_ptr<EvaluationResults> results); |
105 | 121 |
106 // BrowserContextKeyedService overrides: | 122 // Reports the given metrics through UMA. Virtual, so it can be mocked out in |
123 // tests to verify that the correct value are being reported. | |
124 virtual void ReportStatistics(uint32 satisfied_criteria_mask, | |
125 uint32 combined_status_mask); | |
126 | |
127 // BrowserContextKeyedService: | |
107 virtual void Shutdown() OVERRIDE; | 128 virtual void Shutdown() OVERRIDE; |
108 | 129 |
109 Profile* profile_; | 130 Profile* profile_; |
110 | 131 |
111 State state_; | 132 State state_; |
133 bool enumeration_of_loaded_modules_ready_; | |
134 bool template_url_service_ready_; | |
112 | 135 |
113 base::StringPiece hash_seed_; | 136 base::StringPiece hash_seed_; |
114 base::StringPiece program_; | 137 base::StringPiece program_; |
115 | 138 |
116 PreferenceHostedPromptMemento memento_in_prefs_; | 139 PreferenceHostedPromptMemento memento_in_prefs_; |
117 LocalStateHostedPromptMemento memento_in_local_state_; | 140 LocalStateHostedPromptMemento memento_in_local_state_; |
118 FileHostedPromptMemento memento_in_file_; | 141 FileHostedPromptMemento memento_in_file_; |
119 | 142 |
120 scoped_ptr<AutomaticProfileResetterDelegate> delegate_; | 143 scoped_ptr<AutomaticProfileResetterDelegate> delegate_; |
144 scoped_refptr<base::TaskRunner> task_runner_for_waiting_; | |
121 | 145 |
122 base::WeakPtrFactory<AutomaticProfileResetter> weak_ptr_factory_; | 146 base::WeakPtrFactory<AutomaticProfileResetter> weak_ptr_factory_; |
123 | 147 |
124 DISALLOW_COPY_AND_ASSIGN(AutomaticProfileResetter); | 148 DISALLOW_COPY_AND_ASSIGN(AutomaticProfileResetter); |
125 }; | 149 }; |
126 | 150 |
127 #endif // CHROME_BROWSER_PROFILE_RESETTER_AUTOMATIC_PROFILE_RESETTER_H_ | 151 #endif // CHROME_BROWSER_PROFILE_RESETTER_AUTOMATIC_PROFILE_RESETTER_H_ |
OLD | NEW |