net.shibboleth.idp.service

Interface ReloadableService<T>

Type Parameters:

T - The sort of service that this implements

All Superinterfaces:

Lifecycle

All Known Implementing Classes:

AbstractReloadableService, LogbackLoggingService, ReloadableSpringService

public interface ReloadableService<T>
extends Lifecycle

A service that supports reloading its configuration.

Method Summary

Methods

Modifier and Type	Method and Description
DateTime	getLastReloadAttemptInstant() Gets the time when the service last attempted to reload.
DateTime	getLastSuccessfulReloadInstant() Gets the time when the service was last successfully reloaded.
Throwable	getReloadFailureCause() Gets the reason the last reload failed.
ServiceableComponent<T>	getServiceableComponent() Get the serviceable component that this service supports .
void	reload() Reloads the configuration of the service.

Methods inherited from interface org.springframework.context.Lifecycle

isRunning, start, stop

Method Detail

getLastSuccessfulReloadInstant

@Nullable
DateTime getLastSuccessfulReloadInstant()

Gets the time when the service was last successfully reloaded.

Returns:

time when the service was last successfully reloaded

getLastReloadAttemptInstant

@Nullable
DateTime getLastReloadAttemptInstant()

Gets the time when the service last attempted to reload. If the reload was successful this time should match the time given by getLastSuccessfulReloadInstant().

Returns:

time when the service last attempted to reload

getReloadFailureCause

@Nullable
Throwable getReloadFailureCause()

Gets the reason the last reload failed.

Returns:

reason the last reload failed or null if the last reload was successful

reload

void reload()
            throws ServiceException

Reloads the configuration of the service. Whether internal state is maintained between reloads is implementation dependent.

Throws:

ServiceException - thrown if there is a problem reloading the service

getServiceableComponent

@Nullable
ServiceableComponent<T> getServiceableComponent()

Get the serviceable component that this service supports . If The component hasn't been successfully loaded yet or if this service does not support a ServiceableComponent return null

Returns:

the component, if appropriate.