org.exoplatform.kudos.service

Class KudosService

java.lang.Object

org.exoplatform.kudos.service.KudosService

All Implemented Interfaces:

ExoKudosStatisticService, org.picocontainer.Startable

public class KudosService
extends Object
implements ExoKudosStatisticService, org.picocontainer.Startable

A service to manage kudos

Constructor Summary

Constructors

Constructor and Description
KudosService(KudosStorage kudosStorage, org.exoplatform.commons.api.settings.SettingService settingService, org.exoplatform.social.core.space.spi.SpaceService spaceService, org.exoplatform.social.core.manager.IdentityManager identityManager, org.exoplatform.services.listener.ListenerService listenerService, org.exoplatform.container.xml.InitParams params)

Method Summary

Modifier and Type	Method and Description
long	countKudosByEntity(String entityType, String entityId)
long	countKudosByEntityAndSender(String entityType, String entityId, String senderIdentityId) Count kudos sent by an identity using a dedicated entity (activity, comment, profile header, tiptip...)
long	countKudosByPeriodAndReceiver(long identityId, long startDateInSeconds, long endDateInSeconds) Count kudos received by an identity in a period of time
long	countKudosByPeriodAndSender(long senderIdentityId, long startDateInSeconds, long endDateInSeconds) Count kudos sent by an identity in a period of time
Kudos	createKudos(Kudos kudos, String currentUser) Create a new Kudos sent by current user
AccountSettings	getAccountSettings(String username)
KudosPeriod	getCurrentKudosPeriod()
KudosPeriodType	getDefaultKudosPeriodType()
GlobalSettings	getGlobalSettings()
List<Kudos>	getKudosByEntity(String entityType, String entityId, int limit) Retrieves a list of kudos sent using a dedicated entity (activity, comment, profile header, tiptip...)
List<Kudos>	getKudosByPeriod(long dateInSeconds, KudosPeriodType periodType, int limit) Retrieves the list of kudos sent in a period of time.
List<Kudos>	getKudosByPeriod(long startDateInSeconds, long endDateInSeconds, int limit) Retrieves the list of kudos sent in a period of time.
List<Kudos>	getKudosByPeriodAndReceiver(long identityId, long startDateInSeconds, long endDateInSeconds, int limit) Retrieves kudos received by an identity in a period of time
List<Kudos>	getKudosByPeriodAndSender(long senderIdentityId, long startDateInSeconds, long endDateInSeconds, int limit) Retrieves Kudos list by sender identity Id
List<Kudos>	getKudosByPeriodOfDate(long dateInSeconds, int limit) Retrieves the list of kudos sent in a period of time.
KudosPeriod	getKudosPeriodOfTime(KudosPeriodType periodType, long dateInSeconds)
KudosPeriod	getKudosPeriodOfTime(long dateInSeconds)
Map<String,Object>	getStatisticParameters(String operation, Object result, Object... methodArgs) Retrieve statistic log parameters
boolean	isAuthorizedOnKudosModule(String username) Check if user is authorized to send/receive Kudos
void	saveGlobalSettings(GlobalSettings settings) Stores new parameters of Kudos module
void	start()
void	stop()
void	updateKudosGeneratedActivityId(long kudosId, long activityId) Stores generated activity for created Kudos

Methods inherited from class java.lang.Object

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

Constructor Detail

KudosService

public KudosService(KudosStorage kudosStorage,
                    org.exoplatform.commons.api.settings.SettingService settingService,
                    org.exoplatform.social.core.space.spi.SpaceService spaceService,
                    org.exoplatform.social.core.manager.IdentityManager identityManager,
                    org.exoplatform.services.listener.ListenerService listenerService,
                    org.exoplatform.container.xml.InitParams params)

Method Detail

start

public void start()

Specified by:

start in interface org.picocontainer.Startable

stop

public void stop()

Specified by:

stop in interface org.picocontainer.Startable

getGlobalSettings

public GlobalSettings getGlobalSettings()

Returns:

GlobalSettings of Kudos module

saveGlobalSettings

public void saveGlobalSettings(GlobalSettings settings)

Stores new parameters of Kudos module

Parameters:

settings - GlobalSettings

getAccountSettings

public AccountSettings getAccountSettings(String username)

Parameters:

username - username to get its settings

Returns:

kudos settings of a user

createKudos

public Kudos createKudos(Kudos kudos,
                         String currentUser)
                  throws Exception

Create a new Kudos sent by current user

Parameters:

kudos - Kudos to create

currentUser - username of current user

Returns:

created Kudos

Throws:

Exception - when receiver or sender aren't allowed.

updateKudosGeneratedActivityId

public void updateKudosGeneratedActivityId(long kudosId,
                                           long activityId)
                                    throws Exception

Stores generated activity for created Kudos

Parameters:

kudosId - Kudos technical identifier

activityId - ExoSocialActivity technical identifier

