lumis.portal.bigdata

Interface IDocumentPopularityProvider

All Known Implementing Classes:

DummyDocumentPopularityProvider, StandardDocumentPopularityProvider

@StableMinor(version="12.0",
             sinceVersion="11.1")
public interface IDocumentPopularityProvider

Provides popularity for Big Data standard documents.

Since:

11.1.0

Version:

$Revision: 23034 $ $Date: 2019-08-05 19:52:47 +0000 (Mon, 05 Aug 2019) $

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	IDocumentPopularityProvider.DocumentPopularityKey Represents a key for popularities map.

Method Summary

Modifier and Type	Method and Description
Map<IDocumentPopularityProvider.DocumentPopularityKey,Double>	calculateDocumentPopularities() Returns a list of documents popularities.
double	calculateDocumentPopularity(StandardDocument document) Returns the popularity for the given document.

Method Detail

calculateDocumentPopularities

Map<IDocumentPopularityProvider.DocumentPopularityKey,Double> calculateDocumentPopularities()
                                                                                     throws PortalException,
                                                                                            TransactionRequiredException

Returns a list of documents popularities.
Each entry of the given map is consisted in: a standard document's item identifier, used as the entry's key; and a double value, used as the document's popularity.

Both, key and value must not be null and the value must be a positive finite number.
A popularity between 0 and 1 decrease the score the document would have during a search. A popularity of 1 does not alter the score the document would have during search. A popularity greater than 1 increase the score the document would have during search.

The returned map must not be null.

Returns:

a list of documents popularities.

Throws:

TransactionRequiredException - if there's no active transaction.

PortalException - if some error occur during calculation.

Since:

11.1.0

calculateDocumentPopularity

double calculateDocumentPopularity(StandardDocument document)
                            throws PortalException,
                                   TransactionRequiredException,
                                   IllegalArgumentException

Returns the popularity for the given document. The returned value must be a positive finite number. A popularity between 0 and 1 decrease the score the document would have during a search. A popularity of 1 does not alter the score the document would have during search. A popularity greater than 1 increase the score the document would have during search.

Parameters:

document - the document.

Returns:

the popularity for the given document.

Throws:

IllegalArgumentException - if the given document is null.

TransactionRequiredException - if there's no active transaction.

PortalException - if some error occur during calculation.

Since:

11.1.0