Add support for complete isolation of storage and permissions (cache, cookies, localStorage, access grants, etc) on a per-request-context basis (issue #1044).

- CefRequestContext instances can be configured using a new CefRequestContextSettings structure passed to CefRequestContext::CreateContext.
- Scheme registration is now per-request-context using new CefRequestContext::RegisterSchemeHandlerFactory and ClearSchemeHandlerFactories methods.
- Cookie managers are now per-request-context by default and can be retrieved using a new CefRequestContext::GetDefaultCookieManager method.
- CefURLRequest::Create now accepts an optional CefRequestContext argument for associating a URL request with a context (browser process only).
- The CefRequestContextHandler associated with a CefRequestContext will not be released until all objects related to that context have been destroyed.
- When the cache path is empty an in-memory cache ("incognito mode") will be used for storage and no data will be persisted to disk.
- Add CefSettings.user_data_path which specifies the location where user data such as spell checking dictionary files will be stored on disk.
- Add asynchronous callbacks for all CefCookieManager methods.
- Add PK_LOCAL_APP_DATA and PK_USER_DATA path keys for retrieving user directories via CefGetPath.
- cefclient: Add "New Window" test that creates a new window unrelated to existing windows. When used in combination with `--request-context-per-browser` the new window will be given a new and isolated request context.

git-svn-id: https://chromiumembedded.googlecode.com/svn/trunk@2040 5089003a-bbd8-11dd-ad1f-f1f9622dbc98

libcef/browser/browser_context.h

@@ -6,7 +6,9 @@
 #define CEF_LIBCEF_BROWSER_BROWSER_CONTEXT_H_
 #pragma once
 
+#include "include/cef_request_context_handler.h"
 #include "libcef/browser/resource_context.h"
+#include "libcef/browser/url_request_context_getter_impl.h"
 
 #include "content/public/browser/browser_context.h"
 #include "content/public/browser/browser_thread.h"
@@ -26,11 +28,12 @@
 //
 // RCI = CefRequestContextImpl
 //  Implements the CefRequestContext interface which is exposed to clients.
-//  References the global BCI or creates a new BCP.
+//  References the isolated BCI or creates a new BCP.
 //
 // BCI = CefBrowserContextImpl
-//   Entry point from WC when using the global RCI. Owns the RC and creates the
-//   URCGI. Life span controlled by RCI and CefBrowserMainParts.
+//   Entry point from WC when using an isolated RCI. Owns the RC and creates the
+//   URCGI. Life span controlled by RCI and (for the global context)
+//   CefBrowserMainParts.
 //
 // BCP = CefBrowserContextProxy
 //   Entry point from WC when using a custom RCI. Owns the RC and creates the
@@ -42,14 +45,14 @@
 //   controlled by BCI/BCP.
 //
 // URCGI = CefURLRequestContextGetterImpl
-//   Creates and owns the URCI. Life span is controlled by RC and
-//   CefBrowserMainParts.
+//   Creates and owns the URCI. Life span is controlled by RC and (for the
+//   global context) CefBrowserMainParts.
 //
 // URCGP = CefURLRequestContextGetterProxy
 //   Creates and owns the URCP. Life span is controlled by RC.
 //
 // URCI = CefURLRequestContextImpl
-//   Owns various network-related objects including the global cookie manager.
+//   Owns various network-related objects including the isolated cookie manager.
 //   Owns URLRequest objects which must be destroyed first. Life span is
 //   controlled by URCGI.
 //
@@ -61,7 +64,7 @@
 // CSP = CefCookieStoreProxy
 //   Gives the CefCookieManager instance retrieved via CefRequestContextHandler
 //   an opportunity to handle cookie requests. Otherwise forwards requests via
-//   URCI to the global cookie manager. Life span is controlled by URCP.
+//   URCI to the isolated cookie manager. Life span is controlled by URCP.
 //
 //
 // Relationship diagram:
@@ -69,7 +72,7 @@
 //   own = ownership (scoped_ptr)
 //   ptr = raw pointer
 //
-//                    CefBrowserMainParts      global cookie manager, etc...
+//                    CefBrowserMainParts      isolated cookie manager, etc...
 //                       |           |            ^
 //                      ref         ref        ref/own
 //                       v           v            |
@@ -103,7 +106,7 @@
 
 // Main entry point for configuring behavior on a per-browser basis. An instance
 // of this class is passed to WebContents::Create in CefBrowserHostImpl::
-// CreateInternal. Only accessed on the UI thread.
+// CreateInternal. Only accessed on the UI thread unless otherwise indicated.
 class CefBrowserContext
     : public content::BrowserContext,
       public base::RefCountedThreadSafe<
@@ -114,6 +117,18 @@ class CefBrowserContext
   // BrowserContext methods.
   content::ResourceContext* GetResourceContext() override;
 
+  // Returns true if this is a CefBrowserContextProxy object. Safe to call from
+  // any thread.
+  virtual bool IsProxy() const = 0;
+
+  // Returns the settings associated with this object. Safe to call from any
+  // thread.
+  virtual const CefRequestContextSettings& GetSettings() const = 0;
+
+  // Returns the handler associated with this object. Safe to call from any
+  // thread.
+  virtual CefRefPtr<CefRequestContextHandler> GetHandler() const = 0;
+
   // Called from CefContentBrowserClient to create the URLRequestContextGetter.
   virtual net::URLRequestContextGetter* CreateRequestContext(
       content::ProtocolHandlerMap* protocol_handlers,