net.shibboleth.utilities.java.support.httpclient

Class IdleConnectionSweeper

java.lang.Object

net.shibboleth.utilities.java.support.httpclient.IdleConnectionSweeper

All Implemented Interfaces:

Component, DestructableComponent

public class IdleConnectionSweeper
extends Object
implements DestructableComponent

A utility that periodically closes idle connections held by an HttpClientConnectionManager.

Field Summary

Fields

Modifier and Type	Field and Description
private HttpClientConnectionManager	connectionManager HttpClientConnectionManager whose connections will be swept.
private boolean	createdTimer Whether this sweeper created a TimerTask to use and thus should destroy when destroy() is invoked.
private boolean	destroyed Whether this sweeper has been destroyed.
private long	executionTime Time at which the sweeper last executed.
private TimerTask	sweeper Sweeping task executed by the timer.
private Timer	taskTimer Timer used to schedule and execute the sweeping task.

Constructor Summary

Constructors

Constructor and Description
IdleConnectionSweeper(HttpClientConnectionManager manager, long idleTimeout, long sweepInterval) Constructor.
IdleConnectionSweeper(HttpClientConnectionManager manager, long idleTimeout, long sweepInterval, Timer backgroundTimer) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	destroy() Destroys the component.
boolean	isDestroyed() Gets whether this component has been destroyed.
long	scheduledExecutionTime() Gets the time, in milliseconds since the epoch, when the sweeper last executed or, if it has not yet executed, when it was first scheduled to run.

Methods inherited from class java.lang.Object

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

Field Detail

destroyed

private boolean destroyed

Whether this sweeper has been destroyed.

createdTimer

private boolean createdTimer

Whether this sweeper created a TimerTask to use and thus should destroy when destroy() is invoked.

connectionManager

private final HttpClientConnectionManager connectionManager

HttpClientConnectionManager whose connections will be swept.

taskTimer

private final Timer taskTimer

Timer used to schedule and execute the sweeping task.

sweeper

private final TimerTask sweeper

Sweeping task executed by the timer.

executionTime

@Nullable
private long executionTime

Time at which the sweeper last executed.

Constructor Detail

IdleConnectionSweeper

public IdleConnectionSweeper(@Nonnull
                     HttpClientConnectionManager manager,
                     long idleTimeout,
                     long sweepInterval)

Constructor. This method will create a daemon Timer and use it to periodically sweep connections.

Parameters:

manager - HTTP client connection manager whose connections will be swept

idleTimeout - length of time, in milliseconds, connection may be idle before being closed down

sweepInterval - length of time, in milliseconds, between sweeps

IdleConnectionSweeper

public IdleConnectionSweeper(@Nonnull
                     HttpClientConnectionManager manager,
                     long idleTimeout,
                     long sweepInterval,
                     @Nonnull
                     Timer backgroundTimer)

Constructor.

Parameters:

manager - HTTP client connection manager whose connections will be swept

idleTimeout - length of time, in milliseconds, connection may be idle before being closed down

sweepInterval - length of time, in milliseconds, between sweeps

backgroundTimer - timer used to schedule the background sweeping task

Method Detail

scheduledExecutionTime

public long scheduledExecutionTime()

Gets the time, in milliseconds since the epoch, when the sweeper last executed or, if it has not yet executed, when it was first scheduled to run.

Returns:

the time when the sweeper last executed or when it was first scheduled to run

isDestroyed

public boolean isDestroyed()

Gets whether this component has been destroyed. Normally, once a component has been destroyed it cannot be used.

Specified by:

isDestroyed in interface DestructableComponent

Returns:

true iff the component has been destroyed

destroy

public void destroy()

Destroys the component.

Specified by:

destroy in interface DestructableComponent