Throws:

Exception - when an error happens when broadcasting event or saving activityId of Kudos

getKudosByPeriod

public List<Kudos> getKudosByPeriod(long startDateInSeconds,
                                    long endDateInSeconds,
                                    int limit)

Retrieves the list of kudos sent in a period of time.

Parameters:

startDateInSeconds - timestamp in seconds

endDateInSeconds - timestamp in seconds

limit - limit of results size to retrieve

Returns:

List of Kudos

getKudosByPeriod

public List<Kudos> getKudosByPeriod(long dateInSeconds,
                                    KudosPeriodType periodType,
                                    int limit)

Retrieves the list of kudos sent in a period of time.

Parameters:

dateInSeconds - timestamp in seconds

periodType - KudosPeriodType used to compute real start and end dates of period

limit - limit of results size to retrieve

Returns:

List of Kudos

getKudosByPeriodOfDate

public List<Kudos> getKudosByPeriodOfDate(long dateInSeconds,
                                          int limit)

Retrieves the list of kudos sent in a period of time. Configured Period Type is retrieved from GlobalSettings

Parameters:

dateInSeconds - timestamp in seconds to compute real start and end dates of period

limit - limit of results size to retrieve

Returns:

List of Kudos

getKudosByEntity

public List<Kudos> getKudosByEntity(String entityType,
                                    String entityId,
                                    int limit)

Retrieves a list of kudos sent using a dedicated entity (activity, comment, profile header, tiptip...)

Parameters:

entityType - entity type of type KudosEntityType

entityId - entity technical id

limit - limit of results size to retrieve

Returns:

List of Kudos

countKudosByEntity

public long countKudosByEntity(String entityType,
                               String entityId)

countKudosByEntityAndSender

public long countKudosByEntityAndSender(String entityType,
                                        String entityId,
                                        String senderIdentityId)

Count kudos sent by an identity using a dedicated entity (activity, comment, profile header, tiptip...)

Parameters:

entityType - entity type of type KudosEntityType

entityId - entity technical id

senderIdentityId - Identity technical id

Returns:

0 if identity not found, else kudos count

countKudosByPeriodAndSender

public long countKudosByPeriodAndSender(long senderIdentityId,
                                        long startDateInSeconds,
                                        long endDateInSeconds)

Count kudos sent by an identity in a period of time

Parameters:

senderIdentityId - Identity technical id

startDateInSeconds - timestamp in seconds

endDateInSeconds - timestamp in seconds

Returns:

0 if identity not found, else kudos count

getKudosByPeriodAndSender

public List<Kudos> getKudosByPeriodAndSender(long senderIdentityId,
                                             long startDateInSeconds,
                                             long endDateInSeconds,
                                             int limit)

Retrieves Kudos list by sender identity Id

Parameters:

senderIdentityId - Identity technical id of sender

startDateInSeconds - timestamp in seconds

endDateInSeconds - timestamp in seconds

limit - limit of results size to retrieve

Returns:

List of Kudos

countKudosByPeriodAndReceiver

public long countKudosByPeriodAndReceiver(long identityId,
                                          long startDateInSeconds,
                                          long endDateInSeconds)

Count kudos received by an identity in a period of time

Parameters:

identityId - Identity technical id

startDateInSeconds - timestamp in seconds

endDateInSeconds - timestamp in seconds

Returns:

0 if identity not found, else kudos count

getKudosByPeriodAndReceiver

public List<Kudos> getKudosByPeriodAndReceiver(long identityId,
                                               long startDateInSeconds,
                                               long endDateInSeconds,
                                               int limit)

Retrieves kudos received by an identity in a period of time

Parameters:

identityId - Identity technical id

startDateInSeconds - timestamp in seconds

endDateInSeconds - timestamp in seconds

limit - limit of results size to retrieve

Returns:

List of Kudos. An empty list will be returned if the identity is not found.

isAuthorizedOnKudosModule

public boolean isAuthorizedOnKudosModule(String username)

Check if user is authorized to send/receive Kudos

Parameters:

username - username to check

Returns:

true if authorised else return false

getStatisticParameters

public Map<String,Object> getStatisticParameters(String operation,
                                                 Object result,
                                                 Object... methodArgs)

Description copied from interface: ExoKudosStatisticService

Retrieve statistic log parameters

Specified by:

getStatisticParameters in interface ExoKudosStatisticService

Returns:

a Map of parameters to include in statistic log

getDefaultKudosPeriodType

public KudosPeriodType getDefaultKudosPeriodType()

getCurrentKudosPeriod

public KudosPeriod getCurrentKudosPeriod()

getKudosPeriodOfTime

public KudosPeriod getKudosPeriodOfTime(long dateInSeconds)

getKudosPeriodOfTime

public KudosPeriod getKudosPeriodOfTime(KudosPeriodType periodType,
                                        long dateInSeconds)