Home | History | Annotate | Download | only in browser 
      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_
     87