com.ning.http.client.providers.netty.pool

Interface ChannelPool

All Known Implementing Classes:

DefaultChannelPool, NoopChannelPool

public interface ChannelPool

An interface used by an AsyncHttpProvider for caching http connections.

Method Summary

Methods

Modifier and Type	Method and Description
void	destroy() Destroy all connections that has been cached by this instance.
boolean	isOpen() Return true if a connection can be cached.
boolean	offer(org.jboss.netty.channel.Channel connection, String poolKey) Add a connection to the pool
org.jboss.netty.channel.Channel	poll(String uri) Remove the connection associated with the uri.
boolean	removeAll(org.jboss.netty.channel.Channel connection) Remove all connections from the cache.

Method Detail

offer

boolean offer(org.jboss.netty.channel.Channel connection,
            String poolKey)

Add a connection to the pool

Parameters:

poolKey - a key used to retrieve the cached connection

connection - an I/O connection

Returns:

true if added.

poll

org.jboss.netty.channel.Channel poll(String uri)

Remove the connection associated with the uri.

Parameters:

uri - the uri used when invoking addConnection

Returns:

the connection associated with the uri

removeAll

boolean removeAll(org.jboss.netty.channel.Channel connection)

Remove all connections from the cache. A connection might have been associated with several uri.

Parameters:

connection - a connection

Returns:

the true if the connection has been removed

isOpen

boolean isOpen()

Return true if a connection can be cached. A implementation can decide based on some rules to allow caching Calling this method is equivalent of checking the returned value of ChannelPool#offer(Object, Object)

Returns:

true if a connection can be cached.

destroy

void destroy()

Destroy all connections that has been cached by this instance.