Home | History | Annotate | Download | only in plugins
      1 // Copyright (c) 2012 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 CHROME_BROWSER_PLUGINS_PLUGIN_PREFS_H_
      6 #define CHROME_BROWSER_PLUGINS_PLUGIN_PREFS_H_
      7 
      8 #include <map>
      9 #include <set>
     10 #include <vector>
     11 
     12 #include "base/basictypes.h"
     13 #include "base/files/file_path.h"
     14 #include "base/prefs/pref_change_registrar.h"
     15 #include "base/prefs/pref_service.h"
     16 #include "base/synchronization/lock.h"
     17 #include "chrome/browser/plugins/plugin_finder.h"
     18 #include "components/keyed_service/content/refcounted_browser_context_keyed_service.h"
     19 
     20 class Profile;
     21 
     22 namespace base {
     23 class ListValue;
     24 }
     25 
     26 namespace content {
     27 struct WebPluginInfo;
     28 }
     29 
     30 // This class stores information about whether a plug-in or a plug-in group is
     31 // enabled or disabled.
     32 // Except where otherwise noted, it can be used on every thread.
     33 class PluginPrefs : public RefcountedBrowserContextKeyedService {
     34  public:
     35   enum PolicyStatus {
     36     NO_POLICY = 0,  // Neither enabled or disabled by policy.
     37     POLICY_ENABLED,
     38     POLICY_DISABLED,
     39   };
     40 
     41   // Returns the instance associated with |profile|, creating it if necessary.
     42   static scoped_refptr<PluginPrefs> GetForProfile(Profile* profile);
     43 
     44   // Usually the PluginPrefs associated with a TestingProfile is NULL.
     45   // This method overrides that for a given TestingProfile, returning the newly
     46   // created PluginPrefs object.
     47   static scoped_refptr<PluginPrefs> GetForTestingProfile(Profile* profile);
     48 
     49   // Creates a new instance. This method should only be used for testing.
     50   PluginPrefs();
     51 
     52   // Associates this instance with |prefs|. This enables or disables
     53   // plugin groups as defined by the user's preferences.
     54   // This method should only be called on the UI thread.
     55   void SetPrefs(PrefService* prefs);
     56 
     57   // Enable or disable a plugin group.
     58   void EnablePluginGroup(bool enable, const base::string16& group_name);
     59 
     60   // Enables or disables a specific plug-in file, if possible.
     61   // If the plug-in state can't be changed (because of a policy for example)
     62   // then enabling/disabling the plug-in is ignored and |callback| is run
     63   // with 'false' passed to it. Otherwise the plug-in state is changed
     64   // and |callback| is run with 'true' passed to it.
     65   void EnablePlugin(bool enable, const base::FilePath& file_path,
     66                     const base::Callback<void(bool)>& callback);
     67 
     68   // Returns whether there is a policy enabling or disabling plug-ins of the
     69   // given name.
     70   PolicyStatus PolicyStatusForPlugin(const base::string16& name) const;
     71 
     72   // Returns whether the plugin is enabled or not.
     73   bool IsPluginEnabled(const content::WebPluginInfo& plugin) const;
     74 
     75   void set_profile(Profile* profile) { profile_ = profile; }
     76 
     77   // RefCountedProfileKeyedBase method override.
     78   virtual void ShutdownOnUIThread() OVERRIDE;
     79 
     80  private:
     81   friend class base::RefCountedThreadSafe<PluginPrefs>;
     82   friend class PluginPrefsTest;
     83 
     84   // PluginState stores a mapping from plugin path to enable/disable state. We
     85   // don't simply use a std::map, because we would like to keep the state of
     86   // some plugins in sync with each other.
     87   class PluginState {
     88    public:
     89     PluginState();
     90     ~PluginState();
     91 
     92     // Returns whether |plugin| is found. If |plugin| cannot be found,
     93     // |*enabled| won't be touched.
     94     bool Get(const base::FilePath& plugin, bool* enabled) const;
     95     void Set(const base::FilePath& plugin, bool enabled);
     96 
     97    private:
     98     base::FilePath ConvertMapKey(const base::FilePath& plugin) const;
     99 
    100     std::map<base::FilePath, bool> state_;
    101   };
    102 
    103   virtual ~PluginPrefs();
    104 
    105   // Called to update one of the policy_xyz patterns below when a
    106   // preference changes.
    107   void UpdatePatternsAndNotify(std::set<base::string16>* patterns,
    108                                const std::string& pref_name);
    109 
    110   // Allows unit tests to directly set enforced plug-in patterns.
    111   void SetPolicyEnforcedPluginPatterns(
    112       const std::set<base::string16>& disabled_patterns,
    113       const std::set<base::string16>& disabled_exception_patterns,
    114       const std::set<base::string16>& enabled_patterns);
    115 
    116   // Callback for after the plugin groups have been loaded.
    117   void EnablePluginGroupInternal(
    118       bool enabled,
    119       const base::string16& group_name,
    120       const std::vector<content::WebPluginInfo>& plugins);
    121   void EnablePluginInternal(
    122       bool enabled,
    123       const base::FilePath& path,
    124       PluginFinder* plugin_finder,
    125       const base::Callback<void(bool)>& callback,
    126       const std::vector<content::WebPluginInfo>& plugins);
    127 
    128   // Called on the UI thread with the plugin data to save the preferences.
    129   void OnUpdatePreferences(const std::vector<content::WebPluginInfo>& plugins);
    130 
    131   // Sends the notification that plugin data has changed.
    132   void NotifyPluginStatusChanged();
    133 
    134   static void ListValueToStringSet(const base::ListValue* src,
    135                                    std::set<base::string16>* dest);
    136 
    137   // Checks if |name| matches any of the patterns in |pattern_set|.
    138   static bool IsStringMatchedInSet(const base::string16& name,
    139                                    const std::set<base::string16>& pattern_set);
    140 
    141   // Guards access to the following data structures.
    142   mutable base::Lock lock_;
    143 
    144   PluginState plugin_state_;
    145   std::map<base::string16, bool> plugin_group_state_;
    146 
    147   std::set<base::string16> policy_disabled_plugin_patterns_;
    148   std::set<base::string16> policy_disabled_plugin_exception_patterns_;
    149   std::set<base::string16> policy_enabled_plugin_patterns_;
    150 
    151   // Weak pointer, owns us. Only used as a notification source.
    152   Profile* profile_;
    153 
    154   // Weak pointer, owned by the profile.
    155   PrefService* prefs_;
    156 
    157   PrefChangeRegistrar registrar_;
    158 
    159   DISALLOW_COPY_AND_ASSIGN(PluginPrefs);
    160 };
    161 
    162 #endif  // CHROME_BROWSER_PLUGINS_PLUGIN_PREFS_H_
    163