Support manual (white|black)list, previewing and allowing after interstitial

chrome/browser/managed_mode/managed_mode.h

 // Copyright (c) 2012 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_MANAGED_MODE_MANAGED_MODE_H_
 #define CHROME_BROWSER_MANAGED_MODE_MANAGED_MODE_H_
 
 #include <set>
 #include <string>
 #include <vector>
 
 #include "base/callback.h"
 #include "base/compiler_specific.h"
 #include "base/memory/scoped_ptr.h"
 #include "base/memory/singleton.h"
 #include "chrome/browser/extensions/management_policy.h"
 #include "chrome/browser/ui/browser_list_observer.h"
 #include "content/public/browser/notification_observer.h"
 #include "content/public/browser/notification_registrar.h"
 
 class Browser;
 template<typename T>
 struct DefaultSingletonTraits;
 class ManagedModeSiteList;
 class ManagedModeURLFilter;
 class PrefChangeRegistrar;
 class PrefService;
 class Profile;
+
 namespace policy{
 class URLBlacklist;
 }
 
 // Managed mode allows one person to manage the Chrome experience for another
 // person by pre-configuring and then locking a managed User profile.
 // The ManagedMode class provides methods to check whether the browser is in
 // managed mode, and to attempt to enter or leave managed mode.
 // Except where otherwise noted, this class should be used on the UI thread.
 class ManagedMode : public chrome::BrowserListObserver,
@@ skipping 24 matching lines @@
   // classifying sites in the history view.
   // This method should only be called on the UI thread.
   static const ManagedModeURLFilter* GetURLFilterForUIThread();
 
   // Returns the URL's category.
   static int GetCategory(const GURL& url);
 
   // Called in the critical path of drawing the history UI, so needs to be fast.
   static void GetCategoryNames(CategoryList* list);
 
-  // Returns the profile whitelist.
-  static scoped_ptr<base::ListValue> GetWhitelist();
+  // Checks if the url pattern is in the manual whitelist.
+  static bool IsInManualWhitelist(const std::string& url_pattern);
+  bool IsInManualWhitelistImpl(const std::string& url_pattern);

[Bernhard Bauer, 2012/11/27 18:44:46]

Make this private please.

[Sergiu, 2012/11/28 12:53:25]

Done. I'm not sure about the order of the functions in .h though.. It makes more
sense to me to keep the non-Impl close to the Impl in the .cc but then they're
not really grouped by visibility. Any tips here?

[Bernhard Bauer, 2012/11/28 14:21:05]

You mean in the .cc file? In the .h file we don't have a choice.
I don't have a particular preference. Personally, I'm not very good at keeping
method definitions in the same order as declarations, so I would be okay with
grouping them.

 
-  // Sets the profile whitelist to |whitelist|.
-  static void SetWhitelist(base::ListValue* whitelist);
+  // Appends |whitelist| to the manual whitelist (both in URL filter and in
+  // preferences). Returns whether the last element in |whitelist| was already
+  // in the manual whitelist or not.

[Bernhard Bauer, 2012/11/27 18:44:46]

That seems… very specific. Could a client just use IsInManualWhitelist() for the
last element before adding them?

[Sergiu, 2012/11/28 12:53:25]

I'm not sure I get you here, AddToManualWhitelist adds a whole whitelist, not
just an entry. The bool is returned then to show the infobar if we didn't add
the last one.

[Bernhard Bauer, 2012/11/28 14:21:05]

Yes, it's just that an interface "add these, and tell me if the last one of them
was already on the list" is very specific to the client that calls it. So I was
asking if we could simplify the interface of this class by using other methods
(like the one we already have that tells whether a given site is on the
whitelist), which I see you did. So... 'kay.

+  static bool AddToManualWhitelist(const base::ListValue& whitelist);
+  bool AddToManualWhitelistImpl(const base::ListValue& whitelist);

[Bernhard Bauer, 2012/11/27 18:44:46]

Make this private.

[Sergiu, 2012/11/28 12:53:25]

Done.

 
-  // Adds the |url| to the manual lists.
-  static void AddStringToManualWhitelist(const std::string& url);
-  static void AddStringToManualBlacklist(const std::string& url);
+  // Adds the |url_pattern| to the manual lists in the URL filter.
+  static void AddURLPatternToManualWhitelist(const std::string& url_pattern);
+  static void AddURLPatternToManualBlacklist(const std::string& url_pattern);
 
   // Returns the profile blacklist.
   static scoped_ptr<base::ListValue> GetBlacklist();
 
   // ExtensionManagementPolicy::Provider implementation:
   virtual std::string GetDebugPolicyProviderName() const OVERRIDE;
   virtual bool UserMayLoad(const extensions::Extension* extension,
                            string16* error) const OVERRIDE;
   virtual bool UserMayModifySettings(const extensions::Extension* extension,
                                      string16* error) const OVERRIDE;
@@ skipping 58 matching lines @@
 
   // Returns a list of all installed and enabled site lists in the current
   // managed profile.
   // This method should only be called if managed mode is active.
   ScopedVector<ManagedModeSiteList> GetActiveSiteLists();
 
   void OnFamilyPackOptionsChanged();
 
   void UpdateWhitelist();
 
+  // Returns a copy of the manual whitelist which is stored in each profile.
+  scoped_ptr<base::ListValue> GetWhitelist();
+
   content::NotificationRegistrar registrar_;
   scoped_ptr<PrefChangeRegistrar> pref_change_registrar_;
 
   scoped_ptr<URLFilterContext> io_url_filter_context_;
   scoped_ptr<URLFilterContext> ui_url_filter_context_;
 
   std::set<Browser*> browsers_to_close_;
   std::vector<EnterCallback> callbacks_;
 
   DISALLOW_COPY_AND_ASSIGN(ManagedMode);
 };
 
 #endif  // CHROME_BROWSER_MANAGED_MODE_MANAGED_MODE_H_