com.jalios.jcms.recommendation

Class RecommendationManager

java.lang.Object

com.jalios.jcms.recommendation.RecommendationManager

All Implemented Interfaces:

DBConstants, RecommendationConstants, JPropertiesListener

public class RecommendationManager
extends java.lang.Object
implements RecommendationConstants, DBConstants, JPropertiesListener

This class gives Utils to handle Recommendation

Since:

jcms-8.0.0

Version:

$Revision: 55323 $

Author:

Kevin Bransard

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.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_ALERT_PROP, RECOMMENDATION_ENABLED_PROP, RECOMMENDATION_REPLY_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

Methods

Modifier and Type	Method and Description
boolean	canBeReadBy(Recommendation recommendation, Member mbr) Returns true if given Member can read the given Recommendation data
boolean	canBeRecommended(Data data)
boolean	canBeRecommendedBy(Data data, Member mbr)
void	deleteAllRecommendation(Data data) Deletes all the recommendation attached to the given Data.
java.lang.String	getAddRecommendationLink(Data data, java.lang.String css, java.lang.String body, java.lang.String userLang) Returns the link to add a recommendation on a data
java.lang.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()
java.lang.String	getModalText(Data data, java.lang.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
java.util.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
java.util.Set<Recommendation>	getReceivedRecommendationSet(Data data, java.util.Set<Member> recipientSet) Returns the List of Recommendation on given Data, where given member are recipient ordered by date desc
java.util.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
java.util.List<Recommendation>	getRecommendationList(Data data) Returns the List of Recommendation for given Data ordered by date desc
int	getRecommendationReaderTrackingMemberCount(Recommendation recommendation)
java.util.List<ReaderTracker>	getRecommendationReaderTrackingMemberSet(Recommendation recommendation) Returns a List of ReaderTracker which have read the recommendation's Publication yet since the recommendation has been sent
java.lang.String[]	getReplyRecipientIds(Recommendation recommendation, Member replyAuthor) Returns an array of recipient ids for replying a recommendation author is removed from recipient
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
java.util.List<Recommendation>	getSentRecommendationList(Data data, Member mbr) Returns the List of Recommendation on given Data the given Member has sent ordered by date desc
java.util.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(java.util.Set<Group> groupSet)
boolean	isRecommendationEnabled()
boolean	isRecommendationReplyEnabled()
void	printAddRecommendationLinkEnd(java.lang.StringBuilder sb) Prints the end of the link for Recommendation
void	printRecommendationLinkStart(java.lang.StringBuilder sb, Data data, java.lang.String css, java.lang.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, Recommendation replyRecommendation) 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 java.lang.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,
                      Recommendation replyRecommendation)

Sends the given recommendation

Parameters:

isAuthorRecipient - defines if author should receive the recommendation too

recommendation - the Recommendation

Since:

jcms-8.0.0

getAlertName

public java.lang.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 java.lang.String getModalText(Data data,
                            java.lang.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 java.util.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 java.util.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 java.util.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 java.util.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 java.util.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 java.util.Set<Recommendation> getReceivedRecommendationSet(Data data,
                                                         java.util.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 java.util.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(java.util.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

canBeReadBy

public boolean canBeReadBy(Recommendation recommendation,
                  Member mbr)

Returns true if given Member can read the given Recommendation data

Parameters:

recommendation - the Recommendation

mbr - the Member

Returns:

true if given Member can read the given Recommendation data

Since:

jcms-8.0.1

isRecommendationEnabled

public boolean isRecommendationEnabled()

Returns:

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

Since:

jcms-8.0.0

isRecommendationReplyEnabled

public boolean isRecommendationReplyEnabled()

Returns:

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

Since:

jcms-8.0.1

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

getReplyRecipientIds

public java.lang.String[] getReplyRecipientIds(Recommendation recommendation,
                                      Member replyAuthor)

Returns an array of recipient ids for replying a recommendation author is removed from recipient

Parameters:

recommendation - the replied Recommendation

replyAuthor - the author of current replyg

Returns:

the array of recipient ids for replying a recommendation

Since:

jcms-8.0.1

printRecommendationLinkStart

public void printRecommendationLinkStart(java.lang.StringBuilder sb,
                                Data data,
                                java.lang.String css,
                                java.lang.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 java.lang.String getAddRecommendationLink(Data data,
                                        java.lang.String css,
                                        java.lang.String body,
                                        java.lang.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(java.lang.StringBuilder sb)

Prints the end of the link for Recommendation

Parameters:

sb -