Liferay 7.0-ce-b4

com.liferay.portlet.social.service
Class SocialRequestLocalServiceUtil

java.lang.Object
  extended by com.liferay.portlet.social.service.SocialRequestLocalServiceUtil

@ProviderType
public class SocialRequestLocalServiceUtil
extends Object

Provides the local service utility for SocialRequest. This utility wraps com.liferay.portlet.social.service.impl.SocialRequestLocalServiceImpl and is the primary access point for service operations in application layer code running on the local server. 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.

See Also:
SocialRequestLocalService, com.liferay.portlet.social.service.base.SocialRequestLocalServiceBaseImpl, com.liferay.portlet.social.service.impl.SocialRequestLocalServiceImpl

Constructor Summary
SocialRequestLocalServiceUtil()
           
 
Method Summary
static SocialRequest addRequest(long userId, long groupId, String className, long classPK, int type, String extraData, long receiverUserId)
          Adds a social request to the database.
static SocialRequest addSocialRequest(SocialRequest socialRequest)
          Adds the social request to the database.
static SocialRequest createSocialRequest(long requestId)
          Creates a new social request with the primary key.
static PersistedModel deletePersistedModel(PersistedModel persistedModel)
           
static void deleteReceiverUserRequests(long receiverUserId)
          Removes all the social requests for the receiving user.
static void deleteRequest(long requestId)
          Removes the social request identified by its primary key from the database.
static void deleteRequest(SocialRequest request)
          Removes the social request from the database.
static void deleteRequests(long className, long classPK)
           
static SocialRequest deleteSocialRequest(long requestId)
          Deletes the social request with the primary key from the database.
static SocialRequest deleteSocialRequest(SocialRequest socialRequest)
          Deletes the social request from the database.
static void deleteUserRequests(long userId)
          Removes all the social requests for the requesting user.
static DynamicQuery dynamicQuery()
           
static
<T> List<T>
dynamicQuery(DynamicQuery dynamicQuery)
          Performs a dynamic query on the database and returns the matching rows.
static
<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.
static
<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.
static long dynamicQueryCount(DynamicQuery dynamicQuery)
          Returns the number of rows matching the dynamic query.
static long dynamicQueryCount(DynamicQuery dynamicQuery, Projection projection)
          Returns the number of rows matching the dynamic query.
static SocialRequest fetchSocialRequest(long requestId)
           
static SocialRequest fetchSocialRequestByUuidAndGroupId(String uuid, long groupId)
          Returns the social request matching the UUID and group.
static ActionableDynamicQuery getActionableDynamicQuery()
           
static IndexableActionableDynamicQuery getIndexableActionableDynamicQuery()
           
static String getOSGiServiceIdentifier()
          Returns the OSGi service identifier.
static PersistedModel getPersistedModel(Serializable primaryKeyObj)
           
static List<SocialRequest> getReceiverUserRequests(long receiverUserId, int start, int end)
          Returns a range of all the social requests for the receiving user.
static 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.
static int getReceiverUserRequestsCount(long receiverUserId)
          Returns the number of social requests for the receiving user.
static int getReceiverUserRequestsCount(long receiverUserId, int status)
          Returns the number of social requests with the given status for the receiving user.
static SocialRequestLocalService getService()
           
static SocialRequest getSocialRequest(long requestId)
          Returns the social request with the primary key.
static SocialRequest getSocialRequestByUuidAndGroupId(String uuid, long groupId)
          Returns the social request matching the UUID and group.
static List<SocialRequest> getSocialRequests(int start, int end)
          Returns a range of all the social requests.
static List<SocialRequest> getSocialRequestsByUuidAndCompanyId(String uuid, long companyId)
          Returns all the social requests matching the UUID and company.
static 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.
static int getSocialRequestsCount()
          Returns the number of social requests.
static List<SocialRequest> getUserRequests(long userId, int start, int end)
          Returns a range of all the social requests for the requesting user.
static 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.
static int getUserRequestsCount(long userId)
          Returns the number of social requests for the requesting user.
static int getUserRequestsCount(long userId, int status)
          Returns the number of social requests with the given status for the requesting user.
static boolean hasRequest(long userId, String className, long classPK, int type, int status)
          Returns true if a matching social requests exists in the database.
static 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.
static SocialRequest updateRequest(long requestId, int status, ThemeDisplay themeDisplay)
          Updates the social request replacing its status.
static SocialRequest updateSocialRequest(SocialRequest socialRequest)
          Updates the social request in the database or adds it if it does not yet exist.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SocialRequestLocalServiceUtil

public SocialRequestLocalServiceUtil()
Method Detail

addRequest

public static 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

public static 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

public static 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

public static PersistedModel deletePersistedModel(PersistedModel persistedModel)
                                           throws PortalException
Throws:
PortalException

deleteReceiverUserRequests

public static void deleteReceiverUserRequests(long receiverUserId)
Removes all the social requests for the receiving user.

Parameters:
receiverUserId - the primary key of the receiving user

deleteRequest

public static void deleteRequest(SocialRequest request)
Removes the social request from the database.

Parameters:
request - the social request to be removed

deleteRequest

public static 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

deleteRequests

public static void deleteRequests(long className,
                                  long classPK)

deleteSocialRequest

public static 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

public static 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

public static void deleteUserRequests(long userId)
Removes all the social requests for the requesting user.

Parameters:
userId - the primary key of the requesting user

dynamicQuery

public static DynamicQuery dynamicQuery()

dynamicQuery

public static <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

public static <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 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 QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from 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

public static <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 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 QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from 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

public static 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

public static 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

public static SocialRequest fetchSocialRequest(long requestId)

fetchSocialRequestByUuidAndGroupId

public static 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

public static ActionableDynamicQuery getActionableDynamicQuery()

getIndexableActionableDynamicQuery

public static IndexableActionableDynamicQuery getIndexableActionableDynamicQuery()

getOSGiServiceIdentifier

public static String getOSGiServiceIdentifier()
Returns the OSGi service identifier.

Returns:
the OSGi service identifier

getPersistedModel

public static PersistedModel getPersistedModel(Serializable primaryKeyObj)
                                        throws PortalException
Throws:
PortalException

getReceiverUserRequests

public static 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

public static 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

public static 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

public static 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

public static 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

public static 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

public static 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 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 QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from 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

public static 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

public static 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

public static int getSocialRequestsCount()
Returns the number of social requests.

Returns:
the number of social requests

getUserRequests

public static 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

public static 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

public static 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

public static 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

public static 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

hasRequest

public static 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

updateRequest

public static 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

public static 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

getService

public static SocialRequestLocalService getService()

Liferay 7.0-ce-b4