com.jivesoftware.forum.abuse
Interface AbuseManager

All Superinterfaces:

MessageListener, UserListener

All Known Implementing Classes:

AbuseManagerImpl

public interface AbuseManager
extends UserListener, MessageListener

Manages all aspects of reporting abuse and managing abuse reports.

Field Summary

static int	DEFAULT_ABUSE_THRESHOLD
static java.lang.String	PROPERTY_ABUSE_ENABLED
static java.lang.String	PROPERTY_ABUSE_THRESHOLD

Method Summary

java.util.List	getAbuseReports(ForumMessage message) Gets a list of open abuse reports for a particular message
java.util.List	getAbuseReports(User user) Gets a list of open abuse reports from a particular user
int	getAbuseThreshold() Gets the number of abuse reports needed to automatically hide a message.
int	getNumberOfAbuseReports(ForumMessage message) Gets the number of abuse reports for a particular message
boolean	hasUserReportedAbuse(ForumMessage message, User user) Checks if a user has already reported abuse for a particular message.
boolean	isReportAbuseEnabled() Checks if report abuse feature is enabled.
void	reportAbuse(AbuseReport report) Creates an abuse report entry in the database and marks the message for moderation
void	resolveAbuseReport(AbuseReport abuseReport) Resolves an abuse report
void	resolveAbuseReports(ForumMessage message) REsolves all abuse reports for a particular message
void	setAbuseThreshold(int abuseThreshold) Sets the number of abuse reports needed to automatically hide a message.
void	setReportAbuseEnabled(boolean reportAbuseEnabled) Enables or disables the report abuse feature.

Methods inherited from interface com.jivesoftware.base.event.UserListener

userCreated, userDeleted, userModified

Methods inherited from interface com.jivesoftware.forum.event.MessageListener

messageAdded, messageDeleted, messageModerationModified, messageModified, messageMoved, messageRated

Field Detail

DEFAULT_ABUSE_THRESHOLD

static final int DEFAULT_ABUSE_THRESHOLD

See Also:

Constant Field Values

PROPERTY_ABUSE_ENABLED

static final java.lang.String PROPERTY_ABUSE_ENABLED

See Also:

Constant Field Values

PROPERTY_ABUSE_THRESHOLD

static final java.lang.String PROPERTY_ABUSE_THRESHOLD

See Also:

Constant Field Values

Method Detail

reportAbuse

void reportAbuse(AbuseReport report)

Creates an abuse report entry in the database and marks the message for moderation

Parameters:

report - the report to create

getAbuseReports

java.util.List getAbuseReports(ForumMessage message)

Gets a list of open abuse reports for a particular message

Parameters:

message - the message to check

Returns:

a list of abuse reports for the message

getAbuseReports

java.util.List getAbuseReports(User user)

Gets a list of open abuse reports from a particular user

Parameters:

user - the user to check

Returns:

a list of abuse reports from the user

getNumberOfAbuseReports

int getNumberOfAbuseReports(ForumMessage message)

Gets the number of abuse reports for a particular message

Parameters:

message - the message to check

Returns:

the number of abuse reports for the message

resolveAbuseReport

void resolveAbuseReport(AbuseReport abuseReport)

Resolves an abuse report

Parameters:

abuseReport - the abuse report to resolve

resolveAbuseReports

void resolveAbuseReports(ForumMessage message)

REsolves all abuse reports for a particular message

Parameters:

message - the message to resolve all abuse reports

hasUserReportedAbuse

boolean hasUserReportedAbuse(ForumMessage message,
                             User user)

Checks if a user has already reported abuse for a particular message.

Parameters:

message - the message to check

user - the user to check

Returns:

true if the user has already reported abuse for this message; false otherwise.

isReportAbuseEnabled

boolean isReportAbuseEnabled()

Checks if report abuse feature is enabled. When report abuse is enabled, user will be able to report abuse for particular messages and those messages will be added to the moderators queue for review.

Returns:

true if report abuse is enabled; false otherwise.

setReportAbuseEnabled

void setReportAbuseEnabled(boolean reportAbuseEnabled)

Enables or disables the report abuse feature. When report abuse is enabled, user will be able to report abuse for particular messages and those messages will be added to the moderators queue for review.

Parameters:

reportAbuseEnabled - true to enable report abuse, false to disable

getAbuseThreshold

int getAbuseThreshold()

Gets the number of abuse reports needed to automatically hide a message.

Returns:

the number of abuse reports needed to automatically hide a message.

setAbuseThreshold

void setAbuseThreshold(int abuseThreshold)

Sets the number of abuse reports needed to automatically hide a message.

Parameters:

abuseThreshold - the number of abuse reports needed to automatically hide a message.