com.guardtime.ksi.service

Interface KSIExtendingService

All Superinterfaces:

AutoCloseable, Closeable

All Known Implementing Classes:

ExtendingHAService, HAService, KSIExtendingClientServiceAdapter

public interface KSIExtendingService
extends Closeable

Provides KSI services to communicate with the extender(s).

Method Summary

Modifier and Type	Method and Description
Future<ExtensionResponse>	extend(Date aggregationTime, Date publicationTime) Extends existing signatures.
Future<ExtenderConfiguration>	getExtendingConfiguration() Makes the client ask for configuration update.
List<KSIExtendingService>	getSubExtendingServices() Gets the subclients in case of the implementation that combines multiple clients.
void	registerExtenderConfigurationListener(ConfigurationListener<ExtenderConfiguration> listener) Registers a new ConfigurationListener<ExtenderConfiguration> for the client.

Methods inherited from interface java.io.Closeable

close

Method Detail

extend

Future<ExtensionResponse> extend(Date aggregationTime,
                                 Date publicationTime)
                          throws KSIException

Extends existing signatures.

Parameters:

aggregationTime - aggregation time of the existing signature.

publicationTime - publication time to which the existing signature is to be extended.

Returns:

Instance of ExtensionResponseFuture containing calendar chains needed to extend the signature.

Throws:

KSIException - in case any error occurs.

getSubExtendingServices

List<KSIExtendingService> getSubExtendingServices()

Gets the subclients in case of the implementation that combines multiple clients. If the implementation is a client that directly connects to a single gateway, an empty list will be returned.

Returns:

List of subclients.

registerExtenderConfigurationListener

void registerExtenderConfigurationListener(ConfigurationListener<ExtenderConfiguration> listener)

Registers a new ConfigurationListener<ExtenderConfiguration> for the client. Each time client's configuration is updated, this listener is called.

Parameters:

listener - an instance of ConfigurationListener<ExtenderConfiguration>.

getExtendingConfiguration

Future<ExtenderConfiguration> getExtendingConfiguration()

Makes the client ask for configuration update. On completion of the update registered ConfigurationListeners are called.

Returns:

Future of the ExtenderConfiguration.