org.gcube.accounting.persistence

Class AccountingPersistenceBackend

java.lang.Object

org.gcube.accounting.persistence.AccountingPersistenceBackend

Direct Known Subclasses:

FallbackPersistenceBackend

public abstract class AccountingPersistenceBackend
extends Object

Author:

Luca Frosini (ISTI - CNR) http://www.lucafrosini.com/

Field Summary

Fields

Modifier and Type	Field and Description
protected AccountingPersistenceBackendMonitor	accountingPersistenceBackendMonitor
protected AggregationScheduler	aggregationScheduler
protected FallbackPersistenceBackend	fallbackPersistence

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AccountingPersistenceBackend()
protected	AccountingPersistenceBackend(FallbackPersistenceBackend fallback, AggregationScheduler aggregationScheduler)

Method Summary

Methods

Modifier and Type	Method and Description
void	account(SingleUsageRecord usageRecord) Persist the #UsageRecord.
protected void	accountWithFallback(UsageRecord... usageRecords)
abstract void	close()
void	flush(long timeout, TimeUnit timeUnit)
AggregationScheduler	getAggregationScheduler()
FallbackPersistenceBackend	getFallbackPersistence()
protected abstract void	prepareConnection(AccountingPersistenceConfiguration configuration) Prepare the connection to persistence.
protected abstract void	reallyAccount(UsageRecord usageRecords) This method contains the code to save the #UsageRecord
protected void	setAggregationScheduler(AggregationScheduler aggregationScheduler)
protected void	setFallback(FallbackPersistenceBackend fallback)
protected void	validateAccountAggregate(SingleUsageRecord usageRecord, boolean validate, boolean aggregate)

Methods inherited from class java.lang.Object

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

Field Detail

fallbackPersistence

protected FallbackPersistenceBackend fallbackPersistence

aggregationScheduler

protected AggregationScheduler aggregationScheduler

accountingPersistenceBackendMonitor

protected AccountingPersistenceBackendMonitor accountingPersistenceBackendMonitor

Constructor Detail

AccountingPersistenceBackend

protected AccountingPersistenceBackend()

AccountingPersistenceBackend

protected AccountingPersistenceBackend(FallbackPersistenceBackend fallback,
                            AggregationScheduler aggregationScheduler)

Method Detail

getFallbackPersistence

public FallbackPersistenceBackend getFallbackPersistence()

Returns:

the fallbackPersistence

setFallback

protected void setFallback(FallbackPersistenceBackend fallback)

Parameters:

fallback - the fallback to set

getAggregationScheduler

public AggregationScheduler getAggregationScheduler()

Returns:

the aggregationScheduler

setAggregationScheduler

protected void setAggregationScheduler(AggregationScheduler aggregationScheduler)

Parameters:

aggregationScheduler - the aggregationScheduler to set

prepareConnection

protected abstract void prepareConnection(AccountingPersistenceConfiguration configuration)
                                   throws Exception

Prepare the connection to persistence. This method must be used by implementation class to open the connection with the persistence storage, DB, file etc.

Parameters:

configuration - The configuration to create the connection

Throws:

Exception - if fails

reallyAccount

protected abstract void reallyAccount(UsageRecord usageRecords)
                               throws Exception

This method contains the code to save the #UsageRecord

Throws:

Exception

accountWithFallback

protected void accountWithFallback(UsageRecord... usageRecords)

validateAccountAggregate

protected void validateAccountAggregate(SingleUsageRecord usageRecord,
                            boolean validate,
                            boolean aggregate)

account

public void account(SingleUsageRecord usageRecord)
             throws InvalidValueException

Persist the #UsageRecord. The Record is validated first, then accounted, in a separated thread. So that the program can continue the execution. If the persistence fails the class write that the record in a local file so that the #UsageRecord can be recorder later.

Parameters:

usageRecord - the #UsageRecord to persist

Throws:

InvalidValueException - if the Record Validation Fails

flush

public void flush(long timeout,
         TimeUnit timeUnit)
           throws Exception

Throws:

Exception

close

public abstract void close()
                    throws Exception

Throws:

Exception