blob: 3a3fafe0d1aa6dc78d4834c34d216f44c530eec6 [file] [log] [blame]
// 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 CONTENT_PUBLIC_BROWSER_RESOURCE_CONTEXT_H_
#define CONTENT_PUBLIC_BROWSER_RESOURCE_CONTEXT_H_
#include <string>
#include "base/basictypes.h"
#include "base/callback.h"
#include "base/memory/scoped_ptr.h"
#include "base/supports_user_data.h"
#include "build/build_config.h"
#include "content/common/content_export.h"
class GURL;
namespace net {
class ClientCertStore;
class HostResolver;
class KeygenHandler;
class URLRequestContext;
}
namespace content {
class AppCacheService;
// ResourceContext contains the relevant context information required for
// resource loading. It lives on the IO thread, although it is constructed on
// the UI thread. It must be destructed on the IO thread.
class CONTENT_EXPORT ResourceContext : public base::SupportsUserData {
public:
#if !defined(OS_IOS)
ResourceContext();
#endif
~ResourceContext() override;
virtual net::HostResolver* GetHostResolver() = 0;
// DEPRECATED: This is no longer a valid given isolated apps/sites and
// storage partitioning. This getter returns the default context associated
// with a BrowsingContext.
virtual net::URLRequestContext* GetRequestContext() = 0;
// Get platform ClientCertStore. May return nullptr.
virtual scoped_ptr<net::ClientCertStore> CreateClientCertStore();
// Create a platform KeygenHandler and pass it to |callback|. The |callback|
// may be run synchronously.
virtual void CreateKeygenHandler(
uint32 key_size_in_bits,
const std::string& challenge_string,
const GURL& url,
const base::Callback<void(scoped_ptr<net::KeygenHandler>)>& callback);
// Returns a callback that can be invoked to get a random salt
// string that is used for creating media device IDs. The salt
// should be stored in the current user profile and should be reset
// if cookies are cleared. The default is an empty string.
//
// It is safe to hold on to the callback returned and use it without
// regard to the lifetime of ResourceContext, although in general
// you should not use it long after the profile has been destroyed.
//
// TODO(joi): We don't think it should be unnecessary to use this
// after ResourceContext goes away. There is likely an underying bug
// in the lifetime of ProfileIOData vs. ResourceProcessHost, where
// sometimes ProfileIOData has gone away before RPH has finished
// being torn down (on the IO thread). The current interface that
// allows using the salt object after ResourceContext has gone away
// was put in place to fix http://crbug.com/341211 but I intend to
// try to figure out how the lifetime should be fixed properly. The
// original interface was just a method that returns a string.
//
// TODO(perkj): Make this method pure virtual when crbug/315022 is
// fixed.
typedef base::Callback<std::string()> SaltCallback;
virtual SaltCallback GetMediaDeviceIDSalt();
};
} // namespace content
#endif // CONTENT_PUBLIC_BROWSER_RESOURCE_CONTEXT_H_