Liferay 6.1.0

com.liferay.portlet.social.service
Class SocialEquityUserLocalServiceUtil

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

public class SocialEquityUserLocalServiceUtil
extends Object

The utility for the social equity user local service. This utility wraps com.liferay.portlet.social.service.impl.SocialEquityUserLocalServiceImpl and is the primary access point for service operations in application layer code running on the local server.

This is a local service. 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:
SocialEquityUserLocalService, com.liferay.portlet.social.service.base.SocialEquityUserLocalServiceBaseImpl, com.liferay.portlet.social.service.impl.SocialEquityUserLocalServiceImpl

Constructor Summary
SocialEquityUserLocalServiceUtil()
           
 
Method Summary
static SocialEquityUser addSocialEquityUser(SocialEquityUser socialEquityUser)
          Adds the social equity user to the database.
static void clearRanks(long userId)
          Removes ranking for the user with respect to all groups.
static SocialEquityUser createSocialEquityUser(long equityUserId)
          Creates a new social equity user with the primary key.
static void deleteSocialEquityUser(long equityUserId)
          Deletes the social equity user with the primary key from the database.
static void deleteSocialEquityUser(SocialEquityUser socialEquityUser)
          Deletes the social equity user from the database.
static List dynamicQuery(DynamicQuery dynamicQuery)
          Performs a dynamic query on the database and returns the matching rows.
static List dynamicQuery(DynamicQuery dynamicQuery, int start, int end)
          Performs a dynamic query on the database and returns a range of the matching rows.
static List dynamicQuery(DynamicQuery dynamicQuery, int start, int end, OrderByComparator 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 that match the dynamic query.
static String getBeanIdentifier()
          Returns the Spring bean ID for this bean.
static SocialEquityValue getContributionEquity(long userId)
          Returns the contribution equity score for the user.
static SocialEquityValue getContributionEquity(long userId, long groupId)
          Returns the contribution equity score of the user with respect to the group.
static SocialEquityValue getParticipationEquity(long userId)
          Returns the participation equity score for the user.
static SocialEquityValue getParticipationEquity(long userId, long groupId)
          Returns the participation equity score of the user with respect to the group.
static PersistedModel getPersistedModel(Serializable primaryKeyObj)
           
static int getRank(long groupId, long userId)
          Returns the rank of the user in the group based on the user's personal equity.
static List<SocialEquityUser> getRankedEquityUsers(long groupId, int start, int end, OrderByComparator orderByComparator)
          Returns an ordered range of all the social equity users in the group with rankings greater than zero.
static int getRankedEquityUsersCount(long groupId)
          Returns the number of the social equity users in the group with rankings greater than zero.
static SocialEquityUserLocalService getService()
           
static SocialEquityUser getSocialEquityUser(long equityUserId)
          Returns the social equity user with the primary key.
static List<SocialEquityUser> getSocialEquityUsers(int start, int end)
          Returns a range of all the social equity users.
static int getSocialEquityUsersCount()
          Returns the number of social equity users.
static void setBeanIdentifier(String beanIdentifier)
          Sets the Spring bean ID for this bean.
 void setService(SocialEquityUserLocalService service)
           
static SocialEquityUser updateSocialEquityUser(SocialEquityUser socialEquityUser)
          Updates the social equity user in the database or adds it if it does not yet exist.
static SocialEquityUser updateSocialEquityUser(SocialEquityUser socialEquityUser, boolean merge)
          Updates the social equity user 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

SocialEquityUserLocalServiceUtil

public SocialEquityUserLocalServiceUtil()
Method Detail

addSocialEquityUser

public static SocialEquityUser addSocialEquityUser(SocialEquityUser socialEquityUser)
                                            throws SystemException
Adds the social equity user to the database. Also notifies the appropriate model listeners.

Parameters:
socialEquityUser - the social equity user
Returns:
the social equity user that was added
Throws:
SystemException - if a system exception occurred

createSocialEquityUser

public static SocialEquityUser createSocialEquityUser(long equityUserId)
Creates a new social equity user with the primary key. Does not add the social equity user to the database.

Parameters:
equityUserId - the primary key for the new social equity user
Returns:
the new social equity user

deleteSocialEquityUser

public static void deleteSocialEquityUser(long equityUserId)
                                   throws PortalException,
                                          SystemException
Deletes the social equity user with the primary key from the database. Also notifies the appropriate model listeners.

Parameters:
equityUserId - the primary key of the social equity user
Throws:
PortalException - if a social equity user with the primary key could not be found
SystemException - if a system exception occurred

deleteSocialEquityUser

public static void deleteSocialEquityUser(SocialEquityUser socialEquityUser)
                                   throws SystemException
Deletes the social equity user from the database. Also notifies the appropriate model listeners.

Parameters:
socialEquityUser - the social equity user
Throws:
SystemException - if a system exception occurred

dynamicQuery

public static List dynamicQuery(DynamicQuery dynamicQuery)
                         throws SystemException
Performs a dynamic query on the database and returns the matching rows.

Parameters:
dynamicQuery - the dynamic query
Returns:
the matching rows
Throws:
SystemException - if a system exception occurred

dynamicQuery

public static List dynamicQuery(DynamicQuery dynamicQuery,
                                int start,
                                int end)
                         throws SystemException
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.

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
Throws:
SystemException - if a system exception occurred

dynamicQuery

public static List dynamicQuery(DynamicQuery dynamicQuery,
                                int start,
                                int end,
                                OrderByComparator orderByComparator)
                         throws SystemException
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.

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
Throws:
SystemException - if a system exception occurred

dynamicQueryCount

public static long dynamicQueryCount(DynamicQuery dynamicQuery)
                              throws SystemException
Returns the number of rows that match the dynamic query.

Parameters:
dynamicQuery - the dynamic query
Returns:
the number of rows that match the dynamic query
Throws:
SystemException - if a system exception occurred

getSocialEquityUser

public static SocialEquityUser getSocialEquityUser(long equityUserId)
                                            throws PortalException,
                                                   SystemException
Returns the social equity user with the primary key.

Parameters:
equityUserId - the primary key of the social equity user
Returns:
the social equity user
Throws:
PortalException - if a social equity user with the primary key could not be found
SystemException - if a system exception occurred

getPersistedModel

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

getSocialEquityUsers

public static List<SocialEquityUser> getSocialEquityUsers(int start,
                                                          int end)
                                                   throws SystemException
Returns a range of all the social equity users.

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:
start - the lower bound of the range of social equity users
end - the upper bound of the range of social equity users (not inclusive)
Returns:
the range of social equity users
Throws:
SystemException - if a system exception occurred

getSocialEquityUsersCount

public static int getSocialEquityUsersCount()
                                     throws SystemException
Returns the number of social equity users.

Returns:
the number of social equity users
Throws:
SystemException - if a system exception occurred

updateSocialEquityUser

public static SocialEquityUser updateSocialEquityUser(SocialEquityUser socialEquityUser)
                                               throws SystemException
Updates the social equity user in the database or adds it if it does not yet exist. Also notifies the appropriate model listeners.

Parameters:
socialEquityUser - the social equity user
Returns:
the social equity user that was updated
Throws:
SystemException - if a system exception occurred

updateSocialEquityUser

public static SocialEquityUser updateSocialEquityUser(SocialEquityUser socialEquityUser,
                                                      boolean merge)
                                               throws SystemException
Updates the social equity user in the database or adds it if it does not yet exist. Also notifies the appropriate model listeners.

Parameters:
socialEquityUser - the social equity user
merge - whether to merge the social equity user with the current session. See BatchSession.update(com.liferay.portal.kernel.dao.orm.Session, com.liferay.portal.model.BaseModel, boolean) for an explanation.
Returns:
the social equity user that was updated
Throws:
SystemException - if a system exception occurred

getBeanIdentifier

public static String getBeanIdentifier()
Returns the Spring bean ID for this bean.

Returns:
the Spring bean ID for this bean

setBeanIdentifier

public static void setBeanIdentifier(String beanIdentifier)
Sets the Spring bean ID for this bean.

Parameters:
beanIdentifier - the Spring bean ID for this bean

clearRanks

public static void clearRanks(long userId)
                       throws SystemException
Removes ranking for the user with respect to all groups.

This method is called by the portal when a user is deactivated.

Parameters:
userId - the primary key of the user
Throws:
SystemException - if a system exception occurred

getContributionEquity

public static SocialEquityValue getContributionEquity(long userId)
                                               throws SystemException
Returns the contribution equity score for the user.

This method should only be used if social equity is turned on for only one group, as it returns the contribution score for the first group it finds. The first group found can be different from one execution to the next.

Parameters:
userId - the primary key of the user
Returns:
the contribution equity score
Throws:
SystemException - if a system exception occurred

getContributionEquity

public static SocialEquityValue getContributionEquity(long userId,
                                                      long groupId)
                                               throws SystemException
Returns the contribution equity score of the user with respect to the group.

Parameters:
userId - the primary key of the user
groupId - the primary key of the group
Returns:
the contribution equity score
Throws:
SystemException - if a system exception occurred

getParticipationEquity

public static SocialEquityValue getParticipationEquity(long userId)
                                                throws SystemException
Returns the participation equity score for the user.

This method should only be used if social equity is turned on for only one group, as it returns the participation score for the first group it finds. The first group found can be different from one execution to the next.

Parameters:
userId - the primary key of the user
Returns:
the participation equity score
Throws:
SystemException - if a system exception occurred

getParticipationEquity

public static SocialEquityValue getParticipationEquity(long userId,
                                                       long groupId)
                                                throws SystemException
Returns the participation equity score of the user with respect to the group.

Parameters:
userId - the primary key of the user
groupId - the primary key of the group
Returns:
the participation equity score
Throws:
SystemException - if a system exception occurred

getRank

public static int getRank(long groupId,
                          long userId)
                   throws SystemException
Returns the rank of the user in the group based on the user's personal equity.

Parameters:
groupId - the primary key of the group
userId - the primary key of the user
Returns:
the rank for the user in the group
Throws:
SystemException - if a system exception occurred

getRankedEquityUsers

public static List<SocialEquityUser> getRankedEquityUsers(long groupId,
                                                          int start,
                                                          int end,
                                                          OrderByComparator orderByComparator)
                                                   throws SystemException
Returns an ordered range of all the social equity users in the group with rankings greater than zero. It is strongly suggested to use SocialEquityUserRankComparator as the ordering comparator.

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:
groupId - the primary key of the group
start - the lower bound of the range of results
end - the upper bound of the range of results (not inclusive)
orderByComparator - the comparator to order the social equity users, such as SocialEquityUserRankComparator (optionally null)
Returns:
the ordered range of the social equity users
Throws:
SystemException - if a system exception occurred

getRankedEquityUsersCount

public static int getRankedEquityUsersCount(long groupId)
                                     throws SystemException
Returns the number of the social equity users in the group with rankings greater than zero.

Parameters:
groupId - the primary key of the group
Returns:
the number of social equity users with rankings greater than zero
Throws:
SystemException - if a system exception occurred

getService

public static SocialEquityUserLocalService getService()

setService

public void setService(SocialEquityUserLocalService service)

Liferay 6.1.0