com.liferay.portlet.social.service.impl

Class SocialRequestLocalServiceImpl

java.lang.Object

com.liferay.portal.service.BaseLocalServiceImpl

com.liferay.portlet.social.service.base.SocialRequestLocalServiceBaseImpl

com.liferay.portlet.social.service.impl.SocialRequestLocalServiceImpl

All Implemented Interfaces:

com.liferay.portal.kernel.bean.IdentifiableBean, com.liferay.portal.service.BaseLocalService, com.liferay.portal.service.PersistedModelLocalService, com.liferay.portlet.social.service.SocialRequestLocalService

public class SocialRequestLocalServiceImpl
extends SocialRequestLocalServiceBaseImpl

The social request local service responsible for handling social requests (e.g. friend requests).

Author:

Brian Wing Shun Chan

Field Summary

Fields inherited from class com.liferay.portlet.social.service.base.SocialRequestLocalServiceBaseImpl

counterLocalService, persistedModelLocalServiceRegistry, resourceLocalService, socialActivityAchievementLocalService, socialActivityAchievementPersistence, socialActivityCounterFinder, socialActivityCounterLocalService, socialActivityCounterPersistence, socialActivityFinder, socialActivityInterpreterLocalService, socialActivityLimitLocalService, socialActivityLimitPersistence, socialActivityLocalService, socialActivityPersistence, socialActivityService, socialActivitySetFinder, socialActivitySetLocalService, socialActivitySetPersistence, socialActivitySettingLocalService, socialActivitySettingPersistence, socialActivitySettingService, socialRelationLocalService, socialRelationPersistence, socialRequestInterpreterLocalService, socialRequestLocalService, socialRequestPersistence, socialRequestService, userFinder, userLocalService, userPersistence, userService

Fields inherited from class com.liferay.portal.service.BaseLocalServiceImpl

layoutPersistence

Constructor Summary

Constructors

Constructor and Description
SocialRequestLocalServiceImpl()

Method Summary

Methods

Modifier and Type	Method and Description
com.liferay.portlet.social.model.SocialRequest	addRequest(long userId, long groupId, java.lang.String className, long classPK, int type, java.lang.String extraData, long receiverUserId) Adds a social request to the database.
void	deleteReceiverUserRequests(long receiverUserId) Removes all the social requests for the receiving user.
void	deleteRequest(long requestId) Removes the social request identified by its primary key from the database.
void	deleteRequest(com.liferay.portlet.social.model.SocialRequest request) Removes the social request from the database.
void	deleteUserRequests(long userId) Removes all the social requests for the requesting user.
java.util.List<com.liferay.portlet.social.model.SocialRequest>	getReceiverUserRequests(long receiverUserId, int start, int end) Returns a range of all the social requests for the receiving user.
java.util.List<com.liferay.portlet.social.model.SocialRequest>	getReceiverUserRequests(long receiverUserId, int status, int start, int end) Returns a range of all the social requests with the given status for the receiving user.
int	getReceiverUserRequestsCount(long receiverUserId) Returns the number of social requests for the receiving user.
int	getReceiverUserRequestsCount(long receiverUserId, int status) Returns the number of social requests with the given status for the receiving user.
java.util.List<com.liferay.portlet.social.model.SocialRequest>	getUserRequests(long userId, int start, int end) Returns a range of all the social requests for the requesting user.
java.util.List<com.liferay.portlet.social.model.SocialRequest>	getUserRequests(long userId, int status, int start, int end) Returns a range of all the social requests with the given status for the requesting user.
int	getUserRequestsCount(long userId) Returns the number of social requests for the requesting user.
int	getUserRequestsCount(long userId, int status) Returns the number of social requests with the given status for the requesting user.
boolean	hasRequest(long userId, java.lang.String className, long classPK, int type, int status) Returns true if a matching social requests exists in the database.
boolean	hasRequest(long userId, java.lang.String className, long classPK, int type, long receiverUserId, int status) Returns true if a matching social request exists in the database.
com.liferay.portlet.social.model.SocialRequest	updateRequest(long requestId, int status, com.liferay.portal.theme.ThemeDisplay themeDisplay) Updates the social request replacing its status.

Methods inherited from class com.liferay.portlet.social.service.base.SocialRequestLocalServiceBaseImpl

