net/http/http_network_session.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 NET_HTTP_HTTP_NETWORK_SESSION_H_
   6 #define NET_HTTP_HTTP_NETWORK_SESSION_H_
   7
   8 #include <set>
   9 #include <string>
  10 #include <vector>
  11
  12 #include "base/basictypes.h"
  13 #include "base/memory/ref_counted.h"
  14 #include "base/memory/weak_ptr.h"
  15 #include "base/threading/non_thread_safe.h"
  16 #include "net/base/host_port_pair.h"
  17 #include "net/base/net_export.h"
  18 #include "net/dns/host_resolver.h"
  19 #include "net/http/http_auth_cache.h"
  20 #include "net/http/http_stream_factory.h"
  21 #include "net/quic/quic_stream_factory.h"
  22 #include "net/socket/next_proto.h"
  23 #include "net/spdy/spdy_session_pool.h"
  24 #include "net/ssl/ssl_client_auth_cache.h"
  25
  26 namespace base {
  27 class Value;
  28 }
  29
  30 namespace net {
  31
  32 class CertPolicyEnforcer;
  33 class CertVerifier;
  34 class ChannelIDService;
  35 class ClientSocketFactory;
  36 class ClientSocketPoolManager;
  37 class CTVerifier;
  38 class HostResolver;
  39 class HttpAuthHandlerFactory;
  40 class HttpNetworkSessionPeer;
  41 class HttpProxyClientSocketPool;
  42 class HttpResponseBodyDrainer;
  43 class HttpServerProperties;
  44 class NetLog;
  45 class NetworkDelegate;
  46 class ProxyDelegate;
  47 class ProxyService;
  48 class QuicClock;
  49 class QuicCryptoClientStreamFactory;
  50 class QuicServerInfoFactory;
  51 class SOCKSClientSocketPool;
  52 class SSLClientSocketPool;
  53 class SSLConfigService;
  54 class TransportClientSocketPool;
  55 class TransportSecurityState;
  56
  57 // This class holds session objects used by HttpNetworkTransaction objects.
  58 class NET_EXPORT HttpNetworkSession
  59     : public base::RefCounted<HttpNetworkSession>,
  60       NON_EXPORTED_BASE(public base::NonThreadSafe) {
  61  public:
  62   struct NET_EXPORT Params {
  63     Params();
  64     ~Params();
  65
  66     ClientSocketFactory* client_socket_factory;
  67     HostResolver* host_resolver;
  68     CertVerifier* cert_verifier;
  69     CertPolicyEnforcer* cert_policy_enforcer;
  70     ChannelIDService* channel_id_service;
  71     TransportSecurityState* transport_security_state;
  72     CTVerifier* cert_transparency_verifier;
  73     ProxyService* proxy_service;
  74     std::string ssl_session_cache_shard;
  75     SSLConfigService* ssl_config_service;
  76     HttpAuthHandlerFactory* http_auth_handler_factory;
  77     NetworkDelegate* network_delegate;
  78     base::WeakPtr<HttpServerProperties> http_server_properties;
  79     NetLog* net_log;
  80     HostMappingRules* host_mapping_rules;
  81     bool ignore_certificate_errors;
  82     uint16 testing_fixed_http_port;
  83     uint16 testing_fixed_https_port;
  84     bool enable_tcp_fast_open_for_ssl;
  85
  86     bool enable_spdy_compression;
  87     bool enable_spdy_ping_based_connection_checking;
  88     NextProto spdy_default_protocol;
  89     // The protocols supported by NPN (next protocol negotiation) during the
  90     // SSL handshake as well as by HTTP Alternate-Protocol.
  91     // TODO(mmenke):  This is currently empty by default, and alternate
  92     //                protocols are disabled.  We should use some reasonable
  93     //                defaults.
  94     NextProtoVector next_protos;
  95     size_t spdy_session_max_recv_window_size;
  96     size_t spdy_stream_max_recv_window_size;
  97     size_t spdy_initial_max_concurrent_streams;
  98     SpdySessionPool::TimeFunc time_func;
  99     std::string trusted_spdy_proxy;
 100     // URLs to exclude from forced SPDY.
 101     std::set<HostPortPair> forced_spdy_exclusions;
 102     // Noe: Using this in the case of NPN for HTTP only results in the browser
 103     // trying SSL and then falling back to http.
 104     bool use_alternate_protocols;
 105     double alternative_service_probability_threshold;
 106
 107     bool enable_quic;
 108     bool enable_insecure_quic;
 109     bool enable_quic_for_proxies;
 110     bool enable_quic_port_selection;
 111     bool quic_always_require_handshake_confirmation;
 112     bool quic_disable_connection_pooling;
 113     float quic_load_server_info_timeout_srtt_multiplier;
 114     bool quic_enable_connection_racing;
 115     bool quic_enable_non_blocking_io;
 116     bool quic_disable_disk_cache;
 117     bool quic_prefer_aes;
 118     int quic_max_number_of_lossy_connections;
 119     float quic_packet_loss_threshold;
 120     int quic_socket_receive_buffer_size;
 121     HostPortPair origin_to_force_quic_on;
 122     QuicClock* quic_clock;  // Will be owned by QuicStreamFactory.
 123     QuicRandom* quic_random;
 124     size_t quic_max_packet_length;
 125     std::string quic_user_agent_id;
 126     bool enable_user_alternate_protocol_ports;
 127     QuicCryptoClientStreamFactory* quic_crypto_client_stream_factory;
 128     QuicVersionVector quic_supported_versions;
 129     int quic_max_recent_disabled_reasons;
 130     int quic_threshold_public_resets_post_handshake;
 131     int quic_threshold_timeouts_streams_open;
 132     QuicTagVector quic_connection_options;
 133     ProxyDelegate* proxy_delegate;
 134   };
 135
 136   enum SocketPoolType {
 137     NORMAL_SOCKET_POOL,
 138     WEBSOCKET_SOCKET_POOL,
 139     NUM_SOCKET_POOL_TYPES
 140   };
 141
 142   explicit HttpNetworkSession(const Params& params);
 143
 144   HttpAuthCache* http_auth_cache() { return &http_auth_cache_; }
 145   SSLClientAuthCache* ssl_client_auth_cache() {
 146     return &ssl_client_auth_cache_;
 147   }
 148
 149   void AddResponseDrainer(HttpResponseBodyDrainer* drainer);
 150
 151   void RemoveResponseDrainer(HttpResponseBodyDrainer* drainer);
 152
 153   TransportClientSocketPool* GetTransportSocketPool(SocketPoolType pool_type);
 154   SSLClientSocketPool* GetSSLSocketPool(SocketPoolType pool_type);
 155   SOCKSClientSocketPool* GetSocketPoolForSOCKSProxy(
 156       SocketPoolType pool_type,
 157       const HostPortPair& socks_proxy);
 158   HttpProxyClientSocketPool* GetSocketPoolForHTTPProxy(
 159       SocketPoolType pool_type,
 160       const HostPortPair& http_proxy);
 161   SSLClientSocketPool* GetSocketPoolForSSLWithProxy(
 162       SocketPoolType pool_type,
 163       const HostPortPair& proxy_server);
 164
 165   CertVerifier* cert_verifier() { return cert_verifier_; }
 166   ProxyService* proxy_service() { return proxy_service_; }
 167   SSLConfigService* ssl_config_service() { return ssl_config_service_.get(); }
 168   SpdySessionPool* spdy_session_pool() { return &spdy_session_pool_; }
 169   QuicStreamFactory* quic_stream_factory() { return &quic_stream_factory_; }
 170   HttpAuthHandlerFactory* http_auth_handler_factory() {
 171     return http_auth_handler_factory_;
 172   }
 173   NetworkDelegate* network_delegate() {
 174     return network_delegate_;
 175   }
 176   base::WeakPtr<HttpServerProperties> http_server_properties() {
 177     return http_server_properties_;
 178   }
 179   HttpStreamFactory* http_stream_factory() {
 180     return http_stream_factory_.get();
 181   }
 182   HttpStreamFactory* http_stream_factory_for_websocket() {
 183     return http_stream_factory_for_websocket_.get();
 184   }
 185   NetLog* net_log() {
 186     return net_log_;
 187   }
 188
 189   // Creates a Value summary of the state of the socket pools.
 190   scoped_ptr<base::Value> SocketPoolInfoToValue() const;
 191
 192   // Creates a Value summary of the state of the SPDY sessions.
 193   scoped_ptr<base::Value> SpdySessionPoolInfoToValue() const;
 194
 195   // Creates a Value summary of the state of the QUIC sessions and
 196   // configuration.
 197   scoped_ptr<base::Value> QuicInfoToValue() const;
 198
 199   void CloseAllConnections();
 200   void CloseIdleConnections();
 201
 202   // Returns the original Params used to construct this session.
 203   const Params& params() const { return params_; }
 204
 205   bool IsProtocolEnabled(AlternateProtocol protocol) const;
 206
 207   // Populates |*next_protos| with protocols.
 208   void GetNextProtos(NextProtoVector* next_protos) const;
 209
 210   // Convenience function for searching through |params_| for
 211   // |forced_spdy_exclusions|.
 212   bool HasSpdyExclusion(HostPortPair host_port_pair) const;
 213
 214  private:
 215   friend class base::RefCounted<HttpNetworkSession>;
 216   friend class HttpNetworkSessionPeer;
 217
 218   ~HttpNetworkSession();
 219
 220   ClientSocketPoolManager* GetSocketPoolManager(SocketPoolType pool_type);
 221
 222   NetLog* const net_log_;
 223   NetworkDelegate* const network_delegate_;
 224   const base::WeakPtr<HttpServerProperties> http_server_properties_;
 225   CertVerifier* const cert_verifier_;
 226   HttpAuthHandlerFactory* const http_auth_handler_factory_;
 227
 228   // Not const since it's modified by HttpNetworkSessionPeer for testing.
 229   ProxyService* proxy_service_;
 230   const scoped_refptr<SSLConfigService> ssl_config_service_;
 231
 232   HttpAuthCache http_auth_cache_;
 233   SSLClientAuthCache ssl_client_auth_cache_;
 234   scoped_ptr<ClientSocketPoolManager> normal_socket_pool_manager_;
 235   scoped_ptr<ClientSocketPoolManager> websocket_socket_pool_manager_;
 236   QuicStreamFactory quic_stream_factory_;
 237   SpdySessionPool spdy_session_pool_;
 238   scoped_ptr<HttpStreamFactory> http_stream_factory_;
 239   scoped_ptr<HttpStreamFactory> http_stream_factory_for_websocket_;
 240   std::set<HttpResponseBodyDrainer*> response_drainers_;
 241
 242   NextProtoVector next_protos_;
 243   bool enabled_protocols_[NUM_VALID_ALTERNATE_PROTOCOLS];
 244
 245   Params params_;
 246 };
 247
 248 }  // namespace net
 249
 250 #endif  // NET_HTTP_HTTP_NETWORK_SESSION_H_