OLD | NEW |
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 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> |
(...skipping 11 matching lines...) Expand all Loading... |
22 namespace base { | 22 namespace base { |
23 class DictionaryValue; | 23 class DictionaryValue; |
24 } | 24 } |
25 | 25 |
26 namespace net { | 26 namespace net { |
27 | 27 |
28 class ClientSocketHandle; | 28 class ClientSocketHandle; |
29 class ClientSocketPoolHistograms; | 29 class ClientSocketPoolHistograms; |
30 class StreamSocket; | 30 class StreamSocket; |
31 | 31 |
32 // ClientSocketPools are layered. This defines an interface for lower level | |
33 // socket pools to communicate with higher layer pools. | |
34 class LayeredPool { | |
35 public: | |
36 virtual ~LayeredPool() {} | |
37 | |
38 // Instructs the LayeredPool to close an idle connection. Return true if one | |
39 // was closed. | |
40 virtual bool CloseOneIdleConnection() = 0; | |
41 }; | |
42 | |
43 // A ClientSocketPool is used to restrict the number of sockets open at a time. | 32 // A ClientSocketPool is used to restrict the number of sockets open at a time. |
44 // It also maintains a list of idle persistent sockets. | 33 // It also maintains a list of idle persistent sockets. |
45 // | 34 // |
46 class NET_EXPORT ClientSocketPool { | 35 class NET_EXPORT ClientSocketPool { |
47 public: | 36 public: |
48 // Requests a connected socket for a group_name. | 37 // Requests a connected socket for a group_name. |
49 // | 38 // |
50 // There are five possible results from calling this function: | 39 // There are five possible results from calling this function: |
51 // 1) RequestSocket returns OK and initializes |handle| with a reused socket. | 40 // 1) RequestSocket returns OK and initializes |handle| with a reused socket. |
52 // 2) RequestSocket returns OK with a newly connected socket. | 41 // 2) RequestSocket returns OK with a newly connected socket. |
(...skipping 61 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
114 virtual void ReleaseSocket(const std::string& group_name, | 103 virtual void ReleaseSocket(const std::string& group_name, |
115 StreamSocket* socket, | 104 StreamSocket* socket, |
116 int id) = 0; | 105 int id) = 0; |
117 | 106 |
118 // This flushes all state from the ClientSocketPool. This means that all | 107 // This flushes all state from the ClientSocketPool. This means that all |
119 // idle and connecting sockets are discarded. Active sockets being | 108 // idle and connecting sockets are discarded. Active sockets being |
120 // held by ClientSocketPool clients will be discarded when released back to | 109 // held by ClientSocketPool clients will be discarded when released back to |
121 // the pool. Does not flush any pools wrapped by |this|. | 110 // the pool. Does not flush any pools wrapped by |this|. |
122 virtual void Flush() = 0; | 111 virtual void Flush() = 0; |
123 | 112 |
124 // Returns true if a new request may hit a per-pool (not per-host) max socket | |
125 // limit. | |
126 virtual bool IsStalled() const = 0; | |
127 | |
128 // Called to close any idle connections held by the connection manager. | 113 // Called to close any idle connections held by the connection manager. |
129 virtual void CloseIdleSockets() = 0; | 114 virtual void CloseIdleSockets() = 0; |
130 | 115 |
131 // The total number of idle sockets in the pool. | 116 // The total number of idle sockets in the pool. |
132 virtual int IdleSocketCount() const = 0; | 117 virtual int IdleSocketCount() const = 0; |
133 | 118 |
134 // The total number of idle sockets in a connection group. | 119 // The total number of idle sockets in a connection group. |
135 virtual int IdleSocketCountInGroup(const std::string& group_name) const = 0; | 120 virtual int IdleSocketCountInGroup(const std::string& group_name) const = 0; |
136 | 121 |
137 // Determine the LoadState of a connecting ClientSocketHandle. | 122 // Determine the LoadState of a connecting ClientSocketHandle. |
138 virtual LoadState GetLoadState(const std::string& group_name, | 123 virtual LoadState GetLoadState(const std::string& group_name, |
139 const ClientSocketHandle* handle) const = 0; | 124 const ClientSocketHandle* handle) const = 0; |
140 | 125 |
141 // Adds a LayeredPool on top of |this|. | |
142 virtual void AddLayeredPool(LayeredPool* layered_pool) = 0; | |
143 | |
144 // Removes a LayeredPool from |this|. | |
145 virtual void RemoveLayeredPool(LayeredPool* layered_pool) = 0; | |
146 | |
147 // Retrieves information on the current state of the pool as a | 126 // Retrieves information on the current state of the pool as a |
148 // DictionaryValue. Caller takes possession of the returned value. | 127 // DictionaryValue. Caller takes possession of the returned value. |
149 // If |include_nested_pools| is true, the states of any nested | 128 // If |include_nested_pools| is true, the states of any nested |
150 // ClientSocketPools will be included. | 129 // ClientSocketPools will be included. |
151 virtual base::DictionaryValue* GetInfoAsValue( | 130 virtual base::DictionaryValue* GetInfoAsValue( |
152 const std::string& name, | 131 const std::string& name, |
153 const std::string& type, | 132 const std::string& type, |
154 bool include_nested_pools) const = 0; | 133 bool include_nested_pools) const = 0; |
155 | 134 |
156 // Returns the maximum amount of time to wait before retrying a connect. | 135 // 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... |
211 const scoped_refptr<SocketParams>& params, | 190 const scoped_refptr<SocketParams>& params, |
212 int num_sockets, | 191 int num_sockets, |
213 const BoundNetLog& net_log) { | 192 const BoundNetLog& net_log) { |
214 CheckIsValidSocketParamsForPool<PoolType, SocketParams>(); | 193 CheckIsValidSocketParamsForPool<PoolType, SocketParams>(); |
215 pool->RequestSockets(group_name, ¶ms, num_sockets, net_log); | 194 pool->RequestSockets(group_name, ¶ms, num_sockets, net_log); |
216 } | 195 } |
217 | 196 |
218 } // namespace net | 197 } // namespace net |
219 | 198 |
220 #endif // NET_SOCKET_CLIENT_SOCKET_POOL_H_ | 199 #endif // NET_SOCKET_CLIENT_SOCKET_POOL_H_ |
OLD | NEW |