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
|
// Copyright 2014 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 COMPONENTS_USER_PREFS_TRACKED_TRACKED_PREFERENCE_HELPER_H_
#define COMPONENTS_USER_PREFS_TRACKED_TRACKED_PREFERENCE_HELPER_H_
#include <stddef.h>
#include <string>
#include "base/macros.h"
#include "components/user_prefs/tracked/pref_hash_filter.h"
#include "components/user_prefs/tracked/pref_hash_store_transaction.h"
// A TrackedPreferenceHelper is a helper class for TrackedPreference which
// handles decision making and reporting for TrackedPreference's
// implementations.
class TrackedPreferenceHelper {
public:
enum ResetAction {
DONT_RESET,
// WANTED_RESET is reported when DO_RESET would have been reported but the
// current |enforcement_level| doesn't allow a reset for the detected state.
WANTED_RESET,
DO_RESET,
};
TrackedPreferenceHelper(const std::string& pref_path,
size_t reporting_id,
size_t reporting_ids_count,
PrefHashFilter::EnforcementLevel enforcement_level,
PrefHashFilter::ValueType value_type);
// Returns a ResetAction stating whether a reset is desired (DO_RESET) or not
// (DONT_RESET) based on observing |value_state|. Can also return WANTED_RESET
// if a reset would have been desired but the current |enforcement_level|
// doesn't allow it.
ResetAction GetAction(PrefHashStoreTransaction::ValueState value_state) const;
// Returns true if the preference value may contain personal information.
bool IsPersonal() const;
// Reports |value_state| via UMA under |reporting_id_|.
// |validation_type_suffix| is appended to the reported histogram's name.
void ReportValidationResult(PrefHashStoreTransaction::ValueState value_state,
base::StringPiece validation_type_suffix) const;
// Reports |reset_action| via UMA under |reporting_id_|.
void ReportAction(ResetAction reset_action) const;
// Reports, via UMA, the |count| of split preference entries that were
// considered invalid in a CHANGED event.
void ReportSplitPreferenceChangedCount(size_t count) const;
private:
const std::string pref_path_;
const size_t reporting_id_;
const size_t reporting_ids_count_;
// Deny setting changes and hash seeding/migration.
const bool enforce_;
const bool personal_;
DISALLOW_COPY_AND_ASSIGN(TrackedPreferenceHelper);
};
#endif // COMPONENTS_USER_PREFS_TRACKED_TRACKED_PREFERENCE_HELPER_H_
|