@ProviderType
public class GroupServiceSoap
extends Object
GroupServiceUtil
service utility. The
static methods of this class calls the same methods of the service utility.
However, the signatures are different because it is difficult for SOAP to
support certain types.
ServiceBuilder follows certain rules in translating the methods. For example,
if the method in the service utility returns a List
, that
is translated to an array of GroupSoap
.
If the method in the service utility returns a
Group
, that is translated to a
GroupSoap
. Methods that SOAP cannot
safely wire are skipped.
The benefits of using the SOAP utility is that it is cross platform compatible. SOAP allows different languages like Java, .NET, C++, PHP, and even Perl, to call the generated services. One drawback of SOAP is that it is slow because it needs to serialize all calls into a text format (XML).
You can see a list of services at http://localhost:8080/api/axis. Set the property axis.servlet.hosts.allowed in portal.properties to configure security.
The SOAP utility is only generated for remote services.
GroupServiceHttp
,
GroupSoap
,
GroupServiceUtil
Constructor and Description |
---|
GroupServiceSoap() |
Modifier and Type | Method and Description |
---|---|
static com.liferay.portal.kernel.model.GroupSoap |
addGroup(long parentGroupId,
long liveGroupId,
String[] nameMapLanguageIds,
String[] nameMapValues,
String[] descriptionMapLanguageIds,
String[] descriptionMapValues,
int type,
boolean manualMembership,
int membershipRestriction,
String friendlyURL,
boolean site,
boolean inheritContent,
boolean active,
com.liferay.portal.kernel.service.ServiceContext serviceContext) |
static com.liferay.portal.kernel.model.GroupSoap |
addGroup(long parentGroupId,
long liveGroupId,
String[] nameMapLanguageIds,
String[] nameMapValues,
String[] descriptionMapLanguageIds,
String[] descriptionMapValues,
int type,
boolean manualMembership,
int membershipRestriction,
String friendlyURL,
boolean site,
boolean active,
com.liferay.portal.kernel.service.ServiceContext serviceContext) |
static com.liferay.portal.kernel.model.GroupSoap |
addGroup(long parentGroupId,
long liveGroupId,
String name,
String description,
int type,
boolean manualMembership,
int membershipRestriction,
String friendlyURL,
boolean site,
boolean active,
com.liferay.portal.kernel.service.ServiceContext serviceContext)
Deprecated.
As of Wilberforce (7.0.x), 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 com.liferay.portal.kernel.model.GroupSoap |
getCompanyGroup(long companyId)
Returns the company group.
|
static com.liferay.portal.kernel.model.GroupSoap |
getGroup(long groupId)
Returns the group with the primary key.
|
static com.liferay.portal.kernel.model.GroupSoap |
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 com.liferay.portal.kernel.model.GroupSoap[] |
getGroups(long companyId,
long parentGroupId,
boolean site)
Returns all the groups that are direct children of the parent group.
|
static com.liferay.portal.kernel.model.GroupSoap[] |
getGroups(long companyId,
long parentGroupId,
boolean site,
int start,
int end)
Returns all the groups that are direct children of the parent group.
|
static com.liferay.portal.kernel.model.GroupSoap[] |
getGroups(long companyId,
long parentGroupId,
String name,
boolean site,
int start,
int end) |
static int |
getGroupsCount(long companyId,
long parentGroupId,
boolean site)
Returns the number of groups that are direct children of the parent
group.
|
static int |
getGroupsCount(long companyId,
long parentGroupId,
String name,
boolean site) |
static int |
getGroupsCount(long companyId,
String className,
long parentGroupId)
Returns the number of groups that are direct children of the parent group
with the matching className.
|
static com.liferay.portal.kernel.model.GroupSoap[] |
getGtGroups(long gtGroupId,
long companyId,
long parentGroupId,
boolean site,
int size) |
static com.liferay.portal.kernel.model.GroupSoap[] |
getManageableSiteGroups(Collection<com.liferay.portal.kernel.model.Portlet> portlets,
int max)
Returns a range of all the site groups for which the user has control
panel access.
|
static com.liferay.portal.kernel.model.GroupSoap[] |
getOrganizationsGroups(com.liferay.portal.kernel.model.OrganizationSoap[] organizations)
Returns the groups associated with the organizations.
|
static com.liferay.portal.kernel.model.GroupSoap |
getUserGroup(long companyId,
long userId)
Returns the group directly associated with the user.
|
static com.liferay.portal.kernel.model.GroupSoap[] |
getUserGroupsGroups(com.liferay.portal.kernel.model.UserGroupSoap[] userGroups)
Returns the groups associated with the user groups.
|
static com.liferay.portal.kernel.model.GroupSoap[] |
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 com.liferay.portal.kernel.model.GroupSoap[] |
getUserSitesGroups() |
static com.liferay.portal.kernel.model.GroupSoap[] |
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 com.liferay.portal.kernel.model.GroupSoap[] |
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 com.liferay.portal.kernel.model.GroupSoap[] |
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 com.liferay.portal.kernel.model.GroupSoap |
updateFriendlyURL(long groupId,
String friendlyURL)
Updates the group's friendly URL.
|
static com.liferay.portal.kernel.model.GroupSoap |
updateGroup(long groupId,
long parentGroupId,
String[] nameMapLanguageIds,
String[] nameMapValues,
String[] descriptionMapLanguageIds,
String[] descriptionMapValues,
int type,
boolean manualMembership,
int membershipRestriction,
String friendlyURL,
boolean inheritContent,
boolean active,
com.liferay.portal.kernel.service.ServiceContext serviceContext) |
static com.liferay.portal.kernel.model.GroupSoap |
updateGroup(long groupId,
long parentGroupId,
String name,
String description,
int type,
boolean manualMembership,
int membershipRestriction,
String friendlyURL,
boolean inheritContent,
boolean active,
com.liferay.portal.kernel.service.ServiceContext serviceContext)
Deprecated.
As of Wilberforce (7.0.x), replaced by
#updateGroup(long, long, Map, Map, int, boolean, int, String,
boolean, boolean, ServiceContext) |
static com.liferay.portal.kernel.model.GroupSoap |
updateGroup(long groupId,
String typeSettings)
Updates the group's type settings.
|
public static com.liferay.portal.kernel.model.GroupSoap addGroup(long parentGroupId, long liveGroupId, String[] nameMapLanguageIds, String[] nameMapValues, String[] descriptionMapLanguageIds, String[] descriptionMapValues, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean site, boolean inheritContent, boolean active, com.liferay.portal.kernel.service.ServiceContext serviceContext) throws RemoteException
RemoteException
public static com.liferay.portal.kernel.model.GroupSoap addGroup(long parentGroupId, long liveGroupId, String[] nameMapLanguageIds, String[] nameMapValues, String[] descriptionMapLanguageIds, String[] descriptionMapValues, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean site, boolean active, com.liferay.portal.kernel.service.ServiceContext serviceContext) throws RemoteException
RemoteException
@Deprecated public static com.liferay.portal.kernel.model.GroupSoap addGroup(long parentGroupId, long liveGroupId, String name, String description, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean site, boolean active, com.liferay.portal.kernel.service.ServiceContext serviceContext) throws RemoteException
#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
stagingPortalException
- if a portal exception occurredRemoteException
public static void addRoleGroups(long roleId, long[] groupIds) throws RemoteException
roleId
- the primary key of the rolegroupIds
- the primary keys of the groupsPortalException
- if a portal exception occurredRemoteException
public static void checkRemoteStagingGroup(long groupId) throws RemoteException
groupId
- the primary key of the groupPortalException
- if a portal exception occurredRemoteException
public static void deleteGroup(long groupId) throws RemoteException
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 groupPortalException
- if a portal exception occurredRemoteException
public static void disableStaging(long groupId) throws RemoteException
RemoteException
public static void enableStaging(long groupId) throws RemoteException
RemoteException
public static com.liferay.portal.kernel.model.GroupSoap getCompanyGroup(long companyId) throws RemoteException
companyId
- the primary key of the companyPortalException
- if a portal exception occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap getGroup(long groupId) throws RemoteException
groupId
- the primary key of the groupPortalException
- if a portal exception occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap getGroup(long companyId, String groupKey) throws RemoteException
companyId
- the primary key of the companygroupKey
- the group keyPortalException
- if a portal exception occurredRemoteException
public static String getGroupDisplayURL(long groupId, boolean privateLayout, boolean secureConnection) throws RemoteException
groupId
- the primary key of the groupprivateLayout
- whether the layout set is private to the groupsecureConnection
- whether the generated URL uses a secure
connectionPortalException
- if a group with the primary key could not be
found or if a portal exception occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap[] getGroups(long companyId, long parentGroupId, boolean site) throws RemoteException
companyId
- the primary key of the companyparentGroupId
- the primary key of the parent groupsite
- whether the group is to be associated with a main sitenull
if no matches were
foundPortalException
- if a portal exception occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap[] getGroups(long companyId, long parentGroupId, boolean site, int start, int end) throws RemoteException
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)null
if no matches were
foundPortalException
- if a portal exception occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap[] getGroups(long companyId, long parentGroupId, String name, boolean site, int start, int end) throws RemoteException
RemoteException
public static int getGroupsCount(long companyId, long parentGroupId, boolean site) throws RemoteException
companyId
- the primary key of the companyparentGroupId
- the primary key of the parent groupsite
- whether the group is to be associated with a main siteRemoteException
public static int getGroupsCount(long companyId, long parentGroupId, String name, boolean site) throws RemoteException
RemoteException
public static int getGroupsCount(long companyId, String className, long parentGroupId) throws RemoteException
companyId
- the primary key of the companyclassName
- the class name of the groupparentGroupId
- the primary key of the parent groupRemoteException
public static com.liferay.portal.kernel.model.GroupSoap[] getGtGroups(long gtGroupId, long companyId, long parentGroupId, boolean site, int size) throws RemoteException
RemoteException
public static com.liferay.portal.kernel.model.GroupSoap[] getManageableSiteGroups(Collection<com.liferay.portal.kernel.model.Portlet> portlets, int max) throws RemoteException
portlets
- the portlets to managemax
- the upper bound of the range of groups to consider (not
inclusive)PortalException
- if a portal exception occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap[] getOrganizationsGroups(com.liferay.portal.kernel.model.OrganizationSoap[] organizations) throws RemoteException
organizations
- the organizationsPortalException
- if a portal exception occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap getUserGroup(long companyId, long userId) throws RemoteException
companyId
- the primary key of the companyuserId
- the primary key of the userPortalException
- if a portal exception occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap[] getUserGroupsGroups(com.liferay.portal.kernel.model.UserGroupSoap[] userGroups) throws RemoteException
userGroups
- the user groupsPortalException
- if a portal exception occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap[] getUserOrganizationsGroups(long userId, int start, int end) throws RemoteException
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 occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap[] getUserSitesGroups() throws RemoteException
RemoteException
public static com.liferay.portal.kernel.model.GroupSoap[] getUserSitesGroups(long userId, String[] classNames, int max) throws RemoteException
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 returnPortalException
- if a portal exception occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap[] getUserSitesGroups(String[] classNames, int max) throws RemoteException
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 returnPortalException
- if a portal exception occurredRemoteException
public static int getUserSitesGroupsCount() throws RemoteException
PortalException
- if a portal exception occurredRemoteException
public static boolean hasUserGroup(long userId, long groupId) throws RemoteException
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 grouptrue
if the user is associated with the group;
false
otherwisePortalException
- if a portal exception occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap[] search(long companyId, String name, String description, String[] params, int start, int end) throws RemoteException
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 occurredRemoteException
public static int searchCount(long companyId, String name, String description, String[] params) throws RemoteException
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
.RemoteException
public static void setRoleGroups(long roleId, long[] groupIds) throws RemoteException
roleId
- the primary key of the rolegroupIds
- the primary keys of the groupsPortalException
- if a portal exception occurredRemoteException
public static void unsetRoleGroups(long roleId, long[] groupIds) throws RemoteException
roleId
- the primary key of the rolegroupIds
- the primary keys of the groupsPortalException
- if a portal exception occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap updateFriendlyURL(long groupId, String friendlyURL) throws RemoteException
groupId
- the primary key of the groupfriendlyURL
- the group's new friendlyURL (optionally
null
)PortalException
- if a portal exception occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap updateGroup(long groupId, long parentGroupId, String[] nameMapLanguageIds, String[] nameMapValues, String[] descriptionMapLanguageIds, String[] descriptionMapValues, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean inheritContent, boolean active, com.liferay.portal.kernel.service.ServiceContext serviceContext) throws RemoteException
RemoteException
@Deprecated public static com.liferay.portal.kernel.model.GroupSoap updateGroup(long groupId, long parentGroupId, String name, String description, int type, boolean manualMembership, int membershipRestriction, String friendlyURL, boolean inheritContent, boolean active, com.liferay.portal.kernel.service.ServiceContext serviceContext) throws RemoteException
#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 occurredRemoteException
public static com.liferay.portal.kernel.model.GroupSoap updateGroup(long groupId, String typeSettings) throws RemoteException
groupId
- the primary key of the grouptypeSettings
- the group's new type settings (optionally
null
)PortalException
- if a portal exception occurredRemoteException