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_PROXY_PROXY_INFO_H_ 6 #define NET_PROXY_PROXY_INFO_H_ 7 8 #include <string> 9 10 #include "base/time/time.h" 11 #include "net/base/net_export.h" 12 #include "net/base/net_log.h" 13 #include "net/proxy/proxy_config.h" 14 #include "net/proxy/proxy_list.h" 15 #include "net/proxy/proxy_retry_info.h" 16 #include "net/proxy/proxy_server.h" 17 18 namespace net { 19 20 // This object holds proxy information returned by ResolveProxy. 21 class NET_EXPORT ProxyInfo { 22 public: 23 ProxyInfo(); 24 ~ProxyInfo(); 25 // Default copy-constructor and assignment operator are OK! 26 27 // Uses the same proxy server as the given |proxy_info|. 28 void Use(const ProxyInfo& proxy_info); 29 30 // Uses a direct connection. 31 void UseDirect(); 32 33 // Uses a direct connection. did_bypass_proxy() will return true to indicate 34 // that the direct connection is the result of configured proxy bypass rules. 35 void UseDirectWithBypassedProxy(); 36 37 // Uses a specific proxy server, of the form: 38 // proxy-uri = [<scheme> "://"] <hostname> [":" <port>] 39 // This may optionally be a semi-colon delimited list of <proxy-uri>. 40 // It is OK to have LWS between entries. 41 void UseNamedProxy(const std::string& proxy_uri_list); 42 43 // Sets the proxy list to a single entry, |proxy_server|. 44 void UseProxyServer(const ProxyServer& proxy_server); 45 46 // Parses from the given PAC result. 47 void UsePacString(const std::string& pac_string); 48 49 // Use the proxies from the given list. 50 void UseProxyList(const ProxyList& proxy_list); 51 52 // Returns true if this proxy info specifies a direct connection. 53 bool is_direct() const { 54 // We don't implicitly fallback to DIRECT unless it was added to the list. 55 if (is_empty()) 56 return false; 57 return proxy_list_.Get().is_direct(); 58 } 59 60 bool is_direct_only() const { 61 return is_direct() && proxy_list_.size() == 1 && proxy_retry_info_.empty(); 62 } 63 64 // Returns true if the first valid proxy server is an https proxy. 65 bool is_https() const { 66 if (is_empty()) 67 return false; 68 return proxy_server().is_https(); 69 } 70 71 // Returns true if the first valid proxy server is an http proxy. 72 bool is_http() const { 73 if (is_empty()) 74 return false; 75 return proxy_server().is_http(); 76 } 77 78 // Returns true if the first valid proxy server is a quic proxy. 79 bool is_quic() const { 80 if (is_empty()) 81 return false; 82 return proxy_server().is_quic(); 83 } 84 85 // Returns true if the first valid proxy server is a socks server. 86 bool is_socks() const { 87 if (is_empty()) 88 return false; 89 return proxy_server().is_socks(); 90 } 91 92 // Returns true if this proxy info has no proxies left to try. 93 bool is_empty() const { 94 return proxy_list_.IsEmpty(); 95 } 96 97 // Returns true if this proxy resolution is using a direct connection due to 98 // proxy bypass rules. 99 bool did_bypass_proxy() const { 100 return did_bypass_proxy_; 101 } 102 103 // Returns true if the proxy resolution was done using a PAC script. 104 bool did_use_pac_script() const { 105 return did_use_pac_script_; 106 } 107 108 // Returns the first valid proxy server. is_empty() must be false to be able 109 // to call this function. 110 const ProxyServer& proxy_server() const { return proxy_list_.Get(); } 111 112 // Returns the source for configuration settings used for proxy resolution. 113 ProxyConfigSource config_source() const { return config_source_; } 114 115 // See description in ProxyList::ToPacString(). 116 std::string ToPacString() const; 117 118 // Marks the current proxy as bad. Returns true if there is another proxy 119 // available to try in proxy list_. 120 bool Fallback(const BoundNetLog& net_log); 121 122 // De-prioritizes the proxies that we have cached as not working, by moving 123 // them to the end of the proxy list. 124 void DeprioritizeBadProxies(const ProxyRetryInfoMap& proxy_retry_info); 125 126 // Deletes any entry which doesn't have one of the specified proxy schemes. 127 void RemoveProxiesWithoutScheme(int scheme_bit_field); 128 129 ProxyConfig::ID config_id() const { return config_id_; } 130 131 base::TimeTicks proxy_resolve_start_time() const { 132 return proxy_resolve_start_time_; 133 } 134 135 base::TimeTicks proxy_resolve_end_time() const { 136 return proxy_resolve_end_time_; 137 } 138 139 private: 140 friend class ProxyService; 141 142 const ProxyRetryInfoMap& proxy_retry_info() const { 143 return proxy_retry_info_; 144 } 145 146 // Reset proxy and config settings. 147 void Reset(); 148 149 // The ordered list of proxy servers (including DIRECT attempts) remaining to 150 // try. If proxy_list_ is empty, then there is nothing left to fall back to. 151 ProxyList proxy_list_; 152 153 // List of proxies that have been tried already. 154 ProxyRetryInfoMap proxy_retry_info_; 155 156 // This value identifies the proxy config used to initialize this object. 157 ProxyConfig::ID config_id_; 158 159 // The source of the proxy settings used, 160 ProxyConfigSource config_source_; 161 162 // Whether the proxy result represent a proxy bypass. 163 bool did_bypass_proxy_; 164 165 // Whether we used a PAC script for resolving the proxy. 166 bool did_use_pac_script_; 167 168 // How long it took to resolve the proxy. Times are both null if proxy was 169 // determined synchronously without running a PAC. 170 base::TimeTicks proxy_resolve_start_time_; 171 base::TimeTicks proxy_resolve_end_time_; 172 }; 173 174 } // namespace net 175 176 #endif // NET_PROXY_PROXY_INFO_H_ 177