resource_context.h revision 1320f92c476a1ad9d19dba2a48c72b75566198e9 
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
17class GURL;
18
19namespace net {
20class ClientCertStore;
21class HostResolver;
22class KeygenHandler;
23class URLRequestContext;
24}
25
26namespace content {
27
28class 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.
33class 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