com.liferay.social.kernel.service

Interface SocialRequestLocalService

All Superinterfaces:

BaseLocalService, PersistedModelLocalService

All Known Implementing Classes:

SocialRequestLocalServiceWrapper

@ProviderType
 @Transactional(isolation=PORTAL,
               rollbackFor={PortalException.class,SystemException.class})
public interface SocialRequestLocalService
extends BaseLocalService, PersistedModelLocalService

Provides the local service interface for SocialRequest. Methods of this service will not have security checks based on the propagated JAAS credentials because this service can only be accessed from within the same VM.

Author:

Brian Wing Shun Chan

See Also:

SocialRequestLocalServiceUtil

{$generated.description}

Method Summary

Modifier and Type	Method and Description
SocialRequest	addRequest(long userId, long groupId, String className, long classPK, int type, String extraData, long receiverUserId) Adds a social request to the database.
SocialRequest	addSocialRequest(SocialRequest socialRequest) Adds the social request to the database.
SocialRequest	createSocialRequest(long requestId) Creates a new social request with the primary key.
PersistedModel	deletePersistedModel(PersistedModel persistedModel)
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(SocialRequest request) Removes the social request from the database.
void	deleteRequests(long className, long classPK)
SocialRequest	deleteSocialRequest(long requestId) Deletes the social request with the primary key from the database.
SocialRequest	deleteSocialRequest(SocialRequest socialRequest) Deletes the social request from the database.
void	deleteUserRequests(long userId) Removes all the social requests for the requesting user.
DynamicQuery	dynamicQuery()
<T> List<T>	dynamicQuery(DynamicQuery dynamicQuery) Performs a dynamic query on the database and returns the matching rows.
<T> List<T>	dynamicQuery(DynamicQuery dynamicQuery, int start, int end) Performs a dynamic query on the database and returns a range of the matching rows.
<T> List<T>	dynamicQuery(DynamicQuery dynamicQuery, int start, int end, OrderByComparator<T> orderByComparator) Performs a dynamic query on the database and returns an ordered range of the matching rows.
long	dynamicQueryCount(DynamicQuery dynamicQuery) Returns the number of rows matching the dynamic query.
long	dynamicQueryCount(DynamicQuery dynamicQuery, Projection projection) Returns the number of rows matching the dynamic query.
SocialRequest	fetchSocialRequest(long requestId)
SocialRequest	fetchSocialRequestByUuidAndGroupId(String uuid, long groupId) Returns the social request matching the UUID and group.
ActionableDynamicQuery	getActionableDynamicQuery()
IndexableActionableDynamicQuery	getIndexableActionableDynamicQuery()
String	getOSGiServiceIdentifier() Returns the OSGi service identifier.
PersistedModel	getPersistedModel(Serializable primaryKeyObj)
List<SocialRequest>	getReceiverUserRequests(long receiverUserId, int start, int end) Returns a range of all the social requests for the receiving user.
List<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.
SocialRequest	getSocialRequest(long requestId) Returns the social request with the primary key.
SocialRequest	getSocialRequestByUuidAndGroupId(String uuid, long groupId) Returns the social request matching the UUID and group.
List<SocialRequest>	getSocialRequests(int start, int end) Returns a range of all the social requests.
List<SocialRequest>	getSocialRequestsByUuidAndCompanyId(String uuid, long companyId) Returns all the social requests matching the UUID and company.
List<SocialRequest>	getSocialRequestsByUuidAndCompanyId(String uuid, long companyId, int start, int end, OrderByComparator<SocialRequest> orderByComparator) Returns a range of social requests matching the UUID and company.
int	getSocialRequestsCount() Returns the number of social requests.
List<SocialRequest>	getUserRequests(long userId, int start, int end) Returns a range of all the social requests for the requesting user.
List<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, String className, long classPK, int type, int status) Returns true if a matching social requests exists in the database.
boolean	hasRequest(long userId, String className, long classPK, int type, long receiverUserId, int status) Returns true if a matching social request exists in the database.
SocialRequest	updateRequest(long requestId, int status, ThemeDisplay themeDisplay) Updates the social request replacing its status.
SocialRequest	updateSocialRequest(SocialRequest socialRequest) Updates the social request in the database or adds it if it does not yet exist.

Method Detail

addRequest

SocialRequest addRequest(long userId,
                         long groupId,
                         String className,
                         long classPK,
                         int type,
                         String extraData,
                         long receiverUserId)
                  throws PortalException

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:

PortalException

addSocialRequest

@Indexable(type=REINDEX)
SocialRequest addSocialRequest(SocialRequest socialRequest)

Adds the social request to the database. Also notifies the appropriate model listeners.

Parameters:

socialRequest - the social request

Returns:

the social request that was added

createSocialRequest

@Transactional(enabled=false)
SocialRequest createSocialRequest(long requestId)

Creates a new social request with the primary key. Does not add the social request to the database.

Parameters:

