Part of twisted.web.client View Source View In Hierarchy
Connections are stored using keys, which should be chosen such that any connections stored under a given key can be used interchangeably.
Failed requests done using previously cached connections will be retried once if they use an idempotent method (e.g. GET), in case the HTTP server timed them out.
|Instance Variable||persistent||Boolean indicating whether connections should be persistent. Connections are persistent by default.|
|Instance Variable||maxPersistentPerHost||The maximum number of cached persistent connections for a
|Instance Variable||cachedConnectionTimeout||Number of seconds a cached persistent connection will stay open before disconnecting.|
|Method||getConnection||Retrieve a connection, either new or cached, to be used for a HTTP request.|
|Method||closeCachedConnections||Close all persistent connections and remove them from the pool.|
|Instance Variable||_factory||The factory used to connect to the proxy.|
|Instance Variable||_connections||Map (scheme, host, port) to lists of
|Method||_newConnection||Create a new connection.|
|Method||_removeConnection||Remove a connection from the cache and disconnect it.|
|Method||_putConnection||Return a persistent connection to the pool. This will be called by
booleanindicating whether idempotent requests should be retried once if no response was received.
HTTP11ClientProtocolinstances to a
IDelayedCallinstance of their timeout.
If a cached connection is returned, it will not be used for other requests until it is put back (which will happen automatically), since we do not support pipelined requests. If no cached connection is available, the passed in endpoint is used to create the connection.
If the connection doesn't disconnect at the end of its request, it will be returned to this pool automatically. As such, only a single request should be sent using the returned connection.
|Parameters||key||A unique key identifying connections that can be used interchangeably.|
|endpoint||An endpoint that can be used to open a new connection if no cached connection is available.|
This implements the new connection code path for
HTTP11ClientProtocolwhen the connection becomes quiescent.