Add LegacyContentSettingsProvider Interface.

chrome/browser/content_settings/content_settings_provider.h

 // Copyright (c) 2011 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.
 
 // Interface for objects providing content setting rules.
 
 #ifndef CHROME_BROWSER_CONTENT_SETTINGS_CONTENT_SETTINGS_PROVIDER_H_
 #define CHROME_BROWSER_CONTENT_SETTINGS_CONTENT_SETTINGS_PROVIDER_H_
 #pragma once
 
+#include <string>
+#include <utility>
+#include <vector>
+
+#include "chrome/browser/content_settings/content_settings_pattern.h"
 #include "chrome/common/content_settings.h"
 
+class GURL;
+
 class DefaultContentSettingsProvider {
  public:
   virtual ~DefaultContentSettingsProvider() {}
 
   // True if this provider can provide a default setting for the |content_type|.
   virtual bool CanProvideDefaultSetting(
       ContentSettingsType content_type) const = 0;
 
   // Returns the default content setting this provider has for the given
   // |content_type|, or CONTENT_SETTING_DEFAULT if nothing be provided for this
   // type.
   virtual ContentSetting ProvideDefaultSetting(
       ContentSettingsType content_type) const = 0;
 
   // Notifies the provider that the host content settings map would like to
   // update the default setting for the given |content_type|. The provider may
   // ignore this.
   virtual void UpdateDefaultSetting(ContentSettingsType content_type,
                                     ContentSetting setting) = 0;
 
   // Resets the state of the provider to the default.
   virtual void ResetToDefaults() = 0;
 
   // True if the default setting for the |content_type| is policy managed, i.e.,
   // there shouldn't be any UI shown to modify this setting.
   virtual bool DefaultSettingIsManaged(
       ContentSettingsType content_type) const = 0;
 };
 
+class LegacyContentSettingsProvider {
+ public:
+  // LEGACY ContentSettingsProvider interface
+  typedef std::pair<ContentSettingsPattern, ContentSetting> PatternSettingPair;
+  typedef std::vector<PatternSettingPair> SettingsForOneType;
+
+  virtual ~LegacyContentSettingsProvider() {}
+
+  // Returns a single ContentSetting which applies to a given URL. Note that
+  // certain internal schemes are whitelisted. For ContentSettingsTypes that
+  // require an resource identifier to be specified, the |resource_identifier|
+  // must be non-empty.
+  //
+  // This may be called on any thread.
+  virtual ContentSetting GetContentSetting(
+      const GURL& url,
+      ContentSettingsType content_type,
+      const std::string& resource_identifier) const = 0;
+
+  // Returns a single ContentSetting which applies to a given URL or
+  // CONTENT_SETTING_DEFAULT, if no exception applies. Note that certain
+  // internal schemes are whitelisted. For ContentSettingsTypes that require an
+  // resource identifier to be specified, the |resource_identifier| must be
+  // non-empty.
+  //
+  // This may be called on any thread.
+  virtual ContentSetting GetNonDefaultContentSetting(
+      const GURL& url,
+      ContentSettingsType content_type,
+      const std::string& resource_identifier) const = 0;
+
+  // Returns all ContentSettings which apply to a given URL. For content
+  // setting types that require an additional resource identifier, the default
+  // content setting is returned.
+  //
+  // This may be called on any thread.
+  virtual ContentSettings GetContentSettings(const GURL& url) const = 0;
+
+  // Returns all non-default ContentSettings which apply to a given URL. For
+  // content setting types that require an additional resource identifier,
+  // CONTENT_SETTING_DEFAULT is returned.
+  //
+  // This may be called on any thread.
+  virtual ContentSettings GetNonDefaultContentSettings(
+      const GURL& url) const = 0;
+
+  // For a given content type, returns all patterns with a non-default setting,
+  // mapped to their actual settings, in lexicographical order.  |settings|
+  // must be a non-NULL outparam. If this map was created for the
+  // off-the-record profile, it will only return those settings differing from
+  // the main map. For ContentSettingsTypes that require an resource identifier
+  // to be specified, the |resource_identifier| must be non-empty.
+  //
+  // This may be called on any thread.
+  virtual void GetSettingsForOneType(ContentSettingsType content_type,
+                                     const std::string& resource_identifier,
+                                     SettingsForOneType* settings) const = 0;
+
+  // Sets the blocking setting for a particular pattern and content type.
+  // Setting the value to CONTENT_SETTING_DEFAULT causes the default setting
+  // for that type to be used when loading pages matching this pattern. For
+  // ContentSettingsTypes that require an resource identifier to be specified,
+  // the |resource_identifier| must be non-empty.
+  //
+  // This should only be called on the UI thread.
+  virtual void SetContentSetting(const ContentSettingsPattern& pattern,
+                         ContentSettingsType content_type,
+                         const std::string& resource_identifier,
+                         ContentSetting setting) = 0;
+
+  // Convenience method to add a content setting for a given URL, making sure
+  // that there is no setting overriding it. For ContentSettingsTypes that
+  // require an resource identifier to be specified, the |resource_identifier|
+  // must be non-empty.
+  //
+  // This should only be called on the UI thread.
+  virtual void AddExceptionForURL(const GURL& url,
+                          ContentSettingsType content_type,
+                          const std::string& resource_identifier,
+                          ContentSetting setting) = 0;
+
+  // Clears all host-specific settings for one content type.
+  //
+  // This should only be called on the UI thread.
+  virtual void ClearSettingsForOneType(ContentSettingsType content_type) = 0;
+
+  // Resets all settings levels.
+  //
+  // This should only be called on the UI thread.
+  virtual void ResetToDefaults() = 0;
+};
+
 #endif  // CHROME_BROWSER_CONTENT_SETTINGS_CONTENT_SETTINGS_PROVIDER_H_