com.guardtime.ksi.service.ha

Class HAService

java.lang.Object

com.guardtime.ksi.service.ha.HAService

All Implemented Interfaces:

KSIExtendingService, KSISigningService, Closeable, AutoCloseable

public class HAService
extends Object
implements KSISigningService, KSIExtendingService

Combines SigningHAService and ExtendingHAService.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HAService.Builder Builds the SigningHAService.

Method Summary

Modifier and Type	Method and Description
void	close() Closes signingHaService and extenderHaService.
Future<ExtensionResponse>	extend(Date aggregationTime, Date publicationTime) Extends existing signatures.
Future<AggregatorConfiguration>	getAggregationConfiguration() Makes the KSISigningService ask for configuration update.
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.
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.
void	registerExtenderConfigurationListener(ConfigurationListener<ExtenderConfiguration> listener) Registers a new ConfigurationListener<ExtenderConfiguration> for the client.
Future<AggregationResponse>	sign(DataHash dataHash, Long level) Creates a new KSI signature.
String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

sign

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

Description copied from interface: KSISigningService

Creates a new KSI signature.

Specified by:

sign in interface KSISigningService

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.

See Also:

SigningHAService.sign(DataHash, Long)

extend

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

Description copied from interface: KSIExtendingService

Extends existing signatures.

Specified by:

extend in interface KSIExtendingService

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.

See Also:

ExtendingHAService.extend(Date, Date)

registerAggregatorConfigurationListener

public void registerAggregatorConfigurationListener(ConfigurationListener<AggregatorConfiguration> listener)

Description copied from interface: KSISigningService

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

Specified by:

registerAggregatorConfigurationListener in interface KSISigningService

Parameters:

listener - an instance of ConfigurationListener<AggregatorConfiguration>.

See Also:

SigningHAService.registerAggregatorConfigurationListener(ConfigurationListener)

getAggregationConfiguration

public Future<AggregatorConfiguration> getAggregationConfiguration()

Description copied from interface: KSISigningService

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

Specified by:

getAggregationConfiguration in interface KSISigningService

Returns:

Future of the AggregatorConfiguration.

See Also:

SigningHAService.getAggregationConfiguration()

registerExtenderConfigurationListener

public void registerExtenderConfigurationListener(ConfigurationListener<ExtenderConfiguration> listener)

Description copied from interface: KSIExtendingService

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

Specified by:

registerExtenderConfigurationListener in interface KSIExtendingService

Parameters:

listener - an instance of ConfigurationListener<ExtenderConfiguration>.

See Also:

ExtendingHAService.registerExtenderConfigurationListener(ConfigurationListener)

getExtendingConfiguration

public Future<ExtenderConfiguration> getExtendingConfiguration()

Description copied from interface: KSIExtendingService

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

Specified by:

getExtendingConfiguration in interface KSIExtendingService

Returns:

Future of the ExtenderConfiguration.

See Also:

ExtendingHAService.getExtendingConfiguration()

getSubSigningServices

public List<KSISigningService> getSubSigningServices()

Description copied from interface: KSISigningService

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.

Specified by:

getSubSigningServices in interface KSISigningService

Returns:

List of subservices.

See Also:

SigningHAService.getSubSigningServices()

getSubExtendingServices

public List<KSIExtendingService> getSubExtendingServices()

Description copied from interface: KSIExtendingService

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.

Specified by:

getSubExtendingServices in interface KSIExtendingService

Returns:

List of subclients.

See Also:

ExtendingHAService.getSubExtendingServices()

close

public void close()

Closes signingHaService and extenderHaService.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

See Also:

SigningHAService.close(), ExtendingHAService.close()

toString

public String toString()

Overrides:

toString in class Object