requestId - the primary key for the new social request

Returns:

the new social request

deletePersistedModel

PersistedModel deletePersistedModel(PersistedModel persistedModel)
                             throws PortalException

Specified by:

deletePersistedModel in interface PersistedModelLocalService

Throws:

PortalException

deleteReceiverUserRequests

void deleteReceiverUserRequests(long receiverUserId)

Removes all the social requests for the receiving user.

Parameters:

receiverUserId - the primary key of the receiving user

deleteRequest

void deleteRequest(long requestId)
            throws PortalException

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

Parameters:

requestId - the primary key of the social request

Throws:

PortalException

deleteRequest

void deleteRequest(SocialRequest request)

Removes the social request from the database.

Parameters:

request - the social request to be removed

deleteRequests

void deleteRequests(long className,
                    long classPK)

deleteSocialRequest

@Indexable(type=DELETE)
SocialRequest deleteSocialRequest(long requestId)
                                                   throws PortalException

Deletes the social request with the primary key from the database. Also notifies the appropriate model listeners.

Parameters:

requestId - the primary key of the social request

Returns:

the social request that was removed

Throws:

PortalException - if a social request with the primary key could not be found

deleteSocialRequest

@Indexable(type=DELETE)
SocialRequest deleteSocialRequest(SocialRequest socialRequest)

Deletes the social request from the database. Also notifies the appropriate model listeners.

Parameters:

socialRequest - the social request

Returns:

the social request that was removed

deleteUserRequests

void deleteUserRequests(long userId)

Removes all the social requests for the requesting user.

Parameters:

userId - the primary key of the requesting user

dynamicQuery

@Transactional(propagation=SUPPORTS,
               readOnly=true)
DynamicQuery dynamicQuery()

dynamicQuery

@Transactional(propagation=SUPPORTS,
               readOnly=true)
<T> List<T> dynamicQuery(DynamicQuery dynamicQuery)

Performs a dynamic query on the database and returns the matching rows.

Parameters:

dynamicQuery - the dynamic query

Returns:

the matching rows

dynamicQuery

@Transactional(propagation=SUPPORTS,
               readOnly=true)
<T> List<T> dynamicQuery(DynamicQuery dynamicQuery,
                                                                                            int start,
                                                                                            int end)

Performs a dynamic query on the database and returns a range of the matching rows.

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 com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS), then the query will include the default ORDER BY logic from com.liferay.portlet.social.model.impl.SocialRequestModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:

dynamicQuery - the dynamic query

start - the lower bound of the range of model instances

end - the upper bound of the range of model instances (not inclusive)

Returns:

the range of matching rows

dynamicQuery

@Transactional(propagation=SUPPORTS,
               readOnly=true)
<T> List<T> dynamicQuery(DynamicQuery dynamicQuery,
                                                                                            int start,
                                                                                            int end,
                                                                                            OrderByComparator<T> orderByComparator)

Performs a dynamic query on the database and returns an ordered range of the matching rows.

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 com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS), then the query will include the default ORDER BY logic from com.liferay.portlet.social.model.impl.SocialRequestModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:

dynamicQuery - the dynamic query

start - the lower bound of the range of model instances

end - the upper bound of the range of model instances (not inclusive)

orderByComparator - the comparator to order the results by (optionally null)

Returns:

the ordered range of matching rows

dynamicQueryCount

@Transactional(propagation=SUPPORTS,
               readOnly=true)
long dynamicQueryCount(DynamicQuery dynamicQuery)

Returns the number of rows matching the dynamic query.

Parameters:

dynamicQuery - the dynamic query

Returns:

the number of rows matching the dynamic query

dynamicQueryCount

@Transactional(propagation=SUPPORTS,
               readOnly=true)
long dynamicQueryCount(DynamicQuery dynamicQuery,
                                                                                          Projection projection)

Returns the number of rows matching the dynamic query.

Parameters:

dynamicQuery - the dynamic query

projection - the projection to apply to the query

Returns:

the number of rows matching the dynamic query

fetchSocialRequest

@Transactional(propagation=SUPPORTS,
               readOnly=true)
SocialRequest fetchSocialRequest(long requestId)

fetchSocialRequestByUuidAndGroupId

@Transactional(propagation=SUPPORTS,
               readOnly=true)
SocialRequest fetchSocialRequestByUuidAndGroupId(String uuid,
                                                                                                                    long groupId)

Returns the social request matching the UUID and group.

Parameters:

uuid - the social request's UUID

groupId - the primary key of the group

Returns:

the matching social request, or null if a matching social request could not be found

getActionableDynamicQuery

@Transactional(propagation=SUPPORTS,
               readOnly=true)
ActionableDynamicQuery getActionableDynamicQuery()

getIndexableActionableDynamicQuery

@Transactional(propagation=SUPPORTS,
               readOnly=true)
IndexableActionableDynamicQuery getIndexableActionableDynamicQuery()

