diff options
Diffstat (limited to 'chromium/net/socket/client_socket_pool_base.h')
-rw-r--r-- | chromium/net/socket/client_socket_pool_base.h | 819 |
1 files changed, 819 insertions, 0 deletions
diff --git a/chromium/net/socket/client_socket_pool_base.h b/chromium/net/socket/client_socket_pool_base.h new file mode 100644 index 00000000000..eb642edd730 --- /dev/null +++ b/chromium/net/socket/client_socket_pool_base.h @@ -0,0 +1,819 @@ +// Copyright (c) 2012 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. +// +// A ClientSocketPoolBase is used to restrict the number of sockets open at +// a time. It also maintains a list of idle persistent sockets for reuse. +// Subclasses of ClientSocketPool should compose ClientSocketPoolBase to handle +// the core logic of (1) restricting the number of active (connected or +// connecting) sockets per "group" (generally speaking, the hostname), (2) +// maintaining a per-group list of idle, persistent sockets for reuse, and (3) +// limiting the total number of active sockets in the system. +// +// ClientSocketPoolBase abstracts socket connection details behind ConnectJob, +// ConnectJobFactory, and SocketParams. When a socket "slot" becomes available, +// the ClientSocketPoolBase will ask the ConnectJobFactory to create a +// ConnectJob with a SocketParams. Subclasses of ClientSocketPool should +// implement their socket specific connection by subclassing ConnectJob and +// implementing ConnectJob::ConnectInternal(). They can control the parameters +// passed to each new ConnectJob instance via their ConnectJobFactory subclass +// and templated SocketParams parameter. +// +#ifndef NET_SOCKET_CLIENT_SOCKET_POOL_BASE_H_ +#define NET_SOCKET_CLIENT_SOCKET_POOL_BASE_H_ + +#include <deque> +#include <list> +#include <map> +#include <set> +#include <string> +#include <vector> + +#include "base/basictypes.h" +#include "base/memory/ref_counted.h" +#include "base/memory/scoped_ptr.h" +#include "base/memory/weak_ptr.h" +#include "base/time/time.h" +#include "base/timer/timer.h" +#include "net/base/address_list.h" +#include "net/base/completion_callback.h" +#include "net/base/load_states.h" +#include "net/base/load_timing_info.h" +#include "net/base/net_errors.h" +#include "net/base/net_export.h" +#include "net/base/net_log.h" +#include "net/base/network_change_notifier.h" +#include "net/base/request_priority.h" +#include "net/socket/client_socket_pool.h" +#include "net/socket/stream_socket.h" + +namespace net { + +class ClientSocketHandle; + +// ConnectJob provides an abstract interface for "connecting" a socket. +// The connection may involve host resolution, tcp connection, ssl connection, +// etc. +class NET_EXPORT_PRIVATE ConnectJob { + public: + class NET_EXPORT_PRIVATE Delegate { + public: + Delegate() {} + virtual ~Delegate() {} + + // Alerts the delegate that the connection completed. |job| must + // be destroyed by the delegate. A scoped_ptr<> isn't used because + // the caller of this function doesn't own |job|. + virtual void OnConnectJobComplete(int result, + ConnectJob* job) = 0; + + private: + DISALLOW_COPY_AND_ASSIGN(Delegate); + }; + + // A |timeout_duration| of 0 corresponds to no timeout. + ConnectJob(const std::string& group_name, + base::TimeDelta timeout_duration, + Delegate* delegate, + const BoundNetLog& net_log); + virtual ~ConnectJob(); + + // Accessors + const std::string& group_name() const { return group_name_; } + const BoundNetLog& net_log() { return net_log_; } + + // Releases ownership of the underlying socket to the caller. + // Returns the released socket, or NULL if there was a connection + // error. + scoped_ptr<StreamSocket> PassSocket(); + + // Begins connecting the socket. Returns OK on success, ERR_IO_PENDING if it + // cannot complete synchronously without blocking, or another net error code + // on error. In asynchronous completion, the ConnectJob will notify + // |delegate_| via OnConnectJobComplete. In both asynchronous and synchronous + // completion, ReleaseSocket() can be called to acquire the connected socket + // if it succeeded. + int Connect(); + + virtual LoadState GetLoadState() const = 0; + + // If Connect returns an error (or OnConnectJobComplete reports an error + // result) this method will be called, allowing the pool to add + // additional error state to the ClientSocketHandle (post late-binding). + virtual void GetAdditionalErrorState(ClientSocketHandle* handle) {} + + const LoadTimingInfo::ConnectTiming& connect_timing() const { + return connect_timing_; + } + + const BoundNetLog& net_log() const { return net_log_; } + + protected: + void SetSocket(scoped_ptr<StreamSocket> socket); + StreamSocket* socket() { return socket_.get(); } + void NotifyDelegateOfCompletion(int rv); + void ResetTimer(base::TimeDelta remainingTime); + + // Connection establishment timing information. + LoadTimingInfo::ConnectTiming connect_timing_; + + private: + virtual int ConnectInternal() = 0; + + void LogConnectStart(); + void LogConnectCompletion(int net_error); + + // Alerts the delegate that the ConnectJob has timed out. + void OnTimeout(); + + const std::string group_name_; + const base::TimeDelta timeout_duration_; + // Timer to abort jobs that take too long. + base::OneShotTimer<ConnectJob> timer_; + Delegate* delegate_; + scoped_ptr<StreamSocket> socket_; + BoundNetLog net_log_; + // A ConnectJob is idle until Connect() has been called. + bool idle_; + + DISALLOW_COPY_AND_ASSIGN(ConnectJob); +}; + +namespace internal { + +// ClientSocketPoolBaseHelper is an internal class that implements almost all +// the functionality from ClientSocketPoolBase without using templates. +// ClientSocketPoolBase adds templated definitions built on top of +// ClientSocketPoolBaseHelper. This class is not for external use, please use +// ClientSocketPoolBase instead. +class NET_EXPORT_PRIVATE ClientSocketPoolBaseHelper + : public ConnectJob::Delegate, + public NetworkChangeNotifier::IPAddressObserver { + public: + typedef uint32 Flags; + + // Used to specify specific behavior for the ClientSocketPool. + enum Flag { + NORMAL = 0, // Normal behavior. + NO_IDLE_SOCKETS = 0x1, // Do not return an idle socket. Create a new one. + }; + + class NET_EXPORT_PRIVATE Request { + public: + Request(ClientSocketHandle* handle, + const CompletionCallback& callback, + RequestPriority priority, + bool ignore_limits, + Flags flags, + const BoundNetLog& net_log); + + virtual ~Request(); + + ClientSocketHandle* handle() const { return handle_; } + const CompletionCallback& callback() const { return callback_; } + RequestPriority priority() const { return priority_; } + bool ignore_limits() const { return ignore_limits_; } + Flags flags() const { return flags_; } + const BoundNetLog& net_log() const { return net_log_; } + + private: + ClientSocketHandle* const handle_; + CompletionCallback callback_; + const RequestPriority priority_; + bool ignore_limits_; + const Flags flags_; + BoundNetLog net_log_; + + DISALLOW_COPY_AND_ASSIGN(Request); + }; + + class ConnectJobFactory { + public: + ConnectJobFactory() {} + virtual ~ConnectJobFactory() {} + + virtual scoped_ptr<ConnectJob> NewConnectJob( + const std::string& group_name, + const Request& request, + ConnectJob::Delegate* delegate) const = 0; + + virtual base::TimeDelta ConnectionTimeout() const = 0; + + private: + DISALLOW_COPY_AND_ASSIGN(ConnectJobFactory); + }; + + ClientSocketPoolBaseHelper( + int max_sockets, + int max_sockets_per_group, + base::TimeDelta unused_idle_socket_timeout, + base::TimeDelta used_idle_socket_timeout, + ConnectJobFactory* connect_job_factory); + + virtual ~ClientSocketPoolBaseHelper(); + + // Adds/Removes layered pools. It is expected in the destructor that no + // layered pools remain. + void AddLayeredPool(LayeredPool* pool); + void RemoveLayeredPool(LayeredPool* pool); + + // See ClientSocketPool::RequestSocket for documentation on this function. + // ClientSocketPoolBaseHelper takes ownership of |request|, which must be + // heap allocated. + int RequestSocket(const std::string& group_name, const Request* request); + + // See ClientSocketPool::RequestSocket for documentation on this function. + void RequestSockets(const std::string& group_name, + const Request& request, + int num_sockets); + + // See ClientSocketPool::CancelRequest for documentation on this function. + void CancelRequest(const std::string& group_name, + ClientSocketHandle* handle); + + // See ClientSocketPool::ReleaseSocket for documentation on this function. + void ReleaseSocket(const std::string& group_name, + scoped_ptr<StreamSocket> socket, + int id); + + // See ClientSocketPool::FlushWithError for documentation on this function. + void FlushWithError(int error); + + // See ClientSocketPool::IsStalled for documentation on this function. + bool IsStalled() const; + + // See ClientSocketPool::CloseIdleSockets for documentation on this function. + void CloseIdleSockets(); + + // See ClientSocketPool::IdleSocketCount() for documentation on this function. + int idle_socket_count() const { + return idle_socket_count_; + } + + // See ClientSocketPool::IdleSocketCountInGroup() for documentation on this + // function. + int IdleSocketCountInGroup(const std::string& group_name) const; + + // See ClientSocketPool::GetLoadState() for documentation on this function. + LoadState GetLoadState(const std::string& group_name, + const ClientSocketHandle* handle) const; + + base::TimeDelta ConnectRetryInterval() const { + // TODO(mbelshe): Make this tuned dynamically based on measured RTT. + // For now, just use the max retry interval. + return base::TimeDelta::FromMilliseconds( + ClientSocketPool::kMaxConnectRetryIntervalMs); + } + + int NumUnassignedConnectJobsInGroup(const std::string& group_name) const { + return group_map_.find(group_name)->second->unassigned_job_count(); + } + + int NumConnectJobsInGroup(const std::string& group_name) const { + return group_map_.find(group_name)->second->jobs().size(); + } + + int NumActiveSocketsInGroup(const std::string& group_name) const { + return group_map_.find(group_name)->second->active_socket_count(); + } + + bool HasGroup(const std::string& group_name) const; + + // Called to enable/disable cleaning up idle sockets. When enabled, + // idle sockets that have been around for longer than a period defined + // by kCleanupInterval are cleaned up using a timer. Otherwise they are + // closed next time client makes a request. This may reduce network + // activity and power consumption. + static bool cleanup_timer_enabled(); + static bool set_cleanup_timer_enabled(bool enabled); + + // Closes all idle sockets if |force| is true. Else, only closes idle + // sockets that timed out or can't be reused. Made public for testing. + void CleanupIdleSockets(bool force); + + // Closes one idle socket. Picks the first one encountered. + // TODO(willchan): Consider a better algorithm for doing this. Perhaps we + // should keep an ordered list of idle sockets, and close them in order. + // Requires maintaining more state. It's not clear if it's worth it since + // I'm not sure if we hit this situation often. + bool CloseOneIdleSocket(); + + // Checks layered pools to see if they can close an idle connection. + bool CloseOneIdleConnectionInLayeredPool(); + + // See ClientSocketPool::GetInfoAsValue for documentation on this function. + base::DictionaryValue* GetInfoAsValue(const std::string& name, + const std::string& type) const; + + base::TimeDelta ConnectionTimeout() const { + return connect_job_factory_->ConnectionTimeout(); + } + + static bool connect_backup_jobs_enabled(); + static bool set_connect_backup_jobs_enabled(bool enabled); + + void EnableConnectBackupJobs(); + + // ConnectJob::Delegate methods: + virtual void OnConnectJobComplete(int result, ConnectJob* job) OVERRIDE; + + // NetworkChangeNotifier::IPAddressObserver methods: + virtual void OnIPAddressChanged() OVERRIDE; + + private: + friend class base::RefCounted<ClientSocketPoolBaseHelper>; + + // Entry for a persistent socket which became idle at time |start_time|. + struct IdleSocket { + IdleSocket() : socket(NULL) {} + + // An idle socket should be removed if it can't be reused, or has been idle + // for too long. |now| is the current time value (TimeTicks::Now()). + // |timeout| is the length of time to wait before timing out an idle socket. + // + // An idle socket can't be reused if it is disconnected or has received + // data unexpectedly (hence no longer idle). The unread data would be + // mistaken for the beginning of the next response if we were to reuse the + // socket for a new request. + bool ShouldCleanup(base::TimeTicks now, base::TimeDelta timeout) const; + + StreamSocket* socket; + base::TimeTicks start_time; + }; + + typedef std::deque<const Request* > RequestQueue; + typedef std::map<const ClientSocketHandle*, const Request*> RequestMap; + + // A Group is allocated per group_name when there are idle sockets or pending + // requests. Otherwise, the Group object is removed from the map. + // |active_socket_count| tracks the number of sockets held by clients. + class Group { + public: + Group(); + ~Group(); + + bool IsEmpty() const { + return active_socket_count_ == 0 && idle_sockets_.empty() && + jobs_.empty() && pending_requests_.empty(); + } + + bool HasAvailableSocketSlot(int max_sockets_per_group) const { + return NumActiveSocketSlots() < max_sockets_per_group; + } + + int NumActiveSocketSlots() const { + return active_socket_count_ + static_cast<int>(jobs_.size()) + + static_cast<int>(idle_sockets_.size()); + } + + bool IsStalledOnPoolMaxSockets(int max_sockets_per_group) const { + return HasAvailableSocketSlot(max_sockets_per_group) && + pending_requests_.size() > jobs_.size(); + } + + RequestPriority TopPendingPriority() const { + return pending_requests_.front()->priority(); + } + + bool HasBackupJob() const { return weak_factory_.HasWeakPtrs(); } + + void CleanupBackupJob() { + weak_factory_.InvalidateWeakPtrs(); + } + + // Set a timer to create a backup socket if it takes too long to create one. + void StartBackupSocketTimer(const std::string& group_name, + ClientSocketPoolBaseHelper* pool); + + // If there's a ConnectJob that's never been assigned to Request, + // decrements |unassigned_job_count_| and returns true. + // Otherwise, returns false. + bool TryToUseUnassignedConnectJob(); + + void AddJob(scoped_ptr<ConnectJob> job, bool is_preconnect); + // Remove |job| from this group, which must already own |job|. + void RemoveJob(ConnectJob* job); + void RemoveAllJobs(); + + void IncrementActiveSocketCount() { active_socket_count_++; } + void DecrementActiveSocketCount() { active_socket_count_--; } + + int unassigned_job_count() const { return unassigned_job_count_; } + const std::set<ConnectJob*>& jobs() const { return jobs_; } + const std::list<IdleSocket>& idle_sockets() const { return idle_sockets_; } + const RequestQueue& pending_requests() const { return pending_requests_; } + int active_socket_count() const { return active_socket_count_; } + RequestQueue* mutable_pending_requests() { return &pending_requests_; } + std::list<IdleSocket>* mutable_idle_sockets() { return &idle_sockets_; } + + private: + // Called when the backup socket timer fires. + void OnBackupSocketTimerFired( + std::string group_name, + ClientSocketPoolBaseHelper* pool); + + // Checks that |unassigned_job_count_| does not execeed the number of + // ConnectJobs. + void SanityCheck(); + + // Total number of ConnectJobs that have never been assigned to a Request. + // Since jobs use late binding to requests, which ConnectJobs have or have + // not been assigned to a request are not tracked. This is incremented on + // preconnect and decremented when a preconnect is assigned, or when there + // are fewer than |unassigned_job_count_| ConnectJobs. Not incremented + // when a request is cancelled. + size_t unassigned_job_count_; + + std::list<IdleSocket> idle_sockets_; + std::set<ConnectJob*> jobs_; + RequestQueue pending_requests_; + int active_socket_count_; // number of active sockets used by clients + // A factory to pin the backup_job tasks. + base::WeakPtrFactory<Group> weak_factory_; + }; + + typedef std::map<std::string, Group*> GroupMap; + + typedef std::set<ConnectJob*> ConnectJobSet; + + struct CallbackResultPair { + CallbackResultPair(); + CallbackResultPair(const CompletionCallback& callback_in, int result_in); + ~CallbackResultPair(); + + CompletionCallback callback; + int result; + }; + + typedef std::map<const ClientSocketHandle*, CallbackResultPair> + PendingCallbackMap; + + // Inserts the request into the queue based on order they will receive + // sockets. Sockets which ignore the socket pool limits are first. Then + // requests are sorted by priority, with higher priorities closer to the + // front. Older requests are prioritized over requests of equal priority. + static void InsertRequestIntoQueue(const Request* r, + RequestQueue* pending_requests); + static const Request* RemoveRequestFromQueue(const RequestQueue::iterator& it, + Group* group); + + Group* GetOrCreateGroup(const std::string& group_name); + void RemoveGroup(const std::string& group_name); + void RemoveGroup(GroupMap::iterator it); + + // Called when the number of idle sockets changes. + void IncrementIdleCount(); + void DecrementIdleCount(); + + // Start cleanup timer for idle sockets. + void StartIdleSocketTimer(); + + // Scans the group map for groups which have an available socket slot and + // at least one pending request. Returns true if any groups are stalled, and + // if so (and if both |group| and |group_name| are not NULL), fills |group| + // and |group_name| with data of the stalled group having highest priority. + bool FindTopStalledGroup(Group** group, std::string* group_name) const; + + // Called when timer_ fires. This method scans the idle sockets removing + // sockets that timed out or can't be reused. + void OnCleanupTimerFired() { + CleanupIdleSockets(false); + } + + // Removes |job| from |group|, which must already own |job|. + void RemoveConnectJob(ConnectJob* job, Group* group); + + // Tries to see if we can handle any more requests for |group|. + void OnAvailableSocketSlot(const std::string& group_name, Group* group); + + // Process a pending socket request for a group. + void ProcessPendingRequest(const std::string& group_name, Group* group); + + // Assigns |socket| to |handle| and updates |group|'s counters appropriately. + void HandOutSocket(scoped_ptr<StreamSocket> socket, + bool reused, + const LoadTimingInfo::ConnectTiming& connect_timing, + ClientSocketHandle* handle, + base::TimeDelta time_idle, + Group* group, + const BoundNetLog& net_log); + + // Adds |socket| to the list of idle sockets for |group|. + void AddIdleSocket(scoped_ptr<StreamSocket> socket, Group* group); + + // Iterates through |group_map_|, canceling all ConnectJobs and deleting + // groups if they are no longer needed. + void CancelAllConnectJobs(); + + // Iterates through |group_map_|, posting |error| callbacks for all + // requests, and then deleting groups if they are no longer needed. + void CancelAllRequestsWithError(int error); + + // Returns true if we can't create any more sockets due to the total limit. + bool ReachedMaxSocketsLimit() const; + + // This is the internal implementation of RequestSocket(). It differs in that + // it does not handle logging into NetLog of the queueing status of + // |request|. + int RequestSocketInternal(const std::string& group_name, + const Request* request); + + // Assigns an idle socket for the group to the request. + // Returns |true| if an idle socket is available, false otherwise. + bool AssignIdleSocketToRequest(const Request* request, Group* group); + + static void LogBoundConnectJobToRequest( + const NetLog::Source& connect_job_source, const Request* request); + + // Same as CloseOneIdleSocket() except it won't close an idle socket in + // |group|. If |group| is NULL, it is ignored. Returns true if it closed a + // socket. + bool CloseOneIdleSocketExceptInGroup(const Group* group); + + // Checks if there are stalled socket groups that should be notified + // for possible wakeup. + void CheckForStalledSocketGroups(); + + // Posts a task to call InvokeUserCallback() on the next iteration through the + // current message loop. Inserts |callback| into |pending_callback_map_|, + // keyed by |handle|. + void InvokeUserCallbackLater( + ClientSocketHandle* handle, const CompletionCallback& callback, int rv); + + // Invokes the user callback for |handle|. By the time this task has run, + // it's possible that the request has been cancelled, so |handle| may not + // exist in |pending_callback_map_|. We look up the callback and result code + // in |pending_callback_map_|. + void InvokeUserCallback(ClientSocketHandle* handle); + + // Tries to close idle sockets in a higher level socket pool as long as this + // this pool is stalled. + void TryToCloseSocketsInLayeredPools(); + + GroupMap group_map_; + + // Map of the ClientSocketHandles for which we have a pending Task to invoke a + // callback. This is necessary since, before we invoke said callback, it's + // possible that the request is cancelled. + PendingCallbackMap pending_callback_map_; + + // Timer used to periodically prune idle sockets that timed out or can't be + // reused. + base::RepeatingTimer<ClientSocketPoolBaseHelper> timer_; + + // The total number of idle sockets in the system. + int idle_socket_count_; + + // Number of connecting sockets across all groups. + int connecting_socket_count_; + + // Number of connected sockets we handed out across all groups. + int handed_out_socket_count_; + + // The maximum total number of sockets. See ReachedMaxSocketsLimit. + const int max_sockets_; + + // The maximum number of sockets kept per group. + const int max_sockets_per_group_; + + // Whether to use timer to cleanup idle sockets. + bool use_cleanup_timer_; + + // The time to wait until closing idle sockets. + const base::TimeDelta unused_idle_socket_timeout_; + const base::TimeDelta used_idle_socket_timeout_; + + const scoped_ptr<ConnectJobFactory> connect_job_factory_; + + // TODO(vandebo) Remove when backup jobs move to TransportClientSocketPool + bool connect_backup_jobs_enabled_; + + // A unique id for the pool. It gets incremented every time we + // FlushWithError() the pool. This is so that when sockets get released back + // to the pool, we can make sure that they are discarded rather than reused. + int pool_generation_number_; + + std::set<LayeredPool*> higher_layer_pools_; + + base::WeakPtrFactory<ClientSocketPoolBaseHelper> weak_factory_; + + DISALLOW_COPY_AND_ASSIGN(ClientSocketPoolBaseHelper); +}; + +} // namespace internal + +template <typename SocketParams> +class ClientSocketPoolBase { + public: + class Request : public internal::ClientSocketPoolBaseHelper::Request { + public: + Request(ClientSocketHandle* handle, + const CompletionCallback& callback, + RequestPriority priority, + internal::ClientSocketPoolBaseHelper::Flags flags, + bool ignore_limits, + const scoped_refptr<SocketParams>& params, + const BoundNetLog& net_log) + : internal::ClientSocketPoolBaseHelper::Request( + handle, callback, priority, ignore_limits, flags, net_log), + params_(params) {} + + const scoped_refptr<SocketParams>& params() const { return params_; } + + private: + const scoped_refptr<SocketParams> params_; + }; + + class ConnectJobFactory { + public: + ConnectJobFactory() {} + virtual ~ConnectJobFactory() {} + + virtual scoped_ptr<ConnectJob> NewConnectJob( + const std::string& group_name, + const Request& request, + ConnectJob::Delegate* delegate) const = 0; + + virtual base::TimeDelta ConnectionTimeout() const = 0; + + private: + DISALLOW_COPY_AND_ASSIGN(ConnectJobFactory); + }; + + // |max_sockets| is the maximum number of sockets to be maintained by this + // ClientSocketPool. |max_sockets_per_group| specifies the maximum number of + // sockets a "group" can have. |unused_idle_socket_timeout| specifies how + // long to leave an unused idle socket open before closing it. + // |used_idle_socket_timeout| specifies how long to leave a previously used + // idle socket open before closing it. + ClientSocketPoolBase( + int max_sockets, + int max_sockets_per_group, + ClientSocketPoolHistograms* histograms, + base::TimeDelta unused_idle_socket_timeout, + base::TimeDelta used_idle_socket_timeout, + ConnectJobFactory* connect_job_factory) + : histograms_(histograms), + helper_(max_sockets, max_sockets_per_group, + unused_idle_socket_timeout, used_idle_socket_timeout, + new ConnectJobFactoryAdaptor(connect_job_factory)) {} + + virtual ~ClientSocketPoolBase() {} + + // These member functions simply forward to ClientSocketPoolBaseHelper. + void AddLayeredPool(LayeredPool* pool) { + helper_.AddLayeredPool(pool); + } + + void RemoveLayeredPool(LayeredPool* pool) { + helper_.RemoveLayeredPool(pool); + } + + // RequestSocket bundles up the parameters into a Request and then forwards to + // ClientSocketPoolBaseHelper::RequestSocket(). + int RequestSocket(const std::string& group_name, + const scoped_refptr<SocketParams>& params, + RequestPriority priority, + ClientSocketHandle* handle, + const CompletionCallback& callback, + const BoundNetLog& net_log) { + Request* request = + new Request(handle, callback, priority, + internal::ClientSocketPoolBaseHelper::NORMAL, + params->ignore_limits(), + params, net_log); + return helper_.RequestSocket(group_name, request); + } + + // RequestSockets bundles up the parameters into a Request and then forwards + // to ClientSocketPoolBaseHelper::RequestSockets(). Note that it assigns the + // priority to DEFAULT_PRIORITY and specifies the NO_IDLE_SOCKETS flag. + void RequestSockets(const std::string& group_name, + const scoped_refptr<SocketParams>& params, + int num_sockets, + const BoundNetLog& net_log) { + const Request request(NULL /* no handle */, + CompletionCallback(), + DEFAULT_PRIORITY, + internal::ClientSocketPoolBaseHelper::NO_IDLE_SOCKETS, + params->ignore_limits(), + params, + net_log); + helper_.RequestSockets(group_name, request, num_sockets); + } + + void CancelRequest(const std::string& group_name, + ClientSocketHandle* handle) { + return helper_.CancelRequest(group_name, handle); + } + + void ReleaseSocket(const std::string& group_name, + scoped_ptr<StreamSocket> socket, + int id) { + return helper_.ReleaseSocket(group_name, socket.Pass(), id); + } + + void FlushWithError(int error) { helper_.FlushWithError(error); } + + bool IsStalled() const { return helper_.IsStalled(); } + + void CloseIdleSockets() { return helper_.CloseIdleSockets(); } + + int idle_socket_count() const { return helper_.idle_socket_count(); } + + int IdleSocketCountInGroup(const std::string& group_name) const { + return helper_.IdleSocketCountInGroup(group_name); + } + + LoadState GetLoadState(const std::string& group_name, + const ClientSocketHandle* handle) const { + return helper_.GetLoadState(group_name, handle); + } + + virtual void OnConnectJobComplete(int result, ConnectJob* job) { + return helper_.OnConnectJobComplete(result, job); + } + + int NumUnassignedConnectJobsInGroup(const std::string& group_name) const { + return helper_.NumUnassignedConnectJobsInGroup(group_name); + } + + int NumConnectJobsInGroup(const std::string& group_name) const { + return helper_.NumConnectJobsInGroup(group_name); + } + + int NumActiveSocketsInGroup(const std::string& group_name) const { + return helper_.NumActiveSocketsInGroup(group_name); + } + + bool HasGroup(const std::string& group_name) const { + return helper_.HasGroup(group_name); + } + + void CleanupIdleSockets(bool force) { + return helper_.CleanupIdleSockets(force); + } + + base::DictionaryValue* GetInfoAsValue(const std::string& name, + const std::string& type) const { + return helper_.GetInfoAsValue(name, type); + } + + base::TimeDelta ConnectionTimeout() const { + return helper_.ConnectionTimeout(); + } + + ClientSocketPoolHistograms* histograms() const { + return histograms_; + } + + void EnableConnectBackupJobs() { helper_.EnableConnectBackupJobs(); } + + bool CloseOneIdleSocket() { return helper_.CloseOneIdleSocket(); } + + bool CloseOneIdleConnectionInLayeredPool() { + return helper_.CloseOneIdleConnectionInLayeredPool(); + } + + private: + // This adaptor class exists to bridge the + // internal::ClientSocketPoolBaseHelper::ConnectJobFactory and + // ClientSocketPoolBase::ConnectJobFactory types, allowing clients to use the + // typesafe ClientSocketPoolBase::ConnectJobFactory, rather than having to + // static_cast themselves. + class ConnectJobFactoryAdaptor + : public internal::ClientSocketPoolBaseHelper::ConnectJobFactory { + public: + typedef typename ClientSocketPoolBase<SocketParams>::ConnectJobFactory + ConnectJobFactory; + + explicit ConnectJobFactoryAdaptor(ConnectJobFactory* connect_job_factory) + : connect_job_factory_(connect_job_factory) {} + virtual ~ConnectJobFactoryAdaptor() {} + + virtual scoped_ptr<ConnectJob> NewConnectJob( + const std::string& group_name, + const internal::ClientSocketPoolBaseHelper::Request& request, + ConnectJob::Delegate* delegate) const OVERRIDE { + const Request& casted_request = static_cast<const Request&>(request); + return connect_job_factory_->NewConnectJob( + group_name, casted_request, delegate); + } + + virtual base::TimeDelta ConnectionTimeout() const { + return connect_job_factory_->ConnectionTimeout(); + } + + const scoped_ptr<ConnectJobFactory> connect_job_factory_; + }; + + // Histograms for the pool + ClientSocketPoolHistograms* const histograms_; + internal::ClientSocketPoolBaseHelper helper_; + + DISALLOW_COPY_AND_ASSIGN(ClientSocketPoolBase); +}; + +} // namespace net + +#endif // NET_SOCKET_CLIENT_SOCKET_POOL_BASE_H_ |