com.jalios.jcms.recommendation
Class RecommendationManager

java.lang.Object
  com.jalios.jcms.recommendation.RecommendationManager

All Implemented Interfaces:

DBConstants, RecommendationConstants, JPropertiesListener

public class RecommendationManager
extends Object
implements RecommendationConstants, DBConstants, JPropertiesListener

This class gives Utils to handle Recommendation

Since:

jcms-8.0.0

Version:

$Revision: 47776 $

Author:

Kevin Bransard

Field Summary

static String

REVISION

Fields inherited from interface com.jalios.jcms.recommendation.RecommendationConstants

ALERT_DOMAIN, ALERT_NAME, CDATE_DESC_FIELD, DATA_ID_FIELD, GROUP_ID_SET_FIELD, GROUP_TABLE_ALIAS, OVERRIDE_ALERT_NAME_PROP, OVERRIDE_MODAL_TEXT_PROP, RECIPIENT_ID_SET_FIELD, RECIPIENT_TABLE_ALIAS, RECOMMENDATION_ENABLED_PROP, TTCARD_GROUP_REGEXP, VALUE_FIELD

Fields inherited from interface com.jalios.jcms.db.DBConstants

ALL_CATEGORIES_SET_FIELD, AUTH_GRP_SET_FIELD, AUTH_MBR_SET_FIELD, AUTHOR_ID_FIELD, CATEGORIES_SET_FIELD, CDATE_FIELD, CHANNEL_JCMSDB_PROP, DBDATA_URID, HAS_NO_READ_RIGHTS, HIBERNATE_MAPPING_ADATE, HIBERNATE_MAPPING_AUTHOR, HIBERNATE_MAPPING_CDATE, HIBERNATE_MAPPING_EDATE, HIBERNATE_MAPPING_MDATE, HIBERNATE_MAPPING_PDATE, HIBERNATE_MAPPING_PSTATUS, HIBERNATE_MAPPING_TITLE, HIBERNATE_MAPPING_WORKFLOW_ID, HIBERNATE_MAPPING_WORKSPACE_ID, MDATE_FIELD, PSTATUS_FIELD, ROW_ID_FIELD, SCROLL_FETCH_SIZE, WORKFLOW_ID_FIELD, WORKSPACE_ID_FIELD

Method Summary

boolean	canBeRecommended(Data data)
boolean	canBeRecommendedBy(Data data, Member mbr)
void	deleteAllRecommendation(Data data) Deletes all the recommendation attached to the given Data.
String	getAddRecommendationLink(Data data, String css, String body, String userLang) Returns the link to add a recommendation on a data
String	getAlertName(Data data) Returns the alert name for a given data, in order to override the default alert name for Recommendation
static RecommendationManager	getInstance()
String	getModalText(Data data, String userLang) Returns the alert name for a given data, in order to override the default alert name for Recommendation
int	getReceivedRecommendationCount(Data data, Member mbr) Returns the count of Recommendation on given Data that given Member has received ordered by date desc
int	getReceivedRecommendationCount(Member mbr) Returns the count of Recommendation where given member is a recipient ordered by date desc
Set<Recommendation>	getReceivedRecommendationSet(Data data, Member mbr) Returns the List of Recommendation on given Data, where given member is a recipient ordered by date desc
Set<Recommendation>	getReceivedRecommendationSet(Data data, Set<Member> recipientSet) Returns the List of Recommendation on given Data, where given member are recipient ordered by date desc
Set<Recommendation>	getReceivedRecommendationSet(Member mbr) Returns the List of Recommendation where given member is a recipient ordered by date desc
int	getRecommendationCount(Data data) Returns the count Recommendation for given Data
List<Recommendation>	getRecommendationList(Data data) Returns the List of Recommendation for given Data ordered by date desc
int	getRecommendationReaderTrackingMemberCount(Recommendation recommendation)
List<ReaderTracker>	getRecommendationReaderTrackingMemberSet(Recommendation recommendation) Returns a List of ReaderTracker which have read the recommendation's Publication yet since the recommendation has been sent
int	getSentRecommendationCount(Data data, Member mbr) Returns the count of Recommendation on given Data the given Member has made
int	getSentRecommendationCount(Member mbr) Returns the count of Recommendation for given Member
List<Recommendation>	getSentRecommendationList(Data data, Member mbr) Returns the List of Recommendation on given Data the given Member has sent ordered by date desc
List<Recommendation>	getSentRecommendationList(Member mbr) Returns the List of Recommendation for given Member ordered by date desc
int	getTotalRecipientCount(Recommendation recommendation)
boolean	isDataTracked(Recommendation recommendation)
boolean	isGroupContainsMember(Set<Group> groupSet)
boolean	isRecommendationEnabled()
void	printAddRecommendationLinkEnd(StringBuilder sb) Prints the end of the link for Recommendation
void	printRecommendationLinkStart(StringBuilder sb, Data data, String css, String userLang) Prints the start of the link for Recommendation
void	propertiesChange(JProperties properties) Invoked after properties have been modified in JCMS and save on disk.
void	sendRecommendation(Recommendation recommendation, boolean isAuthorRecipient) Sends the given recommendation

