|
Liferay 7.0-ce-b4 | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectcom.liferay.portal.service.GroupServiceUtil
@ProviderType public class GroupServiceUtil
Provides the remote service utility for Group. This utility wraps
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.
GroupService,
GroupServiceBaseImpl,
GroupServiceImpl| Constructor Summary | |
|---|---|
GroupServiceUtil()
|
|
| Method Summary | |
|---|---|
static Group |
addGroup(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)
|
static Group |
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)
|
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)
Deprecated. As of 7.0.0, replaced by addGroup(long, long, Map,
Map, int, boolean, 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 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 groupKey)
Returns the group with the name. |
static String |
getGroupDisplayURL(long groupId,
boolean privateLayout,
boolean secureConnection)
Returns the group's display URL. |
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> |
getOrganizationsGroups(List<Organization> organizations)
Returns the groups associated with the organizations. |
static String |
getOSGiServiceIdentifier()
Returns the OSGi service identifier. |
static GroupService |
getService()
|
static Group |
getUserGroup(long companyId,
long userId)
Returns the group directly 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> |
getUserSitesGroups()
|
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<Group> obc)
|
static List<Group> |
search(long companyId,
long[] classNameIds,
String name,
String description,
LinkedHashMap<String,Object> params,
boolean andOperator,
int start,
int end,
OrderByComparator<Group> 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 |
setRoleGroups(long roleId,
long[] groupIds)
Sets the groups associated with the role, removing and adding associations as necessary. |
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,
Map<Locale,String> nameMap,
Map<Locale,String> descriptionMap,
int type,
boolean manualMembership,
int membershipRestriction,
String friendlyURL,
boolean inheritContent,
boolean active,
ServiceContext serviceContext)
|
static Group |
updateGroup(long groupId,
long parentGroupId,
String name,
String description,
int type,
boolean manualMembership,
int membershipRestriction,
String friendlyURL,
boolean inheritContent,
boolean active,
ServiceContext serviceContext)
Deprecated. As of 7.0.0, replaced by updateGroup(long, long, Map,
Map, int, boolean, int, String, boolean, boolean,
ServiceContext) |
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 |
|---|
public GroupServiceUtil()
| Method Detail |
|---|
@Deprecated
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
addGroup(long, long, Map,
Map, int, boolean, int, String, boolean, boolean,
ServiceContext)
parentGroupId - the primary key of the parent groupliveGroupId - the primary key of the live groupname - the entity's namedescription - the group's description (optionally
null)type - the group's type. For more information see GroupConstants.manualMembership - whether manual membership is allowed for the
groupmembershipRestriction - the group's membership restriction. For
more information see GroupConstants.friendlyURL - the group's friendlyURL (optionally
null)site - whether the group is to be associated with a main siteactive - whether the group is activeserviceContext - 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
PortalException - if a portal exception occurred
public static Group 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)
throws PortalException
PortalException
public static Group addGroup(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)
throws PortalException
PortalException
public static void addRoleGroups(long roleId,
long[] groupIds)
throws PortalException
roleId - the primary key of the rolegroupIds - the primary keys of the groups
PortalException - if a portal exception occurred
public static void checkRemoteStagingGroup(long groupId)
throws PortalException
groupId - the primary key of the group
PortalException - if a portal exception occurred
public static void deleteGroup(long groupId)
throws PortalException
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, and wikis are also deleted.
groupId - the primary key of the group
PortalException - if a portal exception occurred
public static void disableStaging(long groupId)
throws PortalException
PortalException
public static void enableStaging(long groupId)
throws PortalException
PortalException
public static Group getCompanyGroup(long companyId)
throws PortalException
companyId - the primary key of the company
PortalException - if a portal exception occurred
public static Group getGroup(long companyId,
String groupKey)
throws PortalException
companyId - the primary key of the companygroupKey - the group key
PortalException - if a portal exception occurred
public static Group getGroup(long groupId)
throws PortalException
groupId - the primary key of the group
PortalException - if a portal exception occurred
public static String getGroupDisplayURL(long groupId,
boolean privateLayout,
boolean secureConnection)
throws PortalException
groupId - the primary key of the groupprivateLayout - whether the layout set is private to the groupsecureConnection - whether the generated URL uses a secure
connection
PortalException - if a group with the primary key could not be
found or if a portal exception occurred
public static List<Group> getGroups(long companyId,
long parentGroupId,
boolean site)
throws PortalException
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
null if no matches were
found
PortalException - if a portal exception occurred
public static List<Group> getManageableSiteGroups(Collection<Portlet> portlets,
int max)
throws PortalException
portlets - the portlets to managemax - the upper bound of the range of groups to consider (not
inclusive)
PortalException - if a portal exception occurredpublic static String getOSGiServiceIdentifier()
public static List<Group> getOrganizationsGroups(List<Organization> organizations)
throws PortalException
organizations - the organizations
PortalException - if a portal exception occurred
public static Group getUserGroup(long companyId,
long userId)
throws PortalException
companyId - the primary key of the companyuserId - the primary key of the user
PortalException - if a portal exception occurred
public static List<Group> getUserGroupsGroups(List<UserGroup> userGroups)
throws PortalException
userGroups - the user groups
PortalException - if a portal exception occurred
public static List<Group> getUserOrganizationsGroups(long userId,
int start,
int end)
throws PortalException
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.
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)
PortalException - if a portal exception occurred
public static List<Group> getUserSitesGroups()
throws PortalException
PortalException
public static List<Group> getUserSitesGroups(String[] classNames,
int max)
throws PortalException
classNames
value of null includes the user's layout set group,
organization groups, inherited organization groups, and site groups.
classNames - the group entity class names (optionally
null). For more information see getUserSitesGroups(long, String[], int).max - the maximum number of groups to return
PortalException - if a portal exception occurred
public static List<Group> getUserSitesGroups(long userId,
String[] classNames,
int max)
throws PortalException
classNames
value of null includes the user's layout set group,
organization groups, inherited organization groups, and site groups.
userId - the primary key of the userclassNames - the group entity class names (optionally
null). For more information see getUserSitesGroups(long, String[], int).max - the maximum number of groups to return
PortalException - if a portal exception occurred
public static int getUserSitesGroupsCount()
throws PortalException
PortalException - if a portal exception occurred
public static boolean hasUserGroup(long userId,
long groupId)
throws PortalException
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.
userId - the primary key of the usergroupId - the primary key of the group
true if the user is associated with the group;
false otherwise
PortalException - if a portal exception occurred
public static List<Group> search(long companyId,
long[] classNameIds,
String keywords,
LinkedHashMap<String,Object> params,
int start,
int end,
OrderByComparator<Group> obc)
throws PortalException
PortalException
public static List<Group> search(long companyId,
long[] classNameIds,
String name,
String description,
LinkedHashMap<String,Object> params,
boolean andOperator,
int start,
int end,
OrderByComparator<Group> obc)
throws PortalException
PortalException
public static List<Group> search(long companyId,
String name,
String description,
String[] params,
int start,
int end)
throws PortalException
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.
companyId - the primary key of the companyname - 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 returnend - the upper bound of the range of groups to return (not
inclusive)
PortalException - if a portal exception occurred
public static int searchCount(long companyId,
String name,
String description,
String[] params)
companyId - the primary key of the companyname - 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.
public static void setRoleGroups(long roleId,
long[] groupIds)
throws PortalException
roleId - the primary key of the rolegroupIds - the primary keys of the groups
PortalException - if a portal exception occurred
public static void unsetRoleGroups(long roleId,
long[] groupIds)
throws PortalException
roleId - the primary key of the rolegroupIds - the primary keys of the groups
PortalException - if a portal exception occurred
public static Group updateFriendlyURL(long groupId,
String friendlyURL)
throws PortalException
groupId - the primary key of the groupfriendlyURL - the group's new friendlyURL (optionally
null)
PortalException - if a portal exception occurred
@Deprecated
public static Group updateGroup(long groupId,
long parentGroupId,
String name,
String description,
int type,
boolean manualMembership,
int membershipRestriction,
String friendlyURL,
boolean inheritContent,
boolean active,
ServiceContext serviceContext)
throws PortalException
updateGroup(long, long, Map,
Map, int, boolean, int, String, boolean, boolean,
ServiceContext)
groupId - the primary key of the groupparentGroupId - the primary key of the parent groupname - the group's namedescription - the group's new description (optionally
null)type - the group's new type. For more information see GroupConstants.manualMembership - whether manual membership is allowed for the
groupmembershipRestriction - the group's membership restriction. For
more information see GroupConstants.friendlyURL - the group's new friendlyURL (optionally
null)inheritContent - whether to inherit content from the parent
groupactive - whether the group is activeserviceContext - the service context to be applied (optionally
null). Can set the asset category IDs and asset
tag names for the group.
PortalException - if a portal exception occurred
public static Group 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)
throws PortalException
PortalException
public static Group updateGroup(long groupId,
String typeSettings)
throws PortalException
groupId - the primary key of the grouptypeSettings - the group's new type settings (optionally
null)
PortalException - if a portal exception occurred
public static void updateStagedPortlets(long groupId,
Map<String,String> stagedPortletIds)
throws PortalException
PortalExceptionpublic static GroupService getService()
|
Liferay 7.0-ce-b4 | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||