org.gcube.accounting.analytics.persistence

Interface AccountingPersistenceBackendQuery

All Known Implementing Classes:

AccountingPersistenceQuery

public interface AccountingPersistenceBackendQuery

Author:

Luca Frosini (ISTI - CNR)

Field Summary

Fields

Modifier and Type	Field and Description
static int	KEY_VALUES_LIMIT

Method Summary

Modifier and Type	Method and Description
void	close() Close the connection to persistence
SortedMap<Filter,SortedMap<Calendar,Info>>	getContextTimeSeries(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz, TemporalConstraint temporalConstraint, List<Filter> filters, List<String> contexts) Return a SortedMap containing the TimeSeries for each context.
SortedSet<NumberedFilter>	getFilterValues(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz, TemporalConstraint temporalConstraint, List<Filter> filters, String key)
SortedSet<NumberedFilter>	getFilterValues(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz, TemporalConstraint temporalConstraint, List<Filter> filters, String key, Integer limit)
SortedMap<Calendar,Info>	getNoContextTimeSeries(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz, TemporalConstraint temporalConstraint, List<Filter> filters) Query the persistence obtaining a Map where the date is the key and the #Info is the value.
org.gcube.documentstore.records.Record	getRecord(String recordId, String type)
static String	getScopeToQuery()
SortedSet<String>	getSpaceProvidersIds()
SortedMap<Filter,SortedMap<Calendar,Long>>	getSpaceTimeSeries(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz, TemporalConstraint temporalConstraint, List<Filter> filters, List<String> providersId)
SortedMap<Calendar,Info>	getTimeSeries(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz, TemporalConstraint temporalConstraint, List<Filter> filters) Query the persistence obtaining a Map where the date is the key and the #Info is the value.
SortedMap<NumberedFilter,SortedMap<Calendar,Info>>	getTopValues(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz, TemporalConstraint temporalConstraint, List<Filter> filters, String topKey, String orderingProperty) Return a SortedMap containing the TimeSeries for top values for a certain key taking in account all Filters.
List<UsageValue>	getUsageValueQuotaTotal(List<UsageValue> listUsage) getUsageValueQuotaTotal Example for crequire 2 different quota (lucio.lelii for service and alessandro.pieve for storage) Input: [ TotalFilters [ clz=class org.gcube.accounting.datamodel.aggregation.AggregatedServiceUsageRecord, temporalConstraint=StartTime : 2015-05-01 11:42:34:515 UTC (1430480554515 millis), EndTime : 2016-11-09 11:42:34:515 UTC (1478691754515 millis), Aggregated DAILY, totalFilters=[ Filters [filters=[ { "consumerId" : "lucio.lelii" }, { "serviceClass" : "DataAccess" }, { "serviceName" : "CkanConnector" } ], d=null, orderingProperty=null], Filters [filters=[ { "consumerId" : "lucio.lelii" }, { "serviceClass" : "VREManagement" } ], d=null, orderingProperty=null] ], d=null, orderingProperty=null] ] Output: [ TotalFilters [ clz=class org.gcube.accounting.datamodel.aggregation.AggregatedServiceUsageRecord, temporalConstraint=StartTime : 2015-05-01 11:42:34:515 UTC (1430480554515 millis), EndTime : 2016-11-09 11:42:34:515 UTC (1478691754515 millis), Aggregated DAILY, totalFilters=[ Filters [filters=[ { "consumerId" : "lucio.lelii" }, { "serviceClass" : "DataAccess" }, { "serviceName" : "CkanConnector" } ], d=1.0, orderingProperty=operationCount], Filters [filters=[ { "consumerId" : "lucio.lelii" }, { "serviceClass" : "VREManagement" } ], d=1.0, orderingProperty=operationCount] ], d=2.0, orderingProperty=null] ]
boolean	isConnectionActive()
void	prepareConnection(AccountingPersistenceBackendQueryConfiguration configuration)

Field Detail

KEY_VALUES_LIMIT

static final int KEY_VALUES_LIMIT

See Also:

Constant Field Values

Method Detail

getScopeToQuery

static String getScopeToQuery()

prepareConnection

void prepareConnection(AccountingPersistenceBackendQueryConfiguration configuration)
                throws Exception

Throws:

Exception

getTimeSeries

SortedMap<Calendar,Info> getTimeSeries(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz,
                                       TemporalConstraint temporalConstraint,
                                       List<Filter> filters)
                                throws DuplicatedKeyFilterException,
                                       KeyException,
                                       ValueException,
                                       Exception

Query the persistence obtaining a Map where the date is the key and the #Info is the value. The result is relative to an Usage Record Type, respect a TemporalConstraint and can be applied one or more filters.

Parameters:

clz - the Record Class of interest

temporalConstraint - the TemporalConstraint (interval and aggregation)

filters - list of filter to obtain the time series. If null or empty list get all data for the interested Record Class with the applying temporal constraint. All Filter must have not null and not empty key and value. The filters are must be related to different keys and are in AND. If the list contains more than one filter with the same key an Exception is thrown.

Returns:

the Map containing for each date in the required interval the requested data

Throws:

DuplicatedKeyFilterException

KeyException

ValueException

Exception

getNoContextTimeSeries

SortedMap<Calendar,Info> getNoContextTimeSeries(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz,
                                                TemporalConstraint temporalConstraint,
                                                List<Filter> filters)
                                         throws DuplicatedKeyFilterException,
                                                KeyException,
                                                ValueException,
                                                Exception