Methods inherited from class java.lang.Object

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

Field Detail

REVISION

public static final String REVISION

See Also:

Constant Field Values

Method Detail

getInstance

public static RecommendationManager getInstance()

propertiesChange

public void propertiesChange(JProperties properties)

Description copied from interface: JPropertiesListener

Invoked after properties have been modified in JCMS and save on disk.

You cannot alter the value received in parameters.

Specified by:

propertiesChange in interface JPropertiesListener

Parameters:

properties - the properties which have been modified (may not contain all JCMS properties)

sendRecommendation

public void sendRecommendation(Recommendation recommendation,
                               boolean isAuthorRecipient)

Sends the given recommendation

Parameters:

isAuthorRecipient - defines if author should receive the recommendation too

recommendation - the Recommendation

Since:

jcms-8.0.0

getAlertName

public String getAlertName(Data data)

Returns the alert name for a given data, in order to override the default alert name for Recommendation

Parameters:

data - the Data

Returns:

the alert name for a given data

getModalText

public String getModalText(Data data,
                           String userLang)

Returns the alert name for a given data, in order to override the default alert name for Recommendation

Parameters:

data - the Data

Returns:

the alert name for a given data

getRecommendationCount

public int getRecommendationCount(Data data)

Returns the count Recommendation for given Data

Parameters:

data - the Data

Returns:

the count of Recommendation for given Data

Since:

jcms-8.0.0

getRecommendationList

public List<Recommendation> getRecommendationList(Data data)

Returns the List of Recommendation for given Data ordered by date desc

Parameters:

data - the Data

Returns:

the List of Recommendation for given Data ordered by date desc

Since:

jcms-8.0.0

getSentRecommendationCount

public int getSentRecommendationCount(Member mbr)

Returns the count of Recommendation for given Member

Parameters:

mbr - the Member

Returns:

the count of Recommendation for given Member

Since:

jcms-8.0.0

getSentRecommendationCount

public int getSentRecommendationCount(Data data,
                                      Member mbr)

Returns the count of Recommendation on given Data the given Member has made

Parameters:

data - the Data

mbr - the Member

Returns:

the count of Recommendation on given Data the given Member has made

Since:

jcms-8.0.0

getSentRecommendationList

public List<Recommendation> getSentRecommendationList(Member mbr)

Returns the List of Recommendation for given Member ordered by date desc

Parameters:

mbr - the Member

Returns:

the List of Recommendation for given Member ordered by date desc

Since:

jcms-8.0.0

getSentRecommendationList

public List<Recommendation> getSentRecommendationList(Data data,
                                                      Member mbr)

Returns the List of Recommendation on given Data the given Member has sent ordered by date desc

Parameters:

data - the Data

mbr - the Member

Returns:

the List of Recommendation on given Data the given Member has made ordered by date desc

Since:

jcms-8.0.0

getReceivedRecommendationCount

public int getReceivedRecommendationCount(Data data,
                                          Member mbr)

Returns the count of Recommendation on given Data that given Member has received ordered by date desc

Parameters:

data - the Data

mbr - the Member

Returns:

the count of Recommendation on given Data that given Member has received ordered by date desc