getOSGiServiceIdentifier

String getOSGiServiceIdentifier()

Returns the OSGi service identifier.

Returns:

the OSGi service identifier

getPersistedModel

@Transactional(propagation=SUPPORTS,
               readOnly=true)
PersistedModel getPersistedModel(Serializable primaryKeyObj)
                                                                                             throws PortalException

Specified by:

getPersistedModel in interface PersistedModelLocalService

Throws:

PortalException

getReceiverUserRequests

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<SocialRequest> getReceiverUserRequests(long receiverUserId,
                                                                                                               int start,
                                                                                                               int end)

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

getReceiverUserRequests

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<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.

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

getReceiverUserRequestsCount

@Transactional(propagation=SUPPORTS,
               readOnly=true)
int getReceiverUserRequestsCount(long receiverUserId)

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

getReceiverUserRequestsCount

@Transactional(propagation=SUPPORTS,
               readOnly=true)
int getReceiverUserRequestsCount(long receiverUserId,
                                                                                                    int status)

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

getSocialRequest

@Transactional(propagation=SUPPORTS,
               readOnly=true)
SocialRequest getSocialRequest(long requestId)
                                                                                           throws PortalException

Returns the social request with the primary key.

Parameters:

requestId - the primary key of the social request

Returns:

the social request

Throws:

PortalException - if a social request with the primary key could not be found

getSocialRequestByUuidAndGroupId

@Transactional(propagation=SUPPORTS,
               readOnly=true)
SocialRequest getSocialRequestByUuidAndGroupId(String uuid,
                                                                                                                  long groupId)
                                                                                                           throws PortalException

Returns the social request matching the UUID and group.

Parameters:

uuid - the social request's UUID

groupId - the primary key of the group

Returns:

the matching social request

Throws:

PortalException - if a matching social request could not be found

getSocialRequests

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<SocialRequest> getSocialRequests(int start,
                                                                                                         int end)

Returns a range of all the social requests.

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 com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS), then the query will include the default ORDER BY logic from com.liferay.portlet.social.model.impl.SocialRequestModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:

start - the lower bound of the range of social requests

end - the upper bound of the range of social requests (not inclusive)

Returns:

the range of social requests

getSocialRequestsByUuidAndCompanyId

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<SocialRequest> getSocialRequestsByUuidAndCompanyId(String uuid,
                                                                                                                           long companyId)

Returns all the social requests matching the UUID and company.

Parameters:

uuid - the UUID of the social requests

companyId - the primary key of the company

Returns:

the matching social requests, or an empty list if no matches were found

getSocialRequestsByUuidAndCompanyId

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<SocialRequest> getSocialRequestsByUuidAndCompanyId(String uuid,
                                                                                                                           long companyId,
                                                                                                                           int start,
                                                                                                                           int end,
                                                                                                                           OrderByComparator<SocialRequest> orderByComparator)

Returns a range of social requests matching the UUID and company.

Parameters:

uuid - the UUID of the social requests

companyId - the primary key of the company

start - the lower bound of the range of social requests

end - the upper bound of the range of social requests (not inclusive)

orderByComparator - the comparator to order the results by (optionally null)

Returns:

the range of matching social requests, or an empty list if no matches were found

getSocialRequestsCount

@Transactional(propagation=SUPPORTS,
               readOnly=true)
int getSocialRequestsCount()

Returns the number of social requests.

Returns:

the number of social requests

getUserRequests

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<SocialRequest> getUserRequests(long userId,
                                                                                                       int start,
                                                                                                       int end)

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

getUserRequests

@Transactional(propagation=SUPPORTS,
               readOnly=true)
List<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.

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

getUserRequestsCount

@Transactional(propagation=SUPPORTS,
               readOnly=true)
int getUserRequestsCount(long userId)

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

getUserRequestsCount

@Transactional(propagation=SUPPORTS,
               readOnly=true)
int getUserRequestsCount(long userId,
                                                                                            int status)

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

hasRequest

@Transactional(propagation=SUPPORTS,
               readOnly=true)
boolean hasRequest(long userId,
                                                                                      String className,
                                                                                      long classPK,
                                                                                      int type,
                                                                                      int status)

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

hasRequest

@Transactional(propagation=SUPPORTS,
               readOnly=true)
boolean hasRequest(long userId,
                                                                                      String className,
                                                                                      long classPK,
                                                                                      int type,
                                                                                      long receiverUserId,
                                                                                      int status)

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

updateRequest

SocialRequest updateRequest(long requestId,
                            int status,
                            ThemeDisplay themeDisplay)
                     throws PortalException

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:

PortalException

updateSocialRequest

@Indexable(type=REINDEX)
SocialRequest updateSocialRequest(SocialRequest socialRequest)

Updates the social request in the database or adds it if it does not yet exist. Also notifies the appropriate model listeners.

Parameters:

socialRequest - the social request

Returns:

the social request that was updated