@ProviderType
public class SocialActivityLocalServiceUtil
extends Object
SocialActivityLocalServiceImpl
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.SocialActivityLocalService
,
SocialActivityLocalServiceBaseImpl
,
SocialActivityLocalServiceImpl
Constructor and Description |
---|
SocialActivityLocalServiceUtil() |
Modifier and Type | Method and Description |
---|---|
static void |
addActivity(long userId,
long groupId,
Date createDate,
String className,
long classPK,
int type,
String extraData,
long receiverUserId)
Records an activity with the given time in the database.
|
static void |
addActivity(long userId,
long groupId,
String className,
long classPK,
int type,
String extraData,
long receiverUserId)
Records an activity in the database, using a time based on the current
time in an attempt to make the activity's time unique.
|
static void |
addActivity(SocialActivity activity,
SocialActivity mirrorActivity) |
static SocialActivity |
addSocialActivity(SocialActivity socialActivity)
Adds the social activity to the database.
|
static void |
addUniqueActivity(long userId,
long groupId,
Date createDate,
String className,
long classPK,
int type,
String extraData,
long receiverUserId)
Records an activity in the database, but only if there isn't already an
activity with the same parameters.
|
static void |
addUniqueActivity(long userId,
long groupId,
String className,
long classPK,
int type,
String extraData,
long receiverUserId)
Records an activity with the current time in the database, but only if
there isn't one with the same parameters.
|
static SocialActivity |
createSocialActivity(long activityId)
Creates a new social activity with the primary key.
|
static void |
deleteActivities(AssetEntry assetEntry)
Removes stored activities for the asset.
|
static void |
deleteActivities(long groupId) |
static void |
deleteActivities(String className,
long classPK)
Removes stored activities for the asset identified by the class name and
class primary key.
|
static void |
deleteActivity(long activityId)
Removes the stored activity from the database.
|
static void |
deleteActivity(SocialActivity activity)
Removes the stored activity and its mirror activity from the database.
|
static PersistedModel |
deletePersistedModel(PersistedModel persistedModel) |
static SocialActivity |
deleteSocialActivity(long activityId)
Deletes the social activity with the primary key from the database.
|
static SocialActivity |
deleteSocialActivity(SocialActivity socialActivity)
Deletes the social activity from the database.
|
static void |
deleteUserActivities(long userId)
Removes the user's stored activities from the database.
|
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 SocialActivity |
fetchFirstActivity(String className,
long classPK,
int type) |
static SocialActivity |
fetchSocialActivity(long activityId) |
static ActionableDynamicQuery |
getActionableDynamicQuery() |
static List<SocialActivity> |
getActivities(long classNameId,
int start,
int end)
Returns a range of all the activities done on assets identified by the
class name ID.
|
static List<SocialActivity> |
getActivities(long mirrorActivityId,
long classNameId,
long classPK,
int start,
int end)
Returns a range of all the activities done on the asset identified by the
class name ID and class primary key that are mirrors of the activity
identified by the mirror activity ID.
|
static List<SocialActivity> |
getActivities(long mirrorActivityId,
String className,
long classPK,
int start,
int end)
Returns a range of all the activities done on the asset identified by the
class name and the class primary key that are mirrors of the activity
identified by the mirror activity ID.
|
static List<SocialActivity> |
getActivities(String className,
int start,
int end)
Returns a range of all the activities done on assets identified by the
class name.
|
static int |
getActivitiesCount(long classNameId)
Returns the number of activities done on assets identified by the class
name ID.
|
static int |
getActivitiesCount(long userId,
long groupId,
Date createDate,
String className,
long classPK,
int type,
long receiverUserId) |
static int |
getActivitiesCount(long mirrorActivityId,
long classNameId,
long classPK)
Returns the number of activities done on the asset identified by the
class name ID and class primary key that are mirrors of the activity
identified by the mirror activity ID.
|
static int |
getActivitiesCount(long mirrorActivityId,
String className,
long classPK)
Returns the number of activities done on the asset identified by the
class name and class primary key that are mirrors of the activity
identified by the mirror activity ID.
|
static int |
getActivitiesCount(String className)
Returns the number of activities done on assets identified by class name.
|
static SocialActivity |
getActivity(long activityId)
Returns the activity identified by its primary key.
|
static List<SocialActivity> |
getActivitySetActivities(long activitySetId,
int start,
int end) |
static List<SocialActivity> |
getGroupActivities(long groupId,
int start,
int end)
Returns a range of all the activities done in the group.
|
static int |
getGroupActivitiesCount(long groupId)
Returns the number of activities done in the group.
|
static List<SocialActivity> |
getGroupUsersActivities(long groupId,
int start,
int end)
Returns a range of activities done by users that are members of the
group.
|
static int |
getGroupUsersActivitiesCount(long groupId)
Returns the number of activities done by users that are members of the
group.
|
static IndexableActionableDynamicQuery |
getIndexableActionableDynamicQuery() |
static SocialActivity |
getMirrorActivity(long mirrorActivityId)
Returns the activity that has the mirror activity.
|
static List<SocialActivity> |
getOrganizationActivities(long organizationId,
int start,
int end)
Returns a range of all the activities done in the organization.
|
static int |
getOrganizationActivitiesCount(long organizationId)
Returns the number of activities done in the organization.
|
static List<SocialActivity> |
getOrganizationUsersActivities(long organizationId,
int start,
int end)
Returns a range of all the activities done by users of the organization.
|
static int |
getOrganizationUsersActivitiesCount(long organizationId)
Returns the number of activities done by users of the organization.
|
static String |
getOSGiServiceIdentifier()
Returns the OSGi service identifier.
|
static PersistedModel |
getPersistedModel(Serializable primaryKeyObj) |
static List<SocialActivity> |
getRelationActivities(long userId,
int start,
int end)
Returns a range of all the activities done by users in a relationship
with the user identified by the user ID.
|
static List<SocialActivity> |
getRelationActivities(long userId,
int type,
int start,
int end)
Returns a range of all the activities done by users in a relationship of
type
type with the user identified by userId . |
static int |
getRelationActivitiesCount(long userId)
Returns the number of activities done by users in a relationship with the
user identified by userId.
|
static int |
getRelationActivitiesCount(long userId,
int type)
Returns the number of activities done by users in a relationship of type
type with the user identified by userId . |
static SocialActivityLocalService |
getService() |
static List<SocialActivity> |
getSocialActivities(int start,
int end)
Returns a range of all the social activities.
|
static int |
getSocialActivitiesCount()
Returns the number of social activities.
|
static SocialActivity |
getSocialActivity(long activityId)
Returns the social activity with the primary key.
|
static List<SocialActivity> |
getUserActivities(long userId,
int start,
int end)
Returns a range of all the activities done by the user.
|
static int |
getUserActivitiesCount(long userId)
Returns the number of activities done by the user.
|
static List<SocialActivity> |
getUserGroupsActivities(long userId,
int start,
int end)
Returns a range of all the activities done in the user's groups.
|
static int |
getUserGroupsActivitiesCount(long userId)
Returns the number of activities done in user's groups.
|
static List<SocialActivity> |
getUserGroupsAndOrganizationsActivities(long userId,
int start,
int end)
Returns a range of all the activities done in the user's groups and
organizations.
|
static int |
getUserGroupsAndOrganizationsActivitiesCount(long userId)
Returns the number of activities done in user's groups and organizations.
|
static List<SocialActivity> |
getUserOrganizationsActivities(long userId,
int start,
int end)
Returns a range of all activities done in the user's organizations.
|
static int |
getUserOrganizationsActivitiesCount(long userId)
Returns the number of activities done in the user's organizations.
|
static SocialActivity |
updateSocialActivity(SocialActivity socialActivity)
Updates the social activity in the database or adds it if it does not yet exist.
|
public static void addActivity(long userId, long groupId, Date createDate, String className, long classPK, int type, String extraData, long receiverUserId) throws PortalException
This method records a social activity done on an asset, identified by its
class name and class primary key, in the database. Additional information
(such as the original message ID for a reply to a forum post) is passed
in via the extraData
in JSON format. For activities
affecting another user, a mirror activity is generated that describes the
action from the user's point of view. The target user's ID is passed in
via the receiverUserId
.
Example for a mirrored activity:
When a user replies to a message
boards post, the reply action is stored in the database with the
receiverUserId
being the ID of the author of the original
message. The extraData
contains the ID of the original
message in JSON format. A mirror activity is generated with the values of
the userId
and the receiverUserId
swapped. This
mirror activity basically describes a "replied to" event.
Mirror activities are most often used in relation to friend requests and activities.
userId
- the primary key of the acting usergroupId
- the primary key of the groupcreateDate
- the activity's dateclassName
- the target asset's class nameclassPK
- the primary key of the target assettype
- the activity's typeextraData
- any extra data regarding the activityreceiverUserId
- the primary key of the receiving userPortalException
public static void addActivity(long userId, long groupId, String className, long classPK, int type, String extraData, long receiverUserId) throws PortalException
userId
- the primary key of the acting usergroupId
- the primary key of the groupclassName
- the target asset's class nameclassPK
- the primary key of the target assettype
- the activity's typeextraData
- any extra data regarding the activityreceiverUserId
- the primary key of the receiving userPortalException
public static void addActivity(SocialActivity activity, SocialActivity mirrorActivity) throws PortalException
PortalException
public static SocialActivity addSocialActivity(SocialActivity socialActivity)
socialActivity
- the social activitypublic static void addUniqueActivity(long userId, long groupId, Date createDate, String className, long classPK, int type, String extraData, long receiverUserId) throws PortalException
For the main functionality see addActivity(long, long, Date,
String, long, int, String, long)
userId
- the primary key of the acting usergroupId
- the primary key of the groupcreateDate
- the activity's dateclassName
- the target asset's class nameclassPK
- the primary key of the target assettype
- the activity's typeextraData
- any extra data regarding the activityreceiverUserId
- the primary key of the receiving userPortalException
public static void addUniqueActivity(long userId, long groupId, String className, long classPK, int type, String extraData, long receiverUserId) throws PortalException
For the main functionality see addActivity(long, long, Date,
String, long, int, String, long)
userId
- the primary key of the acting usergroupId
- the primary key of the groupclassName
- the target asset's class nameclassPK
- the primary key of the target assettype
- the activity's typeextraData
- any extra data regarding the activityreceiverUserId
- the primary key of the receiving userPortalException
public static SocialActivity createSocialActivity(long activityId)
activityId
- the primary key for the new social activitypublic static void deleteActivities(AssetEntry assetEntry) throws PortalException
assetEntry
- the asset from which to remove stored activitiesPortalException
public static void deleteActivities(long groupId)
public static void deleteActivities(String className, long classPK) throws PortalException
className
- the target asset's class nameclassPK
- the primary key of the target assetPortalException
public static void deleteActivity(long activityId) throws PortalException
activityId
- the primary key of the stored activityPortalException
public static void deleteActivity(SocialActivity activity) throws PortalException
activity
- the activity to be removedPortalException
public static PersistedModel deletePersistedModel(PersistedModel persistedModel) throws PortalException
PortalException
public static SocialActivity deleteSocialActivity(long activityId) throws PortalException
activityId
- the primary key of the social activityPortalException
- if a social activity with the primary key could not be foundpublic static SocialActivity deleteSocialActivity(SocialActivity socialActivity)
socialActivity
- the social activitypublic static void deleteUserActivities(long userId) throws PortalException
This method removes all activities where the user is either the actor or the receiver.
userId
- the primary key of the userPortalException
public static DynamicQuery dynamicQuery()
public static <T> List<T> dynamicQuery(DynamicQuery dynamicQuery)
dynamicQuery
- the dynamic querypublic static <T> List<T> dynamicQuery(DynamicQuery dynamicQuery, int start, int end)
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 SocialActivityModelImpl
. 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.
dynamicQuery
- the dynamic querystart
- the lower bound of the range of model instancesend
- the upper bound of the range of model instances (not inclusive)public static <T> List<T> dynamicQuery(DynamicQuery dynamicQuery, int start, int end, OrderByComparator<T> orderByComparator)
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 SocialActivityModelImpl
. 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.
dynamicQuery
- the dynamic querystart
- the lower bound of the range of model instancesend
- the upper bound of the range of model instances (not inclusive)orderByComparator
- the comparator to order the results by (optionally null
)public static long dynamicQueryCount(DynamicQuery dynamicQuery)
dynamicQuery
- the dynamic querypublic static long dynamicQueryCount(DynamicQuery dynamicQuery, Projection projection)
dynamicQuery
- the dynamic queryprojection
- the projection to apply to the querypublic static SocialActivity fetchFirstActivity(String className, long classPK, int type)
public static SocialActivity fetchSocialActivity(long activityId)
public static ActionableDynamicQuery getActionableDynamicQuery()
public static List<SocialActivity> getActivities(long classNameId, int start, int end)
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.
classNameId
- the target asset's class name IDstart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static List<SocialActivity> getActivities(long mirrorActivityId, long classNameId, long classPK, int start, int end)
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.
mirrorActivityId
- the primary key of the mirror activityclassNameId
- the target asset's class name IDclassPK
- the primary key of the target assetstart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static List<SocialActivity> getActivities(long mirrorActivityId, String className, long classPK, int start, int end)
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.
mirrorActivityId
- the primary key of the mirror activityclassName
- the target asset's class nameclassPK
- the primary key of the target assetstart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static List<SocialActivity> getActivities(String className, int start, int end)
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.
className
- the target asset's class namestart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static int getActivitiesCount(long classNameId)
classNameId
- the target asset's class name IDpublic static int getActivitiesCount(long userId, long groupId, Date createDate, String className, long classPK, int type, long receiverUserId)
public static int getActivitiesCount(long mirrorActivityId, long classNameId, long classPK)
mirrorActivityId
- the primary key of the mirror activityclassNameId
- the target asset's class name IDclassPK
- the primary key of the target assetpublic static int getActivitiesCount(long mirrorActivityId, String className, long classPK)
mirrorActivityId
- the primary key of the mirror activityclassName
- the target asset's class nameclassPK
- the primary key of the target assetpublic static int getActivitiesCount(String className)
className
- the target asset's class namepublic static SocialActivity getActivity(long activityId) throws PortalException
activityId
- the primary key of the activityPortalException
public static List<SocialActivity> getActivitySetActivities(long activitySetId, int start, int end)
public static List<SocialActivity> getGroupActivities(long groupId, int start, int end)
This method only finds activities without mirrors.
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.
groupId
- the primary key of the groupstart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static int getGroupActivitiesCount(long groupId)
This method only counts activities without mirrors.
groupId
- the primary key of the grouppublic static List<SocialActivity> getGroupUsersActivities(long groupId, int start, int end)
This method only finds activities without mirrors.
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.
groupId
- the primary key of the groupstart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static int getGroupUsersActivitiesCount(long groupId)
This method only counts activities without mirrors.
groupId
- the primary key of the grouppublic static IndexableActionableDynamicQuery getIndexableActionableDynamicQuery()
public static SocialActivity getMirrorActivity(long mirrorActivityId) throws PortalException
mirrorActivityId
- the primary key of the mirror activityPortalException
public static List<SocialActivity> getOrganizationActivities(long organizationId, int start, int end)
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.
organizationId
- the primary key of the organizationstart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static int getOrganizationActivitiesCount(long organizationId)
organizationId
- the primary key of the organizationpublic static List<SocialActivity> getOrganizationUsersActivities(long organizationId, int start, int end)
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.
organizationId
- the primary key of the organizationstart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static int getOrganizationUsersActivitiesCount(long organizationId)
organizationId
- the primary key of the organizationpublic static String getOSGiServiceIdentifier()
public static PersistedModel getPersistedModel(Serializable primaryKeyObj) throws PortalException
PortalException
public static List<SocialActivity> getRelationActivities(long userId, int start, int end)
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.
userId
- the primary key of the userstart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static List<SocialActivity> getRelationActivities(long userId, int type, int start, int end)
type
with the user identified by userId
.
This method only finds activities without mirrors.
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.
userId
- the primary key of the usertype
- the relationship typestart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static int getRelationActivitiesCount(long userId)
userId
- the primary key of the userpublic static int getRelationActivitiesCount(long userId, int type)
type
with the user identified by userId
. This
method only counts activities without mirrors.userId
- the primary key of the usertype
- the relationship typepublic static List<SocialActivity> getSocialActivities(int start, int end)
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 SocialActivityModelImpl
. 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.
start
- the lower bound of the range of social activitiesend
- the upper bound of the range of social activities (not inclusive)public static int getSocialActivitiesCount()
public static SocialActivity getSocialActivity(long activityId) throws PortalException
activityId
- the primary key of the social activityPortalException
- if a social activity with the primary key could not be foundpublic static List<SocialActivity> getUserActivities(long userId, int start, int end)
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.
userId
- the primary key of the userstart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static int getUserActivitiesCount(long userId)
userId
- the primary key of the userpublic static List<SocialActivity> getUserGroupsActivities(long userId, int start, int end)
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.
userId
- the primary key of the userstart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static int getUserGroupsActivitiesCount(long userId)
userId
- the primary key of the userpublic static List<SocialActivity> getUserGroupsAndOrganizationsActivities(long userId, int start, int end)
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.
userId
- the primary key of the userstart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static int getUserGroupsAndOrganizationsActivitiesCount(long userId)
userId
- the primary key of the userpublic static List<SocialActivity> getUserOrganizationsActivities(long userId, int start, int end)
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.
userId
- the primary key of the userstart
- the lower bound of the range of resultsend
- the upper bound of the range of results (not inclusive)public static int getUserOrganizationsActivitiesCount(long userId)
userId
- the primary key of the userpublic static SocialActivity updateSocialActivity(SocialActivity socialActivity)
socialActivity
- the social activitypublic static SocialActivityLocalService getService()