Package org.apache.http.impl.conn.tsccm

Class ConnPoolByRoute

java.lang.Object

org.apache.http.impl.conn.tsccm.AbstractConnPool

org.apache.http.impl.conn.tsccm.ConnPoolByRoute

@Deprecated
public class ConnPoolByRoute
extends AbstractConnPool

Deprecated.

(4.2) use AbstractConnPool

A connection pool that maintains connections by route. This class is derived from MultiThreadedHttpConnectionManager in HttpClient 3.x, see there for original authors. It implements the same algorithm for connection re-use and connection-per-host enforcement:

• connections are re-used only for the exact same route
• connection limits are enforced per route rather than per host

Note that access to the pool data structures is synchronized via the poolLock in the base class, not via synchronized methods.

Since:

4.0

Constructor Summary

Constructors

Constructor	Description
ConnPoolByRoute(ClientConnectionOperator operator, ConnPerRoute connPerRoute, int maxTotalConnections)	Deprecated. Creates a new connection pool, managed by route.
ConnPoolByRoute(ClientConnectionOperator operator, ConnPerRoute connPerRoute, int maxTotalConnections, long connTTL, java.util.concurrent.TimeUnit connTTLTimeUnit)	Deprecated.
ConnPoolByRoute(ClientConnectionOperator operator, HttpParams params)	Deprecated. (4.1) use ConnPoolByRoute(ClientConnectionOperator, ConnPerRoute, int)

Method Summary

Modifier and Type	Method	Description
void	closeExpiredConnections()	Deprecated.
void	closeIdleConnections(long idletime, java.util.concurrent.TimeUnit timeUnit)	Deprecated. Closes idle connections.
void	deleteClosedConnections()	Deprecated. Deletes all entries for closed connections.
void	freeEntry(BasicPoolEntry entry, boolean reusable, long validDuration, java.util.concurrent.TimeUnit timeUnit)	Deprecated. Returns an entry into the pool.
int	getConnectionsInPool()	Deprecated.
int	getConnectionsInPool(HttpRoute route)	Deprecated.
int	getMaxTotalConnections()	Deprecated. since 4.1
PoolEntryRequest	requestPoolEntry(HttpRoute route, java.lang.Object state)	Deprecated. Returns a new PoolEntryRequest, from which a BasicPoolEntry can be obtained, or the request can be aborted.
void	setMaxTotalConnections(int max)	Deprecated. since 4.1
void	shutdown()	Deprecated. Shuts down this pool and all associated resources.

Methods inherited from class org.apache.http.impl.conn.tsccm.AbstractConnPool

enableConnectionGC, getEntry, handleReference

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ConnPoolByRoute

public ConnPoolByRoute(ClientConnectionOperator operator,
                       ConnPerRoute connPerRoute,
                       int maxTotalConnections)

Deprecated.

Creates a new connection pool, managed by route.

Since:

4.1

ConnPoolByRoute

public ConnPoolByRoute(ClientConnectionOperator operator,
                       ConnPerRoute connPerRoute,
                       int maxTotalConnections,
                       long connTTL,
                       java.util.concurrent.TimeUnit connTTLTimeUnit)

Deprecated.

Since:

4.1

ConnPoolByRoute

@Deprecated
public ConnPoolByRoute(ClientConnectionOperator operator,
                       HttpParams params)

Deprecated.

(4.1) use ConnPoolByRoute(ClientConnectionOperator, ConnPerRoute, int)

Creates a new connection pool, managed by route.

Method Detail

getConnectionsInPool

public int getConnectionsInPool(HttpRoute route)

Deprecated.

getConnectionsInPool

public int getConnectionsInPool()

Deprecated.

requestPoolEntry

public PoolEntryRequest requestPoolEntry(HttpRoute route,
                                         java.lang.Object state)

Deprecated.

Description copied from class: AbstractConnPool

Returns a new PoolEntryRequest, from which a BasicPoolEntry can be obtained, or the request can be aborted.

Specified by:

requestPoolEntry in class AbstractConnPool

Parameters:

route - the route

state - the state

Returns:

the entry request

freeEntry

public void freeEntry(BasicPoolEntry entry,
                      boolean reusable,
                      long validDuration,
                      java.util.concurrent.TimeUnit timeUnit)

Deprecated.

Description copied from class: AbstractConnPool

Returns an entry into the pool. The connection of the entry is expected to be in a suitable state, either open and re-usable, or closed. The pool will not make any attempt to determine whether it can be re-used or not.

Specified by:

freeEntry in class AbstractConnPool

Parameters:

entry - the entry for the connection to release

reusable - true if the entry is deemed reusable, false otherwise.

validDuration - The duration that the entry should remain free and reusable.

timeUnit - The unit of time the duration is measured in.

deleteClosedConnections

public void deleteClosedConnections()

Deprecated.

Description copied from class: AbstractConnPool

Deletes all entries for closed connections.

Specified by:

deleteClosedConnections in class AbstractConnPool

closeIdleConnections

public void closeIdleConnections(long idletime,
                                 java.util.concurrent.TimeUnit timeUnit)

Deprecated.

Closes idle connections.

Overrides:

closeIdleConnections in class AbstractConnPool

Parameters:

idletime - the time the connections should have been idle in order to be closed now

timeUnit - the unit for the idletime

closeExpiredConnections

public void closeExpiredConnections()

Deprecated.

Overrides:

closeExpiredConnections in class AbstractConnPool

shutdown

public void shutdown()

Deprecated.

Description copied from class: AbstractConnPool

Shuts down this pool and all associated resources. Overriding methods MUST call the implementation here!

Overrides:

shutdown in class AbstractConnPool

setMaxTotalConnections

public void setMaxTotalConnections(int max)

Deprecated.

since 4.1

getMaxTotalConnections

public int getMaxTotalConnections()

Deprecated.

since 4.1