Class GroupServiceWrapper
- All Implemented Interfaces:
BaseService,GroupService,ServiceWrapper<GroupService>
GroupService.- Author:
- Brian Wing Shun Chan
- See Also:
- {$generated.description}
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionaddGroup(long parentGroupId, long liveGroupId, Map<Locale, String> nameMap, Map<Locale, String> descriptionMap, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean site, boolean inheritContent, boolean active, ServiceContext serviceContext) addGroup(long parentGroupId, long liveGroupId, Map<Locale, String> nameMap, Map<Locale, String> descriptionMap, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean site, boolean active, ServiceContext serviceContext) addOrUpdateGroup(String externalReferenceCode, long parentGroupId, long liveGroupId, Map<Locale, String> nameMap, Map<Locale, String> descriptionMap, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean site, boolean inheritContent, boolean active, ServiceContext serviceContext) voidaddRoleGroups(long roleId, long[] groupIds) Adds the groups to the role.voidcheckRemoteStagingGroup(long groupId) Checks that the current user is permitted to use the group for Remote Staging.voiddeleteGroup(long groupId) Deletes the group.voiddisableStaging(long groupId) voidenableStaging(long groupId) fetchGroupByExternalReferenceCode(String externalReferenceCode, long companyId) getCompanyGroup(long companyId) Returns the company group.getGroup(long groupId) Returns the group with the primary key.Returns the group with the name.getGroupDisplayURL(long groupId, boolean privateLayout, boolean secureConnection) Returns the group's display URL.getGroups(long companyId, long parentGroupId, boolean site) Returns all the groups that are direct children of the parent group.getGroups(long companyId, long parentGroupId, boolean site, int start, int end) Returns all the groups that are direct children of the parent group.intgetGroupsCount(long companyId, long parentGroupId, boolean site) Returns the number of groups that are direct children of the parent group.intgetGroupsCount(long companyId, long parentGroupId, String name, boolean site) intgetGroupsCount(long companyId, String className, long parentGroupId) Returns the number of groups that are direct children of the parent group with the matching className.getGtGroups(long gtGroupId, long companyId, long parentGroupId, boolean site, int size) getManageableSiteGroups(Collection<Portlet> portlets, int max) Returns a range of all the site groups for which the user has control panel access.getOrganizationsGroups(List<Organization> organizations) Returns the groups associated with the organizations.Returns the OSGi service identifier.getUserGroup(long companyId, long userId) Returns the group directly associated with the user.getUserGroupsGroups(List<UserGroup> userGroups) Returns the groups associated with the user groups.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 propertyorganizations.membership.strictis set totrue.getUserSitesGroups(long userId, int start, int end) 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.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.intReturns 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.booleanhasUserGroup(long userId, long groupId) Returnstrueif the user is associated with the group, including the user's inherited organizations and user groups.search(long companyId, long[] classNameIds, String name, String description, LinkedHashMap<String, Object> params, boolean andOperator, int start, int end, OrderByComparator<Group> orderByComparator) search(long companyId, long[] classNameIds, String keywords, LinkedHashMap<String, Object> params, int start, int end, OrderByComparator<Group> orderByComparator) 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.intsearchCount(long companyId, long[] classNameIds, String keywords, LinkedHashMap<String, Object> params) intsearchCount(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.voidsetRoleGroups(long roleId, long[] groupIds) Sets the groups associated with the role, removing and adding associations as necessary.voidsetWrappedService(GroupService groupService) voidunsetRoleGroups(long roleId, long[] groupIds) Removes the groups from the role.updateFriendlyURL(long groupId, String friendlyURL) Updates the group's friendly URL.updateGroup(long groupId, long parentGroupId, Map<Locale, String> nameMap, Map<Locale, String> descriptionMap, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean inheritContent, boolean active, ServiceContext serviceContext) updateGroup(long groupId, String typeSettings) Updates the group's type settings.voidupdateStagedPortlets(long groupId, Map<String, String> stagedPortletIds)
-
Constructor Details
-
GroupServiceWrapper
public GroupServiceWrapper() -
GroupServiceWrapper
-
-
Method Details
-
addGroup
public Group addGroup(long parentGroupId, long liveGroupId, Map<Locale, String> nameMap, Map<Locale, throws PortalExceptionString> descriptionMap, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean site, boolean inheritContent, boolean active, ServiceContext serviceContext) - Specified by:
addGroupin interfaceGroupService- Throws:
PortalException
-
addGroup
public Group addGroup(long parentGroupId, long liveGroupId, Map<Locale, String> nameMap, Map<Locale, throws PortalExceptionString> descriptionMap, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean site, boolean active, ServiceContext serviceContext) - Specified by:
addGroupin interfaceGroupService- Throws:
PortalException
-
addOrUpdateGroup
public Group addOrUpdateGroup(String externalReferenceCode, long parentGroupId, long liveGroupId, Map<Locale, String> nameMap, Map<Locale, throws ExceptionString> descriptionMap, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean site, boolean inheritContent, boolean active, ServiceContext serviceContext) - Specified by:
addOrUpdateGroupin interfaceGroupService- Throws:
Exception
-
addRoleGroups
Adds the groups to the role.- Specified by:
addRoleGroupsin interfaceGroupService- Parameters:
roleId- the primary key of the rolegroupIds- the primary keys of the groups- Throws:
PortalException- if a portal exception occurredPortalException
-
checkRemoteStagingGroup
Checks that the current user is permitted to use the group for Remote Staging.- Specified by:
checkRemoteStagingGroupin interfaceGroupService- Parameters:
groupId- the primary key of the group- Throws:
PortalException- if a portal exception occurredPortalException
-
deleteGroup
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, and wikis are also deleted.
- Specified by:
deleteGroupin interfaceGroupService- Parameters:
groupId- the primary key of the group- Throws:
PortalException- if a portal exception occurredPortalException
-
disableStaging
- Specified by:
disableStagingin interfaceGroupService- Throws:
PortalException
-
enableStaging
- Specified by:
enableStagingin interfaceGroupService- Throws:
PortalException
-
fetchGroupByExternalReferenceCode
public Group fetchGroupByExternalReferenceCode(String externalReferenceCode, long companyId) throws PortalException - Specified by:
fetchGroupByExternalReferenceCodein interfaceGroupService- Throws:
PortalException
-
getCompanyGroup
Returns the company group.- Specified by:
getCompanyGroupin interfaceGroupService- Parameters:
companyId- the primary key of the company- Returns:
- the group associated with the company
- Throws:
PortalException- if a portal exception occurredPortalException
-
getGroup
Returns the group with the primary key.- Specified by:
getGroupin interfaceGroupService- Parameters:
groupId- the primary key of the group- Returns:
- the group with the primary key
- Throws:
PortalException- if a portal exception occurredPortalException
-
getGroup
Returns the group with the name.- Specified by:
getGroupin interfaceGroupService- Parameters:
companyId- the primary key of the companygroupKey- the group key- Returns:
- the group with the group key
- Throws:
PortalException- if a portal exception occurredPortalException
-
getGroupDisplayURL
public String getGroupDisplayURL(long groupId, boolean privateLayout, boolean secureConnection) throws PortalException Returns the group's display URL.- Specified by:
getGroupDisplayURLin interfaceGroupService- Parameters:
groupId- the primary key of the groupprivateLayout- whether the layout set is private to the groupsecureConnection- whether the generated URL uses a secure connection- Returns:
- the group's display URL
- Throws:
PortalException- if a group with the primary key could not be found or if a portal exception occurredPortalException
-
getGroups
public List<Group> getGroups(long companyId, long parentGroupId, boolean site) throws PortalException Returns all the groups that are direct children of the parent group.- Specified by:
getGroupsin interfaceGroupService- Parameters:
companyId- the primary key of the companyparentGroupId- the primary key of the parent groupsite- whether the group is to be associated with a main site- Returns:
- the matching groups, or
nullif no matches were found - Throws:
PortalException- if a portal exception occurredPortalException
-
getGroups
public List<Group> getGroups(long companyId, long parentGroupId, boolean site, int start, int end) throws PortalException Returns all the groups that are direct children of the parent group.- Specified by:
getGroupsin interfaceGroupService- Parameters:
companyId- the primary key of the companyparentGroupId- the primary key of the parent groupsite- whether the group is to be associated with a main sitestart- the lower bound of the range of resultsend- the upper bound of the range of results (not inclusive)- Returns:
- the matching groups, or
nullif no matches were found - Throws:
PortalException- if a portal exception occurredPortalException
-
getGroups
public List<Group> getGroups(long companyId, long parentGroupId, String name, boolean site, int start, int end) throws PortalException - Specified by:
getGroupsin interfaceGroupService- Throws:
PortalException
-
getGroupsCount
Returns the number of groups that are direct children of the parent group.- Specified by:
getGroupsCountin interfaceGroupService- Parameters:
companyId- the primary key of the companyparentGroupId- the primary key of the parent groupsite- whether the group is to be associated with a main site- Returns:
- the number of matching groups
- Throws:
PortalException
-
getGroupsCount
public int getGroupsCount(long companyId, long parentGroupId, String name, boolean site) throws PortalException - Specified by:
getGroupsCountin interfaceGroupService- Throws:
PortalException
-
getGroupsCount
public int getGroupsCount(long companyId, String className, long parentGroupId) throws PortalException Returns the number of groups that are direct children of the parent group with the matching className.- Specified by:
getGroupsCountin interfaceGroupService- Parameters:
companyId- the primary key of the companyclassName- the class name of the groupparentGroupId- the primary key of the parent group- Returns:
- the number of matching groups
- Throws:
PortalException
-
getGtGroups
public List<Group> getGtGroups(long gtGroupId, long companyId, long parentGroupId, boolean site, int size) throws PortalException - Specified by:
getGtGroupsin interfaceGroupService- Throws:
PortalException
-
getManageableSiteGroups
public List<Group> getManageableSiteGroups(Collection<Portlet> portlets, int max) throws PortalException Returns a range of all the site groups for which the user has control panel access.- Specified by:
getManageableSiteGroupsin interfaceGroupService- Parameters:
portlets- the portlets to managemax- 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 occurredPortalException
-
getOrganizationsGroups
Returns the groups associated with the organizations.- Specified by:
getOrganizationsGroupsin interfaceGroupService- Parameters:
organizations- the organizations- Returns:
- the groups associated with the organizations
- Throws:
PortalException- if a portal exception occurredPortalException
-
getOSGiServiceIdentifier
Returns the OSGi service identifier.- Specified by:
getOSGiServiceIdentifierin interfaceGroupService- Returns:
- the OSGi service identifier
-
getUserGroup
Returns the group directly associated with the user.- Specified by:
getUserGroupin interfaceGroupService- Parameters:
companyId- the primary key of the companyuserId- the primary key of the user- Returns:
- the group directly associated with the user
- Throws:
PortalException- if a portal exception occurredPortalException
-
getUserGroupsGroups
Returns the groups associated with the user groups.- Specified by:
getUserGroupsGroupsin interfaceGroupService- Parameters:
userGroups- the user groups- Returns:
- the groups associated with the user groups
- Throws:
PortalException- if a portal exception occurredPortalException
-
getUserOrganizationsGroups
public List<Group> getUserOrganizationsGroups(long userId, int start, int end) throws PortalException Returns the range of all groups associated with the user's organization groups, including the ancestors of the organization groups, unless portal propertyorganizations.membership.strictis set totrue.Useful when paginating results. Returns a maximum of
end - startinstances.startandendare not primary keys, they are indexes in the result set. Thus,0refers to the first result in the set. Setting bothstartandendtoQueryUtil#ALL_POSwill return the full result set.- Specified by:
getUserOrganizationsGroupsin interfaceGroupService- Parameters:
userId- the primary key of the userstart- the lower bound of the range of groups to considerend- 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 portal exception occurredPortalException
-
getUserSitesGroups
- Specified by:
getUserSitesGroupsin interfaceGroupService- Throws:
PortalException
-
getUserSitesGroups
- Specified by:
getUserSitesGroupsin interfaceGroupService- Throws:
PortalException
-
getUserSitesGroups
public List<Group> getUserSitesGroups(long userId, String[] classNames, int max) throws PortalException 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.- Class name "User" includes the user's layout set group.
- Class name "Organization" includes the user's immediate organization groups and inherited organization groups.
- Class name "Group" includes the user's immediate organization groups and site groups.
-
A
classNamesvalue ofnullincludes the user's layout set group, organization groups, inherited organization groups, and site groups.
- Specified by:
getUserSitesGroupsin interfaceGroupService- Parameters:
userId- the primary key of the userclassNames- the group entity class names (optionallynull). For more information seegetUserSitesGroups(long, String[], int).max- the maximum number of groups to return- Returns:
- the user's groups "sites"
- Throws:
PortalException- if a portal exception occurredPortalException
-
getUserSitesGroups
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.- Class name "User" includes the user's layout set group.
- Class name "Organization" includes the user's immediate organization groups and inherited organization groups.
- Class name "Group" includes the user's immediate organization groups and site groups.
-
A
classNamesvalue ofnullincludes the user's layout set group, organization groups, inherited organization groups, and site groups.
- Specified by:
getUserSitesGroupsin interfaceGroupService- Parameters:
classNames- the group entity class names (optionallynull). For more information seegetUserSitesGroups(long, String[], int).max- the maximum number of groups to return- Returns:
- the user's groups "sites"
- Throws:
PortalException- if a portal exception occurredPortalException
-
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.- Specified by:
getUserSitesGroupsCountin interfaceGroupService- Returns:
- the number of user's groups "sites"
- Throws:
PortalException- if a portal exception occurredPortalException
-
hasUserGroup
Returnstrueif the user is associated with the group, including the user's inherited organizations and user groups. System and staged groups are not included.- Specified by:
hasUserGroupin interfaceGroupService- Parameters:
userId- the primary key of the usergroupId- the primary key of the group- Returns:
trueif the user is associated with the group;falseotherwise- Throws:
PortalException- if a portal exception occurredPortalException
-
search
public List<Group> search(long companyId, long[] classNameIds, String keywords, LinkedHashMap<String, Object> params, int start, int end, OrderByComparator<Group> orderByComparator) throws PortalException- Specified by:
searchin interfaceGroupService- Throws:
PortalException
-
search
public List<Group> search(long companyId, long[] classNameIds, String name, String description, LinkedHashMap<String, Object> params, boolean andOperator, int start, int end, OrderByComparator<Group> orderByComparator) throws PortalException- Specified by:
searchin interfaceGroupService- Throws:
PortalException
-
search
public List<Group> search(long companyId, String name, String description, String[] params, int start, int end) throws PortalException 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 - startinstances.startandendare not primary keys, they are indexes in the result set. Thus,0refers to the first result in the set. Setting bothstartandendtoQueryUtil#ALL_POSwill return the full result set.- Specified by:
searchin interfaceGroupService- Parameters:
companyId- the primary key of the companyname- the group's name (optionallynull)description- the group's description (optionallynull)params- the finder params (optionallynull). 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 seeGroupFinder.start- the lower bound of the range of groups to returnend- 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 occurredPortalException
-
searchCount
public int searchCount(long companyId, long[] classNameIds, String keywords, LinkedHashMap<String, Object> params) - Specified by:
searchCountin interfaceGroupService
-
searchCount
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.- Specified by:
searchCountin interfaceGroupService- Parameters:
companyId- the primary key of the companyname- the group's name (optionallynull)description- the group's description (optionallynull)params- the finder params (optionallynull). 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 seeGroupFinder.- Returns:
- the number of matching groups
-
setRoleGroups
Sets the groups associated with the role, removing and adding associations as necessary.- Specified by:
setRoleGroupsin interfaceGroupService- Parameters:
roleId- the primary key of the rolegroupIds- the primary keys of the groups- Throws:
PortalException- if a portal exception occurredPortalException
-
unsetRoleGroups
Removes the groups from the role.- Specified by:
unsetRoleGroupsin interfaceGroupService- Parameters:
roleId- the primary key of the rolegroupIds- the primary keys of the groups- Throws:
PortalException- if a portal exception occurredPortalException
-
updateFriendlyURL
Updates the group's friendly URL.- Specified by:
updateFriendlyURLin interfaceGroupService- Parameters:
groupId- the primary key of the groupfriendlyURL- the group's new friendlyURL (optionallynull)- Returns:
- the group
- Throws:
PortalException- if a portal exception occurredPortalException
-
updateGroup
public Group updateGroup(long groupId, long parentGroupId, Map<Locale, String> nameMap, Map<Locale, throws PortalExceptionString> descriptionMap, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean inheritContent, boolean active, ServiceContext serviceContext) - Specified by:
updateGroupin interfaceGroupService- Throws:
PortalException
-
updateGroup
Updates the group's type settings.- Specified by:
updateGroupin interfaceGroupService- Parameters:
groupId- the primary key of the grouptypeSettings- the group's new type settings (optionallynull)- Returns:
- the group
- Throws:
PortalException- if a portal exception occurredPortalException
-
updateStagedPortlets
public void updateStagedPortlets(long groupId, Map<String, String> stagedPortletIds) throws PortalException- Specified by:
updateStagedPortletsin interfaceGroupService- Throws:
PortalException
-
getWrappedService
- Specified by:
getWrappedServicein interfaceServiceWrapper<GroupService>
-
setWrappedService
- Specified by:
setWrappedServicein interfaceServiceWrapper<GroupService>
-