Package org.apache.http.impl.conn
Class SingleClientConnManager
java.lang.Object
org.apache.http.impl.conn.SingleClientConnManager
- All Implemented Interfaces:
ClientConnectionManager
@Contract(threading=SAFE)
@Deprecated
public class SingleClientConnManager
extends Object
implements ClientConnectionManager
Deprecated.
A connection manager for a single connection. This connection manager
maintains only one active connection at a time. Even though this class
is thread-safe it ought to be used by one execution thread only.
SingleClientConnManager will make an effort to reuse the connection
for subsequent requests with the same route
.
It will, however, close the existing connection and open it
for the given route, if the route of the persistent connection does
not match that of the connection request. If the connection has been
already been allocated IllegalStateException
is thrown.
- Since:
- 4.0
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprotected class
Deprecated.The connection adapter used by this manager.protected class
Deprecated.The pool entry for this connection manager. -
Field Summary
FieldsModifier and TypeFieldDescriptionprotected final boolean
Deprecated.Whether the connection should be shut down on release.protected long
Deprecated.The time the last released connection expires and shouldn't be reused.protected final ClientConnectionOperator
Deprecated.The operator for opening and updating connections.protected boolean
Deprecated.Indicates whether this connection manager is shut down.protected long
Deprecated.The time of the last connection release, or -1.protected SingleClientConnManager.ConnAdapter
Deprecated.The currently issued managed connection, if any.static final String
Deprecated.The message to be logged on multiple allocation.protected final SchemeRegistry
Deprecated.The schemes supported by this connection manager.protected SingleClientConnManager.PoolEntry
Deprecated.The one and only entry in this pool. -
Constructor Summary
ConstructorsConstructorDescriptionDeprecated.Deprecated.Creates a new simple connection manager.SingleClientConnManager
(org.apache.http.params.HttpParams params, SchemeRegistry schreg) Deprecated.(4.1) useSingleClientConnManager(SchemeRegistry)
-
Method Summary
Modifier and TypeMethodDescriptionprotected final void
Deprecated.Asserts that this manager is not shut down.void
Deprecated.Closes all expired connections in the pool.void
closeIdleConnections
(long idletime, TimeUnit timeUnit) Deprecated.Closes idle connections in the pool.protected ClientConnectionOperator
Deprecated.Hook for creating the connection operator.protected void
finalize()
Deprecated.getConnection
(HttpRoute route, Object state) Deprecated.Obtains a connection.Deprecated.Obtains the scheme registry used by this manager.void
releaseConnection
(ManagedClientConnection conn, long validDuration, TimeUnit timeUnit) Deprecated.Releases a connection for use by others.final ClientConnectionRequest
requestConnection
(HttpRoute route, Object state) Deprecated.Returns a newClientConnectionRequest
, from which aManagedClientConnection
can be obtained or the request can be aborted.protected void
Deprecated.void
shutdown()
Deprecated.Shuts down this connection manager and releases allocated resources.
-
Field Details
-
MISUSE_MESSAGE
Deprecated.The message to be logged on multiple allocation.- See Also:
-
schemeRegistry
Deprecated.The schemes supported by this connection manager. -
connOperator
Deprecated.The operator for opening and updating connections. -
alwaysShutDown
protected final boolean alwaysShutDownDeprecated.Whether the connection should be shut down on release. -
uniquePoolEntry
Deprecated.The one and only entry in this pool. -
managedConn
Deprecated.The currently issued managed connection, if any. -
lastReleaseTime
protected volatile long lastReleaseTimeDeprecated.The time of the last connection release, or -1. -
connectionExpiresTime
protected volatile long connectionExpiresTimeDeprecated.The time the last released connection expires and shouldn't be reused. -
isShutDown
protected volatile boolean isShutDownDeprecated.Indicates whether this connection manager is shut down.
-
-
Constructor Details
-
SingleClientConnManager
@Deprecated public SingleClientConnManager(org.apache.http.params.HttpParams params, SchemeRegistry schreg) Deprecated.(4.1) useSingleClientConnManager(SchemeRegistry)
Creates a new simple connection manager.- Parameters:
params
- the parameters for this managerschreg
- the scheme registry
-
SingleClientConnManager
Deprecated.Creates a new simple connection manager.- Parameters:
schreg
- the scheme registry
-
SingleClientConnManager
public SingleClientConnManager()Deprecated.- Since:
- 4.1
-
-
Method Details
-
finalize
Deprecated. -
getSchemeRegistry
Deprecated.Description copied from interface:ClientConnectionManager
Obtains the scheme registry used by this manager.- Specified by:
getSchemeRegistry
in interfaceClientConnectionManager
- Returns:
- the scheme registry, never
null
-
createConnectionOperator
Deprecated.Hook for creating the connection operator. It is called by the constructor. Derived classes can override this method to change the instantiation of the operator. The default implementation here instantiatesDefaultClientConnectionOperator
.- Parameters:
schreg
- the scheme registry to use, ornull
- Returns:
- the connection operator to use
-
assertStillUp
Deprecated.Asserts that this manager is not shut down.- Throws:
IllegalStateException
- if this manager is shut down
-
requestConnection
Deprecated.Description copied from interface:ClientConnectionManager
Returns a newClientConnectionRequest
, from which aManagedClientConnection
can be obtained or the request can be aborted.- Specified by:
requestConnection
in interfaceClientConnectionManager
-
getConnection
Deprecated.Obtains a connection.- Parameters:
route
- where the connection should point to- Returns:
- a connection that can be used to communicate along the given route
-
releaseConnection
Deprecated.Description copied from interface:ClientConnectionManager
Releases a connection for use by others. You may optionally specify how long the connection is valid to be reused. Values <= 0 are considered to be valid forever. If the connection is not marked as reusable, the connection will not be reused regardless of the valid duration. If the connection has been released before, the call will be ignored.- Specified by:
releaseConnection
in interfaceClientConnectionManager
- Parameters:
conn
- the connection to releasevalidDuration
- the duration of time this connection is valid for reusetimeUnit
- the unit of time validDuration is measured in- See Also:
-
closeExpiredConnections
public void closeExpiredConnections()Deprecated.Description copied from interface:ClientConnectionManager
Closes all expired connections in the pool. Open connections in the pool that have not been used for the timespan defined when the connection was released will be closed. Currently allocated connections are not subject to this method. Times will be checked with milliseconds precision.- Specified by:
closeExpiredConnections
in interfaceClientConnectionManager
-
closeIdleConnections
Deprecated.Description copied from interface:ClientConnectionManager
Closes idle connections in the pool. Open connections in the pool that have not been used for the timespan given by the argument will be closed. Currently allocated connections are not subject to this method. Times will be checked with milliseconds precision All expired connections will also be closed.- Specified by:
closeIdleConnections
in interfaceClientConnectionManager
- Parameters:
idletime
- the idle time of connections to be closedtimeUnit
- the unit for theidletime
- See Also:
-
shutdown
public void shutdown()Deprecated.Description copied from interface:ClientConnectionManager
Shuts down this connection manager and releases allocated resources. This includes closing all connections, whether they are currently used or not.- Specified by:
shutdown
in interfaceClientConnectionManager
-
revokeConnection
protected void revokeConnection()Deprecated.
-
BasicClientConnectionManager