summaryrefslogtreecommitdiffstats
path: root/chrome/browser/extensions/extension_pref_store.h
blob: 6b597cfa086b840a8d69bb633292ead46ec82c97 (plain)
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
96
97
98
99
100
101
// Copyright (c) 2010 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 CHROME_BROWSER_EXTENSIONS_EXTENSION_PREF_STORE_H_
#define CHROME_BROWSER_EXTENSIONS_EXTENSION_PREF_STORE_H_
#pragma once

#include <list>
#include <map>
#include <string>
#include <vector>

#include "base/basictypes.h"
#include "base/scoped_ptr.h"
#include "base/stl_util-inl.h"
#include "chrome/common/pref_store.h"

class DictionaryValue;
class PrefService;
class Value;

// This PrefStore keeps track of preferences set by extensions: for example,
// proxy settings. A stack of relevant extension IDs is stored in order of
// their addition to this PrefStore. For each preference, the last-added
// enabled extension that tries to set it overrules any others.
class ExtensionPrefStore : public PrefStore {
 public:
  explicit ExtensionPrefStore(PrefService* pref_service);
  virtual ~ExtensionPrefStore();

  // The PrefService creates the ExtensionPrefStore, so we need to be able to
  // defer setting the PrefService here until after construction.
  void SetPrefService(PrefService* pref_service) {
    pref_service_ = pref_service;
  }

  // Begins tracking the preference and value an extension wishes to set. This
  // must be called each time an extension API tries to set a preference.
  // The ExtensionPrefStore will take ownership of the |pref_value|.
  virtual void InstallExtensionPref(std::string extension_id,
                                    const wchar_t* pref_path,
                                    Value* pref_value);

  // Removes an extension and all its preference settings from this PrefStore.
  // This must be called when an extension is uninstalled or disabled.
  virtual void UninstallExtension(std::string extension_id);

  // PrefStore methods:
  virtual DictionaryValue* prefs() { return prefs_.get(); }

  virtual PrefReadError ReadPrefs() { return PREF_READ_ERROR_NONE; }

 protected:
  // Returns a vector of the extension IDs in the extension_stack_.
  // This should only be accessed by subclasses for unit-testing.
  void GetExtensionIDs(std::vector<std::string>* result);

 private:
  // The pref service referring to this pref store. Weak reference.
  PrefService* pref_service_;

  // Maps preference paths to their values.
  typedef std::map<const wchar_t*, Value*> PrefValueMap;

  // Applies the highest-priority extension's setting for the given preference
  // path to the |prefs_| store, or clears the setting there if no extensions
  // wish to control it.
  void UpdateOnePref(const wchar_t* path);

  // Updates each preference in the key set of the |pref_values| map.
  void UpdatePrefs(const PrefValueMap* pref_values);

  // A cache of the highest-priority values for each preference that any
  // extension is controlling, for quick read access. Owns the stored values.
  scoped_ptr<DictionaryValue> prefs_;

  // Associates an extension ID with the prefs it sets. Owns the pref values.
  struct ExtensionPrefs {
    ExtensionPrefs(std::string id, PrefValueMap* values)
        : extension_id(id),
          pref_values(values) {}

    ~ExtensionPrefs() {
      STLDeleteValues(pref_values);
      delete pref_values;
    }

    std::string extension_id;
    PrefValueMap* pref_values;
  };

  // A pseudo-stack of extensions and their preferences. Extensions are always
  // added to the head, but may be removed from the middle.
  typedef std::list<ExtensionPrefs*> ExtensionStack;
  ExtensionStack extension_stack_;

  DISALLOW_COPY_AND_ASSIGN(ExtensionPrefStore);
};

#endif  // CHROME_BROWSER_EXTENSIONS_EXTENSION_PREF_STORE_H_