ConnectionCache (Metro Web Services Runtime OSGi Bundle 3.0.0 API)

All Known Subinterfaces:

InboundConnectionCache<C>, OutboundConnectionCache<C>

All Known Implementing Classes:

ConnectionCacheBase, InboundConnectionCacheBlockingImpl, OutboundConnectionCacheBlockingImpl
```
public interface ConnectionCache<C extends Connection>
```
A connection cache manages a group of connections which may be re-used for sending and receiving messages.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`void`	`close(C conn)`	Close a connection, regardless of its state.
`String`	`getCacheType()`	User-provided indentifier for an instance of the OutboundConnectionCache.
`int`	`highWaterMark()`	Threshold at which connection reclamation begins.
`long`	`numberOfBusyConnections()`	Number of non-idle connections.
`long`	`numberOfConnections()`	Total number of connections currently managed by the cache.
`long`	`numberOfIdleConnections()`	Number of idle connections; that is, connections for which the number of get/release or responseReceived/responseProcessed calls are equal.
`long`	`numberOfReclaimableConnections()`	Number of idle connections that are reclaimable.
`int`	`numberToReclaim()`	Number of connections to reclaim each time reclamation starts.

- Method Detail
  - getCacheType
```
String getCacheType()
```
    User-provided indentifier for an instance of the OutboundConnectionCache.
  - numberOfConnections
```
long numberOfConnections()
```
    Total number of connections currently managed by the cache.
  - numberOfIdleConnections
```
long numberOfIdleConnections()
```
    Number of idle connections; that is, connections for which the number of get/release or responseReceived/responseProcessed calls are equal.
  - numberOfBusyConnections
```
long numberOfBusyConnections()
```
    Number of non-idle connections. Normally, busy+idle==total, but this may not be strictly true due to concurrent updates to the connection cache.
  - numberOfReclaimableConnections
```
long numberOfReclaimableConnections()
```
    Number of idle connections that are reclaimable. Such connections are not in use, and are not waiting to handle any responses.
  - highWaterMark
```
int highWaterMark()
```
    Threshold at which connection reclamation begins.
  - numberToReclaim
```
int numberToReclaim()
```
    Number of connections to reclaim each time reclamation starts.
  - close
```
void close(C conn)
```
    Close a connection, regardless of its state. This may cause requests to fail to be sent, and responses to be lost. Intended for handling serious errors, such as loss of framing on a TCP stream, that require closing the connection.