blob: eb2f61fb2a450c56e58dfe7274d036c67afd81a0 [file] [log] [blame]
// Copyright (c) 2011 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.
// This class represents contextual information (cookies, cache, etc.)
// that's useful when processing resource requests.
// The class is reference-counted so that it can be cleaned up after any
// requests that are using it have been completed.
#pragma once
#include "base/memory/ref_counted.h"
#include "base/memory/scoped_ptr.h"
#include "base/memory/weak_ptr.h"
#include "base/threading/non_thread_safe.h"
#include "net/base/net_export.h"
#include "net/base/net_log.h"
#include "net/base/ssl_config_service.h"
#include "net/base/transport_security_state.h"
#include "net/ftp/ftp_auth_cache.h"
namespace net {
class CertVerifier;
class CookieStore;
class DnsCertProvenanceChecker;
class DnsRRResolver;
class FtpTransactionFactory;
class HostResolver;
class HttpAuthHandlerFactory;
class HttpTransactionFactory;
class NetworkDelegate;
class OriginBoundCertService;
class ProxyService;
class URLRequest;
class URLRequestJobFactory;
// Subclass to provide application-specific context for URLRequest
// instances. Note that URLRequestContext typically does not provide storage for
// these member variables, since they may be shared. For the ones that aren't
// shared, URLRequestContextStorage can be helpful in defining their storage.
class NET_EXPORT URLRequestContext
: public base::RefCountedThreadSafe<URLRequestContext>,
NON_EXPORTED_BASE(public base::NonThreadSafe) {
base::WeakPtr<URLRequestContext> GetWeakPtr() {
return weak_factory_.GetWeakPtr();
// Copies the state from |other| into this context.
void CopyFrom(URLRequestContext* other);
NetLog* net_log() const {
return net_log_;
void set_net_log(NetLog* net_log) {
net_log_ = net_log;
HostResolver* host_resolver() const {
return host_resolver_;
void set_host_resolver(HostResolver* host_resolver) {
host_resolver_ = host_resolver;
CertVerifier* cert_verifier() const {
return cert_verifier_;
void set_cert_verifier(CertVerifier* cert_verifier) {
cert_verifier_ = cert_verifier;
OriginBoundCertService* origin_bound_cert_service() const {
return origin_bound_cert_service_;
void set_origin_bound_cert_service(
OriginBoundCertService* origin_bound_cert_service) {
origin_bound_cert_service_ = origin_bound_cert_service;
DnsRRResolver* dnsrr_resolver() const {
return dnsrr_resolver_;
void set_dnsrr_resolver(DnsRRResolver* dnsrr_resolver) {
dnsrr_resolver_ = dnsrr_resolver;
DnsCertProvenanceChecker* dns_cert_checker() const {
return dns_cert_checker_;
void set_dns_cert_checker(DnsCertProvenanceChecker* dns_cert_checker) {
dns_cert_checker_ = dns_cert_checker;
// Get the proxy service for this context.
ProxyService* proxy_service() const { return proxy_service_; }
void set_proxy_service(ProxyService* proxy_service) {
proxy_service_ = proxy_service;
// Get the ssl config service for this context.
SSLConfigService* ssl_config_service() const { return ssl_config_service_; }
void set_ssl_config_service(SSLConfigService* service) {
ssl_config_service_ = service;
// Gets the HTTP Authentication Handler Factory for this context.
// The factory is only valid for the lifetime of this URLRequestContext
HttpAuthHandlerFactory* http_auth_handler_factory() {
return http_auth_handler_factory_;
void set_http_auth_handler_factory(HttpAuthHandlerFactory* factory) {
http_auth_handler_factory_ = factory;
// Gets the http transaction factory for this context.
HttpTransactionFactory* http_transaction_factory() const {
return http_transaction_factory_;
void set_http_transaction_factory(HttpTransactionFactory* factory) {
http_transaction_factory_ = factory;
// Gets the ftp transaction factory for this context.
FtpTransactionFactory* ftp_transaction_factory() const {
return ftp_transaction_factory_;
void set_ftp_transaction_factory(FtpTransactionFactory* factory) {
ftp_transaction_factory_ = factory;
void set_network_delegate(NetworkDelegate* network_delegate) {
network_delegate_ = network_delegate;
NetworkDelegate* network_delegate() const { return network_delegate_; }
// Gets the cookie store for this context (may be null, in which case
// cookies are not stored).
CookieStore* cookie_store() const { return cookie_store_.get(); }
void set_cookie_store(CookieStore* cookie_store);
TransportSecurityState* transport_security_state() const {
return transport_security_state_;
void set_transport_security_state(
TransportSecurityState* state) {
transport_security_state_ = state;
// Gets the FTP authentication cache for this context.
FtpAuthCache* ftp_auth_cache() const { return ftp_auth_cache_.get(); }
// Gets the value of 'Accept-Charset' header field.
const std::string& accept_charset() const { return accept_charset_; }
void set_accept_charset(const std::string& accept_charset) {
accept_charset_ = accept_charset;
// Gets the value of 'Accept-Language' header field.
const std::string& accept_language() const { return accept_language_; }
void set_accept_language(const std::string& accept_language) {
accept_language_ = accept_language;
// Gets the UA string to use for the given URL. Pass an invalid URL (such as
// GURL()) to get the default UA string. Subclasses should override this
// method to provide a UA string.
virtual const std::string& GetUserAgent(const GURL& url) const;
// In general, referrer_charset is not known when URLRequestContext is
// constructed. So, we need a setter.
const std::string& referrer_charset() const { return referrer_charset_; }
void set_referrer_charset(const std::string& charset) {
referrer_charset_ = charset;
const URLRequestJobFactory* job_factory() const { return job_factory_; }
void set_job_factory(const URLRequestJobFactory* job_factory) {
job_factory_ = job_factory;
friend class base::RefCountedThreadSafe<URLRequestContext>;
virtual ~URLRequestContext();
base::WeakPtrFactory<URLRequestContext> weak_factory_;
// ---------------------------------------------------------------------------
// Important: When adding any new members below, consider whether they need to
// be added to CopyFrom.
// ---------------------------------------------------------------------------
// Ownership for these members are not defined here. Clients should either
// provide storage elsewhere or have a subclass take ownership.
NetLog* net_log_;
HostResolver* host_resolver_;
CertVerifier* cert_verifier_;
OriginBoundCertService* origin_bound_cert_service_;
DnsRRResolver* dnsrr_resolver_;
DnsCertProvenanceChecker* dns_cert_checker_;
HttpAuthHandlerFactory* http_auth_handler_factory_;
ProxyService* proxy_service_;
scoped_refptr<SSLConfigService> ssl_config_service_;
NetworkDelegate* network_delegate_;
scoped_refptr<CookieStore> cookie_store_;
scoped_refptr<TransportSecurityState> transport_security_state_;
scoped_ptr<FtpAuthCache> ftp_auth_cache_;
std::string accept_language_;
std::string accept_charset_;
// The charset of the referrer where this request comes from. It's not
// used in communication with a server but is used to construct a suggested
// filename for file download.
std::string referrer_charset_;
HttpTransactionFactory* http_transaction_factory_;
FtpTransactionFactory* ftp_transaction_factory_;
const URLRequestJobFactory* job_factory_;
// ---------------------------------------------------------------------------
// Important: When adding any new members below, consider whether they need to
// be added to CopyFrom.
// ---------------------------------------------------------------------------
} // namespace net