Since:

jcms-8.0.0

getReceivedRecommendationCount

public int getReceivedRecommendationCount(Member mbr)

Returns the count of Recommendation where given member is a recipient ordered by date desc

Parameters:

mbr - the Member

Returns:

the count of Recommendation where given member is a recipient ordered by date desc

Since:

jcms-8.0.0

getReceivedRecommendationSet

public Set<Recommendation> getReceivedRecommendationSet(Member mbr)

Returns the List of Recommendation where given member is a recipient ordered by date desc

Parameters:

mbr - the Member

Returns:

the List of Recommendation where given member is a recipient ordered by date desc

Since:

jcms-8.0.0

getReceivedRecommendationSet

public Set<Recommendation> getReceivedRecommendationSet(Data data,
                                                        Member mbr)

Returns the List of Recommendation on given Data, where given member is a recipient ordered by date desc

Parameters:

data - the Data

mbr - the Member

Returns:

the List of Recommendation on given Data, where given member is a recipient ordered by date desc

Since:

jcms-8.0.0

getReceivedRecommendationSet

public Set<Recommendation> getReceivedRecommendationSet(Data data,
                                                        Set<Member> recipientSet)

Returns the List of Recommendation on given Data, where given member are recipient ordered by date desc

Parameters:

data - the Data

recipientSet - the Set of Member

Returns:

the List of Recommendation on given Data, where given members are recipient ordered by date desc

Since:

jcms-8.0.0

getTotalRecipientCount

public int getTotalRecipientCount(Recommendation recommendation)

Parameters:

recommendation - the Recommendation

Returns:

the total count of recipient in given Recommendation

getRecommendationReaderTrackingMemberCount

public int getRecommendationReaderTrackingMemberCount(Recommendation recommendation)

Parameters:

recommendation - the Recommendation

Returns:

the count of ReaderTracking since the creation of given Recommendation

getRecommendationReaderTrackingMemberSet

public List<ReaderTracker> getRecommendationReaderTrackingMemberSet(Recommendation recommendation)

Returns a List of ReaderTracker which have read the recommendation's Publication yet since the recommendation has been sent

Parameters:

recommendation - the Recommendation

Returns:

a List of ReaderTracker which have read the recommendation's Publication yet since the recommendation has been sent

Since:

jcms-8.0.0

isGroupContainsMember

public boolean isGroupContainsMember(Set<Group> groupSet)

Parameters:

groupSet - a Set of Group

Returns:

true if given group set contains at least one member

canBeRecommended

public boolean canBeRecommended(Data data)

Parameters:

data - the Data to recommend

Returns:

true if given Data can be recommended

canBeRecommendedBy

public boolean canBeRecommendedBy(Data data,
                                  Member mbr)

Parameters:

data - the Data to recommend

mbr - the Member which recommends

Returns:

true if given Data can be recommended by given Member

isRecommendationEnabled

public boolean isRecommendationEnabled()

Returns:

true if the property "recommendation.enabled.boolean" is set to true

Since:

jcms-8.0.0

isDataTracked

public boolean isDataTracked(Recommendation recommendation)

Parameters:

recommendation - the Recommendation

Returns:

true if given recommendation data is Reader Tracked

deleteAllRecommendation

public void deleteAllRecommendation(Data data)

Deletes all the recommendation attached to the given Data.

Parameters:

data - the Data

Since:

jcms-8.0.0

printRecommendationLinkStart

public void printRecommendationLinkStart(StringBuilder sb,
                                         Data data,
                                         String css,
                                         String userLang)

Prints the start of the link for Recommendation

Parameters:

sb - the StringBuilder

data - the Data

css - optionnal classname to use in the link

Since:

jcms-8.0.0

getAddRecommendationLink

public String getAddRecommendationLink(Data data,
                                       String css,
                                       String body,
                                       String userLang)

Returns the link to add a recommendation on a data

Parameters:

data - the Data

css - optionnal classname to use in the link

body - the content in the link

Returns:

the link to add a recommendation on a data

printAddRecommendationLinkEnd

public void printAddRecommendationLinkEnd(StringBuilder sb)

Prints the end of the link for Recommendation

Parameters:

sb -