Query the persistence obtaining a Map where the date is the key and the #Info is the value. The result is relative to an Usage Record Type, respect a TemporalConstraint and can be applied one or more filters. Used for no context call

Parameters:

clz - the Record Class of interest

temporalConstraint - the TemporalConstraint (interval and aggregation)

filters - list of filter to obtain the time series. If null or empty list get all data for the interested Record Class with the applying temporal constraint. All Filter must have not null and not empty key and value. The filters are must be related to different keys and are in AND. If the list contains more than one filter with the same key an Exception is thrown.

Returns:

the Map containing for each date in the required interval the requested data

Throws:

DuplicatedKeyFilterException

KeyException

ValueException

Exception

getTopValues

SortedMap<NumberedFilter,SortedMap<Calendar,Info>> getTopValues(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz,
                                                                TemporalConstraint temporalConstraint,
                                                                List<Filter> filters,
                                                                String topKey,
                                                                String orderingProperty)
                                                         throws DuplicatedKeyFilterException,
                                                                KeyException,
                                                                ValueException,
                                                                Exception

Return a SortedMap containing the TimeSeries for top values for a certain key taking in account all Filters. The key is identified adding a Filter with a null value. Only one Filter with null value is allowed otherwise an Exception is thrown. The values are ordered from the most occurred value.

Parameters:

clz - the Usage Record Class of interest

temporalConstraint - the TemporalConstraint (interval and aggregation)

filters - list of filter to obtain the time series of top values. If null or empty list get all data for the interested Record Class with the applying temporal constraint. All Filter must have not null and not empty key and value. The filters are must be related to different keys and are in AND. If the list contains more than one filter with the same key an Exception is thrown.

topKey -

orderingProperty -

Returns:

a SortedMap

Throws:

DuplicatedKeyFilterException

KeyException

ValueException

Exception

close

void close()
    throws Exception

Close the connection to persistence

Throws:

Exception - if the close fails

getFilterValues

SortedSet<NumberedFilter> getFilterValues(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz,
                                          TemporalConstraint temporalConstraint,
                                          List<Filter> filters,
                                          String key)
                                   throws Exception

Throws:

Exception

getFilterValues

SortedSet<NumberedFilter> getFilterValues(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz,
                                          TemporalConstraint temporalConstraint,
                                          List<Filter> filters,
                                          String key,
                                          Integer limit)
                                   throws Exception

Throws:

Exception

getUsageValueQuotaTotal

List<UsageValue> getUsageValueQuotaTotal(List<UsageValue> listUsage)
                                  throws Exception

getUsageValueQuotaTotal Example for crequire 2 different quota (lucio.lelii for service and alessandro.pieve for storage) Input: [ TotalFilters [ clz=class org.gcube.accounting.datamodel.aggregation.AggregatedServiceUsageRecord, temporalConstraint=StartTime : 2015-05-01 11:42:34:515 UTC (1430480554515 millis), EndTime : 2016-11-09 11:42:34:515 UTC (1478691754515 millis), Aggregated DAILY, totalFilters=[ Filters [filters=[ { "consumerId" : "lucio.lelii" }, { "serviceClass" : "DataAccess" }, { "serviceName" : "CkanConnector" } ], d=null, orderingProperty=null], Filters [filters=[ { "consumerId" : "lucio.lelii" }, { "serviceClass" : "VREManagement" } ], d=null, orderingProperty=null] ], d=null, orderingProperty=null] ] Output: [ TotalFilters [ clz=class org.gcube.accounting.datamodel.aggregation.AggregatedServiceUsageRecord, temporalConstraint=StartTime : 2015-05-01 11:42:34:515 UTC (1430480554515 millis), EndTime : 2016-11-09 11:42:34:515 UTC (1478691754515 millis), Aggregated DAILY, totalFilters=[ Filters [filters=[ { "consumerId" : "lucio.lelii" }, { "serviceClass" : "DataAccess" }, { "serviceName" : "CkanConnector" } ], d=1.0, orderingProperty=operationCount], Filters [filters=[ { "consumerId" : "lucio.lelii" }, { "serviceClass" : "VREManagement" } ], d=1.0, orderingProperty=operationCount] ], d=2.0, orderingProperty=null] ]

Parameters:

listUsage -

Returns:

List

Throws:

Exception

getContextTimeSeries

SortedMap<Filter,SortedMap<Calendar,Info>> getContextTimeSeries(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz,
                                                                TemporalConstraint temporalConstraint,
                                                                List<Filter> filters,
                                                                List<String> contexts)
                                                         throws Exception

Return a SortedMap containing the TimeSeries for each context.

Parameters:

clz -

temporalConstraint -

filters -

contexts -

Returns:

a SortedMap containing the TimeSeries for each context.

Throws:

Exception

getRecord

org.gcube.documentstore.records.Record getRecord(String recordId,
                                                 String type)
                                          throws Exception

Throws:

Exception

getSpaceProvidersIds

SortedSet<String> getSpaceProvidersIds()
                                throws Exception

Throws:

Exception

getSpaceTimeSeries

SortedMap<Filter,SortedMap<Calendar,Long>> getSpaceTimeSeries(Class<? extends org.gcube.documentstore.records.AggregatedRecord<?,?>> clz,
                                                              TemporalConstraint temporalConstraint,
                                                              List<Filter> filters,
                                                              List<String> providersId)
                                                       throws Exception

Throws:

Exception

isConnectionActive

boolean isConnectionActive()
                    throws Exception

Throws:

Exception