OLD | NEW |
---|---|
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 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 | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef NET_SOCKET_CLIENT_SOCKET_POOL_H_ | 5 #ifndef NET_SOCKET_CLIENT_SOCKET_POOL_H_ |
6 #define NET_SOCKET_CLIENT_SOCKET_POOL_H_ | 6 #define NET_SOCKET_CLIENT_SOCKET_POOL_H_ |
7 #pragma once | 7 #pragma once |
8 | 8 |
9 #include <deque> | 9 #include <deque> |
10 #include <string> | 10 #include <string> |
11 | 11 |
12 #include "base/basictypes.h" | 12 #include "base/basictypes.h" |
13 #include "base/debug/stack_trace.h" | |
13 #include "base/memory/ref_counted.h" | 14 #include "base/memory/ref_counted.h" |
14 #include "base/time.h" | 15 #include "base/time.h" |
15 #include "base/template_util.h" | 16 #include "base/template_util.h" |
16 #include "net/base/completion_callback.h" | 17 #include "net/base/completion_callback.h" |
17 #include "net/base/host_resolver.h" | 18 #include "net/base/host_resolver.h" |
18 #include "net/base/load_states.h" | 19 #include "net/base/load_states.h" |
19 #include "net/base/net_export.h" | 20 #include "net/base/net_export.h" |
20 #include "net/base/request_priority.h" | 21 #include "net/base/request_priority.h" |
21 | 22 |
22 namespace base { | 23 namespace base { |
23 class DictionaryValue; | 24 class DictionaryValue; |
24 } | 25 } |
25 | 26 |
26 namespace net { | 27 namespace net { |
27 | 28 |
28 class ClientSocketHandle; | 29 class ClientSocketHandle; |
29 class ClientSocketPoolHistograms; | 30 class ClientSocketPoolHistograms; |
30 class StreamSocket; | 31 class StreamSocket; |
31 | 32 |
33 // TODO(rch): Remove this once we track down the use-after-free | |
34 enum MagicValue { | |
eroman
2012/03/28 18:25:59
nit: Please put this inside the private section of
Ryan Hamilton
2012/03/28 18:35:28
Done.
| |
35 ALIVE = 0xCA11AB1E, | |
36 DEAD = 0xDEADBEEF | |
37 }; | |
38 | |
39 // ClientSocketPools are layered. This defines an interface for lower level | |
40 // socket pools to communicate with higher layer pools. | |
41 class NET_EXPORT LayeredPool { | |
42 public: | |
43 LayeredPool(); | |
44 virtual ~LayeredPool(); | |
45 | |
46 // Instructs the LayeredPool to close an idle connection. Return true if one | |
47 // was closed. | |
48 virtual bool CloseOneIdleConnection() = 0; | |
49 | |
50 // TODO(rch): remove this once we track down the use-after-free | |
51 void CrashIfFreed(); | |
52 | |
53 private: | |
54 // TODO(rch): Remove this once we track down the use-after-free | |
55 MagicValue magic_value_; | |
56 base::debug::StackTrace stack_trace_; | |
57 }; | |
58 | |
32 // A ClientSocketPool is used to restrict the number of sockets open at a time. | 59 // A ClientSocketPool is used to restrict the number of sockets open at a time. |
33 // It also maintains a list of idle persistent sockets. | 60 // It also maintains a list of idle persistent sockets. |
34 // | 61 // |
35 class NET_EXPORT ClientSocketPool { | 62 class NET_EXPORT ClientSocketPool { |
36 public: | 63 public: |
37 // Requests a connected socket for a group_name. | 64 // Requests a connected socket for a group_name. |
38 // | 65 // |
39 // There are five possible results from calling this function: | 66 // There are five possible results from calling this function: |
40 // 1) RequestSocket returns OK and initializes |handle| with a reused socket. | 67 // 1) RequestSocket returns OK and initializes |handle| with a reused socket. |
41 // 2) RequestSocket returns OK with a newly connected socket. | 68 // 2) RequestSocket returns OK with a newly connected socket. |
(...skipping 61 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
103 virtual void ReleaseSocket(const std::string& group_name, | 130 virtual void ReleaseSocket(const std::string& group_name, |
104 StreamSocket* socket, | 131 StreamSocket* socket, |
105 int id) = 0; | 132 int id) = 0; |
106 | 133 |
107 // This flushes all state from the ClientSocketPool. This means that all | 134 // This flushes all state from the ClientSocketPool. This means that all |
108 // idle and connecting sockets are discarded. Active sockets being | 135 // idle and connecting sockets are discarded. Active sockets being |
109 // held by ClientSocketPool clients will be discarded when released back to | 136 // held by ClientSocketPool clients will be discarded when released back to |
110 // the pool. Does not flush any pools wrapped by |this|. | 137 // the pool. Does not flush any pools wrapped by |this|. |
111 virtual void Flush() = 0; | 138 virtual void Flush() = 0; |
112 | 139 |
140 // Returns true if a there is currently a request blocked on the | |
141 // per-pool (not per-host) max socket limit. | |
142 virtual bool IsStalled() const = 0; | |
143 | |
113 // Called to close any idle connections held by the connection manager. | 144 // Called to close any idle connections held by the connection manager. |
114 virtual void CloseIdleSockets() = 0; | 145 virtual void CloseIdleSockets() = 0; |
115 | 146 |
116 // The total number of idle sockets in the pool. | 147 // The total number of idle sockets in the pool. |
117 virtual int IdleSocketCount() const = 0; | 148 virtual int IdleSocketCount() const = 0; |
118 | 149 |
119 // The total number of idle sockets in a connection group. | 150 // The total number of idle sockets in a connection group. |
120 virtual int IdleSocketCountInGroup(const std::string& group_name) const = 0; | 151 virtual int IdleSocketCountInGroup(const std::string& group_name) const = 0; |
121 | 152 |
122 // Determine the LoadState of a connecting ClientSocketHandle. | 153 // Determine the LoadState of a connecting ClientSocketHandle. |
123 virtual LoadState GetLoadState(const std::string& group_name, | 154 virtual LoadState GetLoadState(const std::string& group_name, |
124 const ClientSocketHandle* handle) const = 0; | 155 const ClientSocketHandle* handle) const = 0; |
125 | 156 |
157 // Adds a LayeredPool on top of |this|. | |
158 virtual void AddLayeredPool(LayeredPool* layered_pool) = 0; | |
159 | |
160 // Removes a LayeredPool from |this|. | |
161 virtual void RemoveLayeredPool(LayeredPool* layered_pool) = 0; | |
162 | |
126 // Retrieves information on the current state of the pool as a | 163 // Retrieves information on the current state of the pool as a |
127 // DictionaryValue. Caller takes possession of the returned value. | 164 // DictionaryValue. Caller takes possession of the returned value. |
128 // If |include_nested_pools| is true, the states of any nested | 165 // If |include_nested_pools| is true, the states of any nested |
129 // ClientSocketPools will be included. | 166 // ClientSocketPools will be included. |
130 virtual base::DictionaryValue* GetInfoAsValue( | 167 virtual base::DictionaryValue* GetInfoAsValue( |
131 const std::string& name, | 168 const std::string& name, |
132 const std::string& type, | 169 const std::string& type, |
133 bool include_nested_pools) const = 0; | 170 bool include_nested_pools) const = 0; |
134 | 171 |
135 // Returns the maximum amount of time to wait before retrying a connect. | 172 // Returns the maximum amount of time to wait before retrying a connect. |
(...skipping 54 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
190 const scoped_refptr<SocketParams>& params, | 227 const scoped_refptr<SocketParams>& params, |
191 int num_sockets, | 228 int num_sockets, |
192 const BoundNetLog& net_log) { | 229 const BoundNetLog& net_log) { |
193 CheckIsValidSocketParamsForPool<PoolType, SocketParams>(); | 230 CheckIsValidSocketParamsForPool<PoolType, SocketParams>(); |
194 pool->RequestSockets(group_name, ¶ms, num_sockets, net_log); | 231 pool->RequestSockets(group_name, ¶ms, num_sockets, net_log); |
195 } | 232 } |
196 | 233 |
197 } // namespace net | 234 } // namespace net |
198 | 235 |
199 #endif // NET_SOCKET_CLIENT_SOCKET_POOL_H_ | 236 #endif // NET_SOCKET_CLIENT_SOCKET_POOL_H_ |
OLD | NEW |