addSocialRequest, afterPropertiesSet, createSocialRequest, deleteSocialRequest, deleteSocialRequest, destroy, dynamicQuery, dynamicQuery, dynamicQuery, dynamicQuery, dynamicQueryCount, dynamicQueryCount, fetchSocialRequest, fetchSocialRequestByUuidAndCompanyId, fetchSocialRequestByUuidAndGroupId, getBeanIdentifier, getCounterLocalService, getModelClass, getModelClassName, getPersistedModel, getResourceLocalService, getSocialActivityAchievementLocalService, getSocialActivityAchievementPersistence, getSocialActivityCounterFinder, getSocialActivityCounterLocalService, getSocialActivityCounterPersistence, getSocialActivityFinder, getSocialActivityInterpreterLocalService, getSocialActivityLimitLocalService, getSocialActivityLimitPersistence, getSocialActivityLocalService, getSocialActivityPersistence, getSocialActivityService, getSocialActivitySetFinder, getSocialActivitySetLocalService, getSocialActivitySetPersistence, getSocialActivitySettingLocalService, getSocialActivitySettingPersistence, getSocialActivitySettingService, getSocialRelationLocalService, getSocialRelationPersistence, getSocialRequest, getSocialRequestByUuidAndCompanyId, getSocialRequestByUuidAndGroupId, getSocialRequestInterpreterLocalService, getSocialRequestLocalService, getSocialRequestPersistence, getSocialRequests, getSocialRequestsCount, getSocialRequestService, getUserFinder, getUserLocalService, getUserPersistence, getUserService, runSQL, setBeanIdentifier, setCounterLocalService, setResourceLocalService, setSocialActivityAchievementLocalService, setSocialActivityAchievementPersistence, setSocialActivityCounterFinder, setSocialActivityCounterLocalService, setSocialActivityCounterPersistence, setSocialActivityFinder, setSocialActivityInterpreterLocalService, setSocialActivityLimitLocalService, setSocialActivityLimitPersistence, setSocialActivityLocalService, setSocialActivityPersistence, setSocialActivityService, setSocialActivitySetFinder, setSocialActivitySetLocalService, setSocialActivitySetPersistence, setSocialActivitySettingLocalService, setSocialActivitySettingPersistence, setSocialActivitySettingService, setSocialRelationLocalService, setSocialRelationPersistence, setSocialRequestInterpreterLocalService, setSocialRequestLocalService, setSocialRequestPersistence, setSocialRequestService, setUserFinder, setUserLocalService, setUserPersistence, setUserService, updateSocialRequest

Methods inherited from class com.liferay.portal.service.BaseLocalServiceImpl

getClassLoader, getLayoutURL, getLayoutURL

Methods inherited from class java.lang.Object

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

Constructor Detail

SocialRequestLocalServiceImpl

public SocialRequestLocalServiceImpl()

Method Detail

addRequest

public com.liferay.portlet.social.model.SocialRequest addRequest(long userId,
                                                        long groupId,
                                                        java.lang.String className,
                                                        long classPK,
                                                        int type,
                                                        java.lang.String extraData,
                                                        long receiverUserId)
                                                          throws com.liferay.portal.kernel.exception.PortalException,
                                                                 com.liferay.portal.kernel.exception.SystemException

Adds a social request to the database.

In order to add a social request, both the requesting user and the receiving user must be from the same company and neither of them can be the default user.

Parameters:

userId - the primary key of the requesting user

groupId - the primary key of the group

className - the class name of the asset that is the subject of the request

classPK - the primary key of the asset that is the subject of the request

type - the request's type

extraData - the extra data regarding the request

receiverUserId - the primary key of the user receiving the request

Returns:

the social request

Throws:

com.liferay.portal.kernel.exception.PortalException - if the users could not be found, if the users were not from the same company, or if either of the users was the default user

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

deleteReceiverUserRequests

public void deleteReceiverUserRequests(long receiverUserId)
                                throws com.liferay.portal.kernel.exception.SystemException

Removes all the social requests for the receiving user.

Parameters:

receiverUserId - the primary key of the receiving user

Throws:

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

deleteRequest

public void deleteRequest(long requestId)
                   throws com.liferay.portal.kernel.exception.PortalException,
                          com.liferay.portal.kernel.exception.SystemException

Removes the social request identified by its primary key from the database.

Parameters:

requestId - the primary key of the social request

Throws:

com.liferay.portal.kernel.exception.PortalException - if the social request could not be found

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

deleteRequest

public void deleteRequest(com.liferay.portlet.social.model.SocialRequest request)
                   throws com.liferay.portal.kernel.exception.SystemException

Removes the social request from the database.

Parameters:

request - the social request to be removed

Throws:

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

deleteUserRequests

public void deleteUserRequests(long userId)
                        throws com.liferay.portal.kernel.exception.SystemException

Removes all the social requests for the requesting user.

Parameters:

userId - the primary key of the requesting user

Throws:

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getReceiverUserRequests

public java.util.List<com.liferay.portlet.social.model.SocialRequest> getReceiverUserRequests(long receiverUserId,
                                                                                     int start,
                                                                                     int end)
                                                                                       throws com.liferay.portal.kernel.exception.SystemException

Returns a range of all the social requests for the receiving user.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set.

Parameters:

receiverUserId - the primary key of the receiving user

start - the lower bound of the range of results

end - the upper bound of the range of results (not inclusive)

Returns:

the range of matching social requests

Throws:

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getReceiverUserRequests

public java.util.List<com.liferay.portlet.social.model.SocialRequest> getReceiverUserRequests(long receiverUserId,
                                                                                     int status,
                                                                                     int start,
                                                                                     int end)
                                                                                       throws com.liferay.portal.kernel.exception.SystemException

Returns a range of all the social requests with the given status for the receiving user.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set.

Parameters:

receiverUserId - the primary key of the receiving user

status - the social request's status

start - the lower bound of the range of results

end - the upper bound of the range of results (not inclusive)

Returns:

the range of matching social requests

Throws:

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getReceiverUserRequestsCount

public int getReceiverUserRequestsCount(long receiverUserId)
                                 throws com.liferay.portal.kernel.exception.SystemException

Returns the number of social requests for the receiving user.

Parameters:

receiverUserId - the primary key of the receiving user

Returns:

the number of matching social requests

Throws:

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getReceiverUserRequestsCount

public int getReceiverUserRequestsCount(long receiverUserId,
                               int status)
                                 throws com.liferay.portal.kernel.exception.SystemException

Returns the number of social requests with the given status for the receiving user.

Parameters:

receiverUserId - the primary key of the receiving user

status - the social request's status

Returns:

the number of matching social requests

Throws:

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getUserRequests

public java.util.List<com.liferay.portlet.social.model.SocialRequest> getUserRequests(long userId,
                                                                             int start,
                                                                             int end)
                                                                               throws com.liferay.portal.kernel.exception.SystemException

Returns a range of all the social requests for the requesting user.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set.

Parameters:

userId - the primary key of the requesting user

start - the lower bound of the range of results

end - the upper bound of the range of results (not inclusive)

Returns:

the range of matching social requests

Throws:

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getUserRequests

public java.util.List<com.liferay.portlet.social.model.SocialRequest> getUserRequests(long userId,
                                                                             int status,
                                                                             int start,
                                                                             int end)
                                                                               throws com.liferay.portal.kernel.exception.SystemException

Returns a range of all the social requests with the given status for the requesting user.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set.

Parameters:

userId - the primary key of the requesting user

status - the social request's status

start - the lower bound of the range of results

end - the upper bound of the range of results (not inclusive)

Returns:

the range of matching social requests

Throws:

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getUserRequestsCount

public int getUserRequestsCount(long userId)
                         throws com.liferay.portal.kernel.exception.SystemException

Returns the number of social requests for the requesting user.

Parameters:

userId - the primary key of the requesting user

Returns:

the number of matching social requests

Throws:

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getUserRequestsCount

public int getUserRequestsCount(long userId,
                       int status)
                         throws com.liferay.portal.kernel.exception.SystemException

Returns the number of social requests with the given status for the requesting user.

Parameters:

userId - the primary key of the requesting user

status - the social request's status

Returns:

the number of matching social request

Throws:

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

hasRequest

public boolean hasRequest(long userId,
                 java.lang.String className,
                 long classPK,
                 int type,
                 int status)
                   throws com.liferay.portal.kernel.exception.SystemException

Returns true if a matching social requests exists in the database.

Parameters:

userId - the primary key of the requesting user

className - the class name of the asset that is the subject of the request

classPK - the primary key of the asset that is the subject of the request

type - the request's type

status - the social request's status

Returns:

true if the request exists; false otherwise

Throws:

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

hasRequest

public boolean hasRequest(long userId,
                 java.lang.String className,
                 long classPK,
                 int type,
                 long receiverUserId,
                 int status)
                   throws com.liferay.portal.kernel.exception.SystemException

Returns true if a matching social request exists in the database.

Parameters:

userId - the primary key of the requesting user

className - the class name of the asset that is the subject of the request

classPK - the primary key of the asset that is the subject of the request

type - the request's type

receiverUserId - the primary key of the receiving user

status - the social request's status

Returns:

true if the social request exists; false otherwise

Throws:

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

updateRequest

public com.liferay.portlet.social.model.SocialRequest updateRequest(long requestId,
                                                           int status,
                                                           com.liferay.portal.theme.ThemeDisplay themeDisplay)
                                                             throws com.liferay.portal.kernel.exception.PortalException,
                                                                    com.liferay.portal.kernel.exception.SystemException

Updates the social request replacing its status.

If the status is updated to SocialRequestConstants.STATUS_CONFIRM then SocialRequestInterpreterLocalService.processConfirmation( SocialRequest, ThemeDisplay) is called. If the status is updated to SocialRequestConstants.STATUS_IGNORE then SocialRequestInterpreterLocalService.processRejection( SocialRequest, ThemeDisplay) is called.

Parameters:

requestId - the primary key of the social request

status - the new status

themeDisplay - the theme display

Returns:

the updated social request

Throws:

com.liferay.portal.kernel.exception.PortalException - if the social request could not be found

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred