Liferay 6.2-ce-ga5

com.liferay.portal.service
Class GroupServiceUtil

java.lang.Object
  extended by com.liferay.portal.service.GroupServiceUtil

@ProviderType
public class GroupServiceUtil
extends Object

Provides the remote service utility for Group. This utility wraps com.liferay.portal.service.impl.GroupServiceImpl and is the primary access point for service operations in application layer code running on a remote server. Methods of this service are expected to have security checks based on the propagated JAAS credentials because this service can be accessed remotely.

See Also:
GroupService, GroupServiceBaseImpl, com.liferay.portal.service.impl.GroupServiceImpl

Constructor Summary
GroupServiceUtil()
           
 
Method Summary
static Group addGroup(long parentGroupId, long liveGroupId, String name, String description, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean site, boolean active, ServiceContext serviceContext)
          Adds a group.
static Group addGroup(long parentGroupId, String name, String description, int type, String friendlyURL, boolean site, boolean active, ServiceContext serviceContext)
          Deprecated. As of 6.2.0, replaced by addGroup(long, long, String, String, int, boolean, int, String, boolean, boolean, ServiceContext)
static Group addGroup(String name, String description, int type, String friendlyURL, boolean site, boolean active, ServiceContext serviceContext)
          Deprecated. As of 6.2.0, replaced by addGroup(long, String, String, int, String, boolean, boolean, ServiceContext)
static void addRoleGroups(long roleId, long[] groupIds)
          Adds the groups to the role.
static void checkRemoteStagingGroup(long groupId)
          Checks that the current user is permitted to use the group for Remote Staging.
static void deleteGroup(long groupId)
          Deletes the group.
static void disableStaging(long groupId)
           
static void enableStaging(long groupId)
           
static String getBeanIdentifier()
          Returns the Spring bean ID for this bean.
static Group getCompanyGroup(long companyId)
          Returns the company group.
static Group getGroup(long groupId)
          Returns the group with the primary key.
static Group getGroup(long companyId, String name)
          Returns the group with the name.
static List<Group> getGroups(long companyId, long parentGroupId, boolean site)
          Returns all the groups that are direct children of the parent group.
static List<Group> getManageableSiteGroups(Collection<Portlet> portlets, int max)
          Returns a range of all the site groups for which the user has control panel access.
static List<Group> getManageableSites(Collection<Portlet> portlets, int max)
          Deprecated. As of 6.2.0, replaced by getManageableSiteGroups(Collection, int)
static List<Group> getOrganizationsGroups(List<Organization> organizations)
          Returns the groups associated with the organizations.
static GroupService getService()
           
static Group getUserGroup(long companyId, long userId)
          Returns the group associated with the user.
static List<Group> getUserGroupsGroups(List<UserGroup> userGroups)
          Returns the groups associated with the user groups.
static List<Group> getUserOrganizationsGroups(long userId, int start, int end)
          Returns the range of all groups associated with the user's organization groups, including the ancestors of the organization groups, unless portal property organizations.membership.strict is set to true.
static List<Group> getUserPlaces(long userId, String[] classNames, boolean includeControlPanel, int max)
          Deprecated. As of 6.2.0, replaced by getUserSitesGroups(long, String[], boolean, int)
static List<Group> getUserPlaces(long userId, String[] classNames, int max)
          Deprecated. As of 6.2.0, replaced by getUserSitesGroups(long, String[], int)
static List<Group> getUserPlaces(String[] classNames, int max)
          Deprecated. As of 6.2.0, replaced by getUserSitesGroups( String[], int)
static int getUserPlacesCount()
          Deprecated. As of 6.2.0, replaced by getUserSitesGroupsCount()
static List<Group> getUserSites()
          Deprecated. As of 6.2.0, replaced by getUserSitesGroups()
static List<Group> getUserSitesGroups()
           
static List<Group> getUserSitesGroups(long userId, String[] classNames, boolean includeControlPanel, int max)
           
static List<Group> getUserSitesGroups(long userId, String[] classNames, int max)
          Returns the user's groups "sites" associated with the group entity class names, including the Control Panel group if the user is permitted to view the Control Panel.
static List<Group> getUserSitesGroups(String[] classNames, int max)
          Returns the guest or current user's groups "sites" associated with the group entity class names, including the Control Panel group if the user is permitted to view the Control Panel.
static int getUserSitesGroupsCount()
          Returns the number of the guest or current user's groups "sites" associated with the group entity class names, including the Control Panel group if the user is permitted to view the Control Panel.
static boolean hasUserGroup(long userId, long groupId)
          Returns true if the user is associated with the group, including the user's inherited organizations and user groups.
static List<Group> search(long companyId, long[] classNameIds, String keywords, LinkedHashMap<String,Object> params, int start, int end, OrderByComparator obc)
           
static List<Group> search(long companyId, long[] classNameIds, String name, String description, LinkedHashMap<String,Object> params, boolean andOperator, int start, int end, OrderByComparator obc)
           
static List<Group> search(long companyId, String name, String description, String[] params, int start, int end)
          Returns an ordered range of all the site groups and organization groups that match the name and description, optionally including the user's inherited organization groups and user groups.
static int searchCount(long companyId, String name, String description, String[] params)
          Returns the number of groups and organization groups that match the name and description, optionally including the user's inherited organizations and user groups.
static void setBeanIdentifier(String beanIdentifier)
          Sets the Spring bean ID for this bean.
static void setRoleGroups(long roleId, long[] groupIds)
          Sets the groups associated with the role, removing and adding associations as necessary.
 void setService(GroupService service)
          Deprecated. As of 6.2.0
static void unsetRoleGroups(long roleId, long[] groupIds)
          Removes the groups from the role.
static Group updateFriendlyURL(long groupId, String friendlyURL)
          Updates the group's friendly URL.
static Group updateGroup(long groupId, long parentGroupId, String name, String description, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean active, ServiceContext serviceContext)
          Updates the group.
static Group updateGroup(long groupId, String typeSettings)
          Updates the group's type settings.
static void updateStagedPortlets(long groupId, Map<String,String> stagedPortletIds)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

GroupServiceUtil

public GroupServiceUtil()
Method Detail

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

addGroup

public static Group addGroup(long parentGroupId,
                             long liveGroupId,
                             String name,
                             String description,
                             int type,
                             boolean manualMembership,
                             int membershipRestriction,
                             String friendlyURL,
                             boolean site,
                             boolean active,
                             ServiceContext serviceContext)
                      throws PortalException,
                             SystemException
Adds a group.

Parameters:
parentGroupId - the primary key of the parent group
liveGroupId - the primary key of the live group
name - the entity's name
description - the group's description (optionally null)
type - the group's type. For more information see GroupConstants
friendlyURL - the group's friendlyURL (optionally null)
site - whether the group is to be associated with a main site
active - whether the group is active
serviceContext - the service context to be applied (optionally null). Can set the asset category IDs and asset tag names for the group, and can set whether the group is for staging
Returns:
the group
Throws:
PortalException - if the user did not have permission to add the group, if a creator could not be found, if the group's information was invalid, if a layout could not be found, or if a valid friendly URL could not be created for the group
SystemException - if a system exception occurred

addGroup

public static Group addGroup(long parentGroupId,
                             String name,
                             String description,
                             int type,
                             String friendlyURL,
                             boolean site,
                             boolean active,
                             ServiceContext serviceContext)
                      throws PortalException,
                             SystemException
Deprecated. As of 6.2.0, replaced by addGroup(long, long, String, String, int, boolean, int, String, boolean, boolean, ServiceContext)

Adds the group using the group default live group ID.

Parameters:
parentGroupId - the primary key of the parent group
name - the entity's name
description - the group's description (optionally null)
type - the group's type. For more information see GroupConstants
friendlyURL - the group's friendlyURL
site - whether the group is to be associated with a main site
active - whether the group is active
serviceContext - the service context to be applied (optionally null). Can set asset category IDs and asset tag names for the group, and can set whether the group is for staging
Returns:
the group
Throws:
PortalException - if the user did not have permission to add the group, if a creator could not be found, if the group's information was invalid, if a layout could not be found, or if a valid friendly URL could not be created for the group
SystemException - if a system exception occurred

addGroup

public static Group addGroup(String name,
                             String description,
                             int type,
                             String friendlyURL,
                             boolean site,
                             boolean active,
                             ServiceContext serviceContext)
                      throws PortalException,
                             SystemException
Deprecated. As of 6.2.0, replaced by addGroup(long, String, String, int, String, boolean, boolean, ServiceContext)

Throws:
PortalException
SystemException

addRoleGroups

public static void addRoleGroups(long roleId,
                                 long[] groupIds)
                          throws PortalException,
                                 SystemException
Adds the groups to the role.

Parameters:
roleId - the primary key of the role
groupIds - the primary keys of the groups
Throws:
PortalException - if the user did not have permission to update the role
SystemException - if a system exception occurred

checkRemoteStagingGroup

public static void checkRemoteStagingGroup(long groupId)
                                    throws PortalException,
                                           SystemException
Checks that the current user is permitted to use the group for Remote Staging.

Parameters:
groupId - the primary key of the group
Throws:
PortalException - if a group with the primary key could not be found, if the current user did not have permission to view the group, or if the group's company was different from the current user's company
SystemException - if a system exception occurred

deleteGroup

public static void deleteGroup(long groupId)
                        throws PortalException,
                               SystemException
Deletes the group.

The group is unstaged and its assets and resources including layouts, membership requests, subscriptions, teams, blogs, bookmarks, calendar events, image gallery, journals, message boards, polls, shopping related entities, software catalog, and wikis are also deleted.

Parameters:
groupId - the primary key of the group
Throws:
PortalException - if the user did not have permission to delete the group or its assets or resources, if a group with the primary key could not be found, or if the group was a system group
SystemException - if a system exception occurred

disableStaging

public static void disableStaging(long groupId)
                           throws PortalException,
                                  SystemException
Throws:
PortalException
SystemException

enableStaging

public static void enableStaging(long groupId)
                          throws PortalException,
                                 SystemException
Throws:
PortalException
SystemException

getCompanyGroup

public static Group getCompanyGroup(long companyId)
                             throws PortalException,
                                    SystemException
Returns the company group.

Parameters:
companyId - the primary key of the company
Returns:
the group associated with the company
Throws:
PortalException - if a matching group could not be found
SystemException - if a system exception occurred

getGroup

public static Group getGroup(long groupId)
                      throws PortalException,
                             SystemException
Returns the group with the primary key.

Parameters:
groupId - the primary key of the group
Returns:
the group with the primary key
Throws:
PortalException - if a group with the primary key could not be found or if the current user did not have permission to view the group
SystemException - if a system exception occurred

getGroup

public static Group getGroup(long companyId,
                             String name)
                      throws PortalException,
                             SystemException
Returns the group with the name.

Parameters:
companyId - the primary key of the company
name - the group's name
Returns:
the group with the name
Throws:
PortalException - if a matching group could not be found or if the current user did not have permission to view the group
SystemException - if a system exception occurred

getGroups

public static List<Group> getGroups(long companyId,
                                    long parentGroupId,
                                    boolean site)
                             throws PortalException,
                                    SystemException
Returns all the groups that are direct children of the parent group.

Parameters:
companyId - the primary key of the company
parentGroupId - the primary key of the parent group
site - whether the group is to be associated with a main site
Returns:
the matching groups, or null if no matches were found
Throws:
PortalException - if the user did not have permission to view the group or if a portal exception occurred
SystemException - if a system exception occurred

getManageableSiteGroups

public static List<Group> getManageableSiteGroups(Collection<Portlet> portlets,
                                                  int max)
                                           throws PortalException,
                                                  SystemException
Returns a range of all the site groups for which the user has control panel access.

Parameters:
portlets - the portlets to manage
max - the upper bound of the range of groups to consider (not inclusive)
Returns:
the range of site groups for which the user has Control Panel access
Throws:
PortalException - if a portal exception occurred
SystemException - if a system exception occurred

getManageableSites

public static List<Group> getManageableSites(Collection<Portlet> portlets,
                                             int max)
                                      throws PortalException,
                                             SystemException
Deprecated. As of 6.2.0, replaced by getManageableSiteGroups(Collection, int)

Returns a range of all the site groups for which the user has control panel access.

Parameters:
portlets - the portlets to manage
max - the upper bound of the range of groups to consider (not inclusive)
Returns:
the range of site groups for which the user has Control Panel access
Throws:
PortalException - if a portal exception occurred
SystemException - if a system exception occurred

getOrganizationsGroups

public static List<Group> getOrganizationsGroups(List<Organization> organizations)
                                          throws PortalException,
                                                 SystemException
Returns the groups associated with the organizations.

Parameters:
organizations - the organizations
Returns:
the groups associated with the organizations
Throws:
PortalException - if a portal exception occurred
SystemException - if a system exception occurred

getUserGroup

public static Group getUserGroup(long companyId,
                                 long userId)
                          throws PortalException,
                                 SystemException
Returns the group associated with the user.

Parameters:
companyId - the primary key of the company
userId - the primary key of the user
Returns:
the group associated with the user
Throws:
PortalException - if a matching group could not be found or if the current user did not have permission to view the group
SystemException - if a system exception occurred

getUserGroupsGroups

public static List<Group> getUserGroupsGroups(List<UserGroup> userGroups)
                                       throws PortalException,
                                              SystemException
Returns the groups associated with the user groups.

Parameters:
userGroups - the user groups
Returns:
the groups associated with the user groups
Throws:
PortalException - if any one of the user group's group could not be found
SystemException - if a system exception occurred

getUserOrganizationsGroups

public static List<Group> getUserOrganizationsGroups(long userId,
                                                     int start,
                                                     int end)
                                              throws PortalException,
                                                     SystemException
Returns the range of all groups associated with the user's organization groups, including the ancestors of the organization groups, unless portal property organizations.membership.strict is set to true.

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 user
start - the lower bound of the range of groups to consider
end - the upper bound of the range of groups to consider (not inclusive)
Returns:
the range of groups associated with the user's organizations
Throws:
PortalException - if a user with the primary key could not be found or if another portal exception occurred
SystemException - if a system exception occurred

getUserPlaces

public static List<Group> getUserPlaces(long userId,
                                        String[] classNames,
                                        boolean includeControlPanel,
                                        int max)
                                 throws PortalException,
                                        SystemException
Deprecated. As of 6.2.0, replaced by getUserSitesGroups(long, String[], boolean, int)

Throws:
PortalException
SystemException

getUserPlaces

public static List<Group> getUserPlaces(long userId,
                                        String[] classNames,
                                        int max)
                                 throws PortalException,
                                        SystemException
Deprecated. As of 6.2.0, replaced by getUserSitesGroups(long, String[], int)

Returns the user's groups "sites" associated with the group entity class names, including the Control Panel group if the user is permitted to view the Control Panel.

Parameters:
userId - the primary key of the user
classNames - the group entity class names (optionally null). For more information see getUserSitesGroups(long, String[], int)
max - the maximum number of groups to return
Returns:
the user's groups "sites"
Throws:
PortalException - if a portal exception occurred
SystemException - if a system exception occurred

getUserPlaces

public static List<Group> getUserPlaces(String[] classNames,
                                        int max)
                                 throws PortalException,
                                        SystemException
Deprecated. As of 6.2.0, replaced by getUserSitesGroups( String[], int)

Returns the guest or current user's groups "sites" associated with the group entity class names, including the Control Panel group if the user is permitted to view the Control Panel.

Parameters:
classNames - the group entity class names (optionally null). For more information see getUserSitesGroups(String[], int)
max - the maximum number of groups to return
Returns:
the user's groups "sites"
Throws:
PortalException - if a portal exception occurred
SystemException - if a system exception occurred

getUserPlacesCount

public static int getUserPlacesCount()
                              throws PortalException,
                                     SystemException
Deprecated. As of 6.2.0, replaced by getUserSitesGroupsCount()

Returns the number of the guest or current user's groups "sites" associated with the group entity class names, including the Control Panel group if the user is permitted to view the Control Panel.

Returns:
the number of user's groups "sites"
Throws:
PortalException - if a portal exception occurred
SystemException - if a system exception occurred

getUserSites

public static List<Group> getUserSites()
                                throws PortalException,
                                       SystemException
Deprecated. As of 6.2.0, replaced by getUserSitesGroups()

Returns the guest or current user's layout set group, organization groups, inherited organization groups, and site groups.

Returns:
the user's layout set group, organization groups, and inherited organization groups, and site groups
Throws:
PortalException - if a portal exception occurred
SystemException - if a system exception occurred

getUserSitesGroups

public static List<Group> getUserSitesGroups()
                                      throws PortalException,
                                             SystemException
Throws:
PortalException
SystemException

getUserSitesGroups

public static List<Group> getUserSitesGroups(long userId,
                                             String[] classNames,
                                             boolean includeControlPanel,
                                             int max)
                                      throws PortalException,
                                             SystemException
Throws:
PortalException
SystemException

getUserSitesGroups

public static List<Group> getUserSitesGroups(long userId,
                                             String[] classNames,
                                             int max)
                                      throws PortalException,
                                             SystemException
Returns the user's groups "sites" associated with the group entity class names, including the Control Panel group if the user is permitted to view the Control Panel.

Parameters:
userId - the primary key of the user
classNames - the group entity class names (optionally null). For more information see getUserSitesGroups(long, String[], boolean, int)
max - the maximum number of groups to return
Returns:
the user's groups "sites"
Throws:
PortalException - if a portal exception occurred
SystemException - if a system exception occurred

getUserSitesGroups

public static List<Group> getUserSitesGroups(String[] classNames,
                                             int max)
                                      throws PortalException,
                                             SystemException
Returns the guest or current user's groups "sites" associated with the group entity class names, including the Control Panel group if the user is permitted to view the Control Panel.

Parameters:
classNames - the group entity class names (optionally null). For more information see getUserSitesGroups(long, String[], boolean, int)
max - the maximum number of groups to return
Returns:
the user's groups "sites"
Throws:
PortalException - if a portal exception occurred
SystemException - if a system exception occurred

getUserSitesGroupsCount

public static int getUserSitesGroupsCount()
                                   throws PortalException,
                                          SystemException
Returns the number of the guest or current user's groups "sites" associated with the group entity class names, including the Control Panel group if the user is permitted to view the Control Panel.

Returns:
the number of user's groups "sites"
Throws:
PortalException - if a portal exception occurred
SystemException - if a system exception occurred

hasUserGroup

public static boolean hasUserGroup(long userId,
                                   long groupId)
                            throws PortalException,
                                   SystemException
Returns true if the user is associated with the group, including the user's inherited organizations and user groups. System and staged groups are not included.

Parameters:
userId - the primary key of the user
groupId - the primary key of the group
Returns:
true if the user is associated with the group; false otherwise
Throws:
PortalException - if the current user did not have permission to view the user or group members
SystemException - if a system exception occurred

search

public static List<Group> search(long companyId,
                                 long[] classNameIds,
                                 String keywords,
                                 LinkedHashMap<String,Object> params,
                                 int start,
                                 int end,
                                 OrderByComparator obc)
                          throws PortalException,
                                 SystemException
Throws:
PortalException
SystemException

search

public static List<Group> search(long companyId,
                                 long[] classNameIds,
                                 String name,
                                 String description,
                                 LinkedHashMap<String,Object> params,
                                 boolean andOperator,
                                 int start,
                                 int end,
                                 OrderByComparator obc)
                          throws PortalException,
                                 SystemException
Throws:
PortalException
SystemException

search

public static List<Group> search(long companyId,
                                 String name,
                                 String description,
                                 String[] params,
                                 int start,
                                 int end)
                          throws PortalException,
                                 SystemException
Returns an ordered range of all the site groups and organization groups that match the name and description, optionally including the user's inherited organization groups and user groups. System and staged groups are not included.

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:
companyId - the primary key of the company
name - the group's name (optionally null)
description - the group's description (optionally null)
params - the finder params (optionally null). To include the user's inherited organizations and user groups in the search, add entries having "usersGroups" and "inherit" as keys mapped to the the user's ID. For more information see GroupFinder
start - the lower bound of the range of groups to return
end - the upper bound of the range of groups to return (not inclusive)
Returns:
the matching groups ordered by name
Throws:
PortalException - if a portal exception occurred
SystemException - if a system exception occurred

searchCount

public static int searchCount(long companyId,
                              String name,
                              String description,
                              String[] params)
                       throws SystemException
Returns the number of groups and organization groups that match the name and description, optionally including the user's inherited organizations and user groups. System and staged groups are not included.

Parameters:
companyId - the primary key of the company
name - the group's name (optionally null)
description - the group's description (optionally null)
params - the finder params (optionally null). To include the user's inherited organizations and user groups in the search, add entries having "usersGroups" and "inherit" as keys mapped to the the user's ID. For more information see GroupFinder
Returns:
the number of matching groups
Throws:
SystemException - if a system exception occurred

setRoleGroups

public static void setRoleGroups(long roleId,
                                 long[] groupIds)
                          throws PortalException,
                                 SystemException
Sets the groups associated with the role, removing and adding associations as necessary.

Parameters:
roleId - the primary key of the role
groupIds - the primary keys of the groups
Throws:
PortalException - if the user did not have permission to update update the role
SystemException - if a system exception occurred

unsetRoleGroups

public static void unsetRoleGroups(long roleId,
                                   long[] groupIds)
                            throws PortalException,
                                   SystemException
Removes the groups from the role.

Parameters:
roleId - the primary key of the role
groupIds - the primary keys of the groups
Throws:
PortalException - if the user did not have permission to update the role
SystemException - if a system exception occurred

updateFriendlyURL

public static Group updateFriendlyURL(long groupId,
                                      String friendlyURL)
                               throws PortalException,
                                      SystemException
Updates the group's friendly URL.

Parameters:
groupId - the primary key of the group
friendlyURL - the group's new friendlyURL (optionally null)
Returns:
the group
Throws:
PortalException - if the user did not have permission to update the group, if a group with the primary key could not be found, or if a valid friendly URL could not be created for the group
SystemException - if a system exception occurred

updateGroup

public static Group updateGroup(long groupId,
                                long parentGroupId,
                                String name,
                                String description,
                                int type,
                                boolean manualMembership,
                                int membershipRestriction,
                                String friendlyURL,
                                boolean active,
                                ServiceContext serviceContext)
                         throws PortalException,
                                SystemException
Updates the group.

Parameters:
groupId - the primary key of the group
parentGroupId - the primary key of the parent group
name - the group's new name
description - the group's new description (optionally null)
type - the group's new type. For more information see GroupConstants
friendlyURL - the group's new friendlyURL (optionally null)
active - whether the group is active
serviceContext - the service context to be applied (optionally null). Can set the asset category IDs and asset tag names for the group.
Returns:
the group
Throws:
PortalException - if the user did not have permission to update the group, if a group with the primary key could not be found, if the friendly URL was invalid or could one not be created
SystemException - if a system exception occurred

updateGroup

public static Group updateGroup(long groupId,
                                String typeSettings)
                         throws PortalException,
                                SystemException
Updates the group's type settings.

Parameters:
groupId - the primary key of the group
typeSettings - the group's new type settings (optionally null)
Returns:
the group
Throws:
PortalException - if the user did not have permission to update the group or if a group with the primary key could not be found
SystemException - if a system exception occurred

updateStagedPortlets

public static void updateStagedPortlets(long groupId,
                                        Map<String,String> stagedPortletIds)
                                 throws PortalException,
                                        SystemException
Throws:
PortalException
SystemException

getService

public static GroupService getService()

setService

public void setService(GroupService service)
Deprecated. As of 6.2.0


Liferay 6.2-ce-ga5