com.guardtime.ksi.service

Interface KSISigningService

All Superinterfaces:

AutoCloseable, Closeable

All Known Implementing Classes:

HAService, KSISigningClientServiceAdapter, SigningHAService

public interface KSISigningService
extends Closeable

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

Method Summary

Modifier and Type	Method and Description
Future<AggregatorConfiguration>	getAggregationConfiguration() Makes the KSISigningService ask for configuration update.
List<KSISigningService>	getSubSigningServices() Gets all the subservices in case of the implementation that combines multiple KSISigningServices.
void	registerAggregatorConfigurationListener(ConfigurationListener<AggregatorConfiguration> listener) Registers a new ConfigurationListener<AggregatorConfiguration> for the KSISigningService.
Future<AggregationResponse>	sign(DataHash dataHash, Long level) Creates a new KSI signature.

Methods inherited from interface java.io.Closeable

close

Method Detail

sign

Future<AggregationResponse> sign(DataHash dataHash,
                                 Long level)
                          throws KSIException

Creates a new KSI signature.

Parameters:

dataHash - instance of DataHash to be signed.

level - the dataHash's level in the local aggregation tree.

Returns:

Instance of AggregationResponseFuture containing Aggregation response data.

Throws:

KSIException - in case any error occurs.

getSubSigningServices

List<KSISigningService> getSubSigningServices()

Gets all the subservices in case of the implementation that combines multiple KSISigningServices. If the implementation is a KSISigningService connecting directly to a single gateway, an empty list is returned.

Returns:

List of subservices.

registerAggregatorConfigurationListener

void registerAggregatorConfigurationListener(ConfigurationListener<AggregatorConfiguration> listener)

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

Parameters:

listener - an instance of ConfigurationListener<AggregatorConfiguration>.

getAggregationConfiguration

Future<AggregatorConfiguration> getAggregationConfiguration()

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

Returns:

Future of the AggregatorConfiguration.