content/public/browser/resource_context.h

   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 CONTENT_PUBLIC_BROWSER_RESOURCE_CONTEXT_H_
   6 #define CONTENT_PUBLIC_BROWSER_RESOURCE_CONTEXT_H_
   7
   8 #include <string>
   9
  10 #include "base/basictypes.h"
  11 #include "base/callback.h"
  12 #include "base/memory/scoped_ptr.h"
  13 #include "base/supports_user_data.h"
  14 #include "build/build_config.h"
  15 #include "content/common/content_export.h"
  16
  17 class GURL;
  18
  19 namespace net {
  20 class ClientCertStore;
  21 class HostResolver;
  22 class KeygenHandler;
  23 class URLRequestContext;
  24 }
  25
  26 namespace content {
  27
  28 class AppCacheService;
  29
  30 // ResourceContext contains the relevant context information required for
  31 // resource loading. It lives on the IO thread, although it is constructed on
  32 // the UI thread. It must be destructed on the IO thread.
  33 class CONTENT_EXPORT ResourceContext : public base::SupportsUserData {
  34  public:
  35 #if defined(OS_IOS)
  36   virtual ~ResourceContext() {}
  37 #else
  38   ResourceContext();
  39   virtual ~ResourceContext();
  40 #endif
  41   virtual net::HostResolver* GetHostResolver() = 0;
  42
  43   // DEPRECATED: This is no longer a valid given isolated apps/sites and
  44   // storage partitioning. This getter returns the default context associated
  45   // with a BrowsingContext.
  46   virtual net::URLRequestContext* GetRequestContext() = 0;
  47
  48   // Get platform ClientCertStore. May return NULL.
  49   virtual scoped_ptr<net::ClientCertStore> CreateClientCertStore();
  50
  51   // Create a platform KeygenHandler and pass it to |callback|. The |callback|
  52   // may be run synchronously.
  53   virtual void CreateKeygenHandler(
  54       uint32 key_size_in_bits,
  55       const std::string& challenge_string,
  56       const GURL& url,
  57       const base::Callback<void(scoped_ptr<net::KeygenHandler>)>& callback);
  58
  59   // Returns a callback that can be invoked to get a random salt
  60   // string that is used for creating media device IDs.  The salt
  61   // should be stored in the current user profile and should be reset
  62   // if cookies are cleared. The default is an empty string.
  63   //
  64   // It is safe to hold on to the callback returned and use it without
  65   // regard to the lifetime of ResourceContext, although in general
  66   // you should not use it long after the profile has been destroyed.
  67   //
  68   // TODO(joi): We don't think it should be unnecessary to use this
  69   // after ResourceContext goes away. There is likely an underying bug
  70   // in the lifetime of ProfileIOData vs. ResourceProcessHost, where
  71   // sometimes ProfileIOData has gone away before RPH has finished
  72   // being torn down (on the IO thread). The current interface that
  73   // allows using the salt object after ResourceContext has gone away
  74   // was put in place to fix http://crbug.com/341211 but I intend to
  75   // try to figure out how the lifetime should be fixed properly. The
  76   // original interface was just a method that returns a string.
  77   //
  78   // TODO(perkj): Make this method pure virtual when crbug/315022 is
  79   // fixed.
  80   typedef base::Callback<std::string()> SaltCallback;
  81   virtual SaltCallback GetMediaDeviceIDSalt();
  82 };
  83
  84 }  // namespace content
  85
  86 #endif  // CONTENT_PUBLIC_BROWSER_RESOURCE_CONTEXT_H_