com.liferay.portal.service.http

Class GroupServiceSoap

java.lang.Object

com.liferay.portal.service.http.GroupServiceSoap

public class GroupServiceSoap
extends java.lang.Object

Provides the SOAP utility for the GroupServiceUtil service utility. The static methods of this class call 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 java.util.List, that is translated to an array of com.liferay.portal.kernel.model.GroupSoap. If the method in the service utility returns a com.liferay.portal.kernel.model.Group, that is translated to a com.liferay.portal.kernel.model.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.

Author:

Brian Wing Shun Chan

See Also:

GroupServiceHttp

Generated:

Constructor Summary

Constructors

Constructor and Description
GroupServiceSoap()

Method Summary

Modifier and Type	Method and Description
static com.liferay.portal.kernel.model.GroupSoap	addGroup(long parentGroupId, long liveGroupId, java.lang.String[] nameMapLanguageIds, java.lang.String[] nameMapValues, java.lang.String[] descriptionMapLanguageIds, java.lang.String[] descriptionMapValues, int type, boolean manualMembership, int membershipRestriction, java.lang.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, java.lang.String[] nameMapLanguageIds, java.lang.String[] nameMapValues, java.lang.String[] descriptionMapLanguageIds, java.lang.String[] descriptionMapValues, int type, boolean manualMembership, int membershipRestriction, java.lang.String friendlyURL, boolean site, boolean active, com.liferay.portal.kernel.service.ServiceContext 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, java.lang.String groupKey) Returns the group with the name.
static java.lang.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, java.lang.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, java.lang.String name, boolean site)
static int	getGroupsCount(long companyId, java.lang.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(java.util.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, int start, int end)
static com.liferay.portal.kernel.model.GroupSoap[]	getUserSitesGroups(long userId, java.lang.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(java.lang.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, java.lang.String name, java.lang.String description, java.lang.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, java.lang.String name, java.lang.String description, java.lang.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, java.lang.String friendlyURL) Updates the group's friendly URL.
static com.liferay.portal.kernel.model.GroupSoap	updateGroup(long groupId, long parentGroupId, java.lang.String[] nameMapLanguageIds, java.lang.String[] nameMapValues, java.lang.String[] descriptionMapLanguageIds, java.lang.String[] descriptionMapValues, int type, boolean manualMembership, int membershipRestriction, java.lang.String friendlyURL, boolean inheritContent, boolean active, com.liferay.portal.kernel.service.ServiceContext serviceContext)
static com.liferay.portal.kernel.model.GroupSoap	updateGroup(long groupId, java.lang.String typeSettings) Updates the group's type settings.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GroupServiceSoap

public GroupServiceSoap()

Method Detail

addGroup

public static com.liferay.portal.kernel.model.GroupSoap addGroup(long parentGroupId,
                                                                 long liveGroupId,
                                                                 java.lang.String[] nameMapLanguageIds,
                                                                 java.lang.String[] nameMapValues,
                                                                 java.lang.String[] descriptionMapLanguageIds,
                                                                 java.lang.String[] descriptionMapValues,
                                                                 int type,
                                                                 boolean manualMembership,
                                                                 int membershipRestriction,
                                                                 java.lang.String friendlyURL,
                                                                 boolean site,
                                                                 boolean inheritContent,
                                                                 boolean active,
                                                                 com.liferay.portal.kernel.service.ServiceContext serviceContext)
                                                          throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

addGroup

public static com.liferay.portal.kernel.model.GroupSoap addGroup(long parentGroupId,
                                                                 long liveGroupId,
                                                                 java.lang.String[] nameMapLanguageIds,
                                                                 java.lang.String[] nameMapValues,
                                                                 java.lang.String[] descriptionMapLanguageIds,
                                                                 java.lang.String[] descriptionMapValues,
                                                                 int type,
                                                                 boolean manualMembership,
                                                                 int membershipRestriction,
                                                                 java.lang.String friendlyURL,
                                                                 boolean site,
                                                                 boolean active,
                                                                 com.liferay.portal.kernel.service.ServiceContext serviceContext)
                                                          throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

addRoleGroups

public static void addRoleGroups(long roleId,
                                 long[] groupIds)
                          throws java.rmi.RemoteException

Adds the groups to the role.

Parameters:

roleId - the primary key of the role

groupIds - the primary keys of the groups

Throws:

PortalException - if a portal exception occurred

java.rmi.RemoteException

checkRemoteStagingGroup

public static void checkRemoteStagingGroup(long groupId)
                                    throws java.rmi.RemoteException

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 portal exception occurred

java.rmi.RemoteException

deleteGroup

public static void deleteGroup(long groupId)
                        throws java.rmi.RemoteException

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.

Parameters:

groupId - the primary key of the group

Throws:

PortalException - if a portal exception occurred

java.rmi.RemoteException

disableStaging

public static void disableStaging(long groupId)
                           throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

enableStaging

public static void enableStaging(long groupId)
                          throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

getCompanyGroup

public static com.liferay.portal.kernel.model.GroupSoap getCompanyGroup(long companyId)
                                                                 throws java.rmi.RemoteException

Returns the company group.

Parameters:

companyId - the primary key of the company

Returns:

the group associated with the company

Throws:

PortalException - if a portal exception occurred

java.rmi.RemoteException

getGroup

public static com.liferay.portal.kernel.model.GroupSoap getGroup(long groupId)
                                                          throws java.rmi.RemoteException

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 portal exception occurred

java.rmi.RemoteException

getGroup

public static com.liferay.portal.kernel.model.GroupSoap getGroup(long companyId,
                                                                 java.lang.String groupKey)
                                                          throws java.rmi.RemoteException

Returns the group with the name.

Parameters:

companyId - the primary key of the company

groupKey - the group key

Returns:

the group with the group key

Throws:

PortalException - if a portal exception occurred

java.rmi.RemoteException

getGroupDisplayURL

public static java.lang.String getGroupDisplayURL(long groupId,
                                                  boolean privateLayout,
                                                  boolean secureConnection)
                                           throws java.rmi.RemoteException

Returns the group's display URL.

Parameters:

groupId - the primary key of the group

privateLayout - whether the layout set is private to the group

secureConnection - 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 occurred

java.rmi.RemoteException

getGroups

public static com.liferay.portal.kernel.model.GroupSoap[] getGroups(long companyId,
                                                                    long parentGroupId,
                                                                    boolean site)
                                                             throws java.rmi.RemoteException

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 a portal exception occurred

java.rmi.RemoteException

getGroups

public static com.liferay.portal.kernel.model.GroupSoap[] getGroups(long companyId,
                                                                    long parentGroupId,
                                                                    boolean site,
                                                                    int start,
                                                                    int end)
                                                             throws java.rmi.RemoteException

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

start - the lower bound of the range of results

end - the upper bound of the range of results (not inclusive)

Returns:

the matching groups, or null if no matches were found

Throws:

PortalException - if a portal exception occurred

java.rmi.RemoteException

getGroups

public static com.liferay.portal.kernel.model.GroupSoap[] getGroups(long companyId,
                                                                    long parentGroupId,
                                                                    java.lang.String name,
                                                                    boolean site,
                                                                    int start,
                                                                    int end)
                                                             throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

getGroupsCount

public static int getGroupsCount(long companyId,
                                 long parentGroupId,
                                 boolean site)
                          throws java.rmi.RemoteException

Returns the number of 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 number of matching groups

Throws:

java.rmi.RemoteException

getGroupsCount

public static int getGroupsCount(long companyId,
                                 long parentGroupId,
                                 java.lang.String name,
                                 boolean site)
                          throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

getGroupsCount

public static int getGroupsCount(long companyId,
                                 java.lang.String className,
                                 long parentGroupId)
                          throws java.rmi.RemoteException

Returns the number of groups that are direct children of the parent group with the matching className.

Parameters:

companyId - the primary key of the company

className - the class name of the group

parentGroupId - the primary key of the parent group

Returns:

the number of matching groups

Throws:

java.rmi.RemoteException

getGtGroups

public static com.liferay.portal.kernel.model.GroupSoap[] getGtGroups(long gtGroupId,
                                                                      long companyId,
                                                                      long parentGroupId,
                                                                      boolean site,
                                                                      int size)
                                                               throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

getManageableSiteGroups

public static com.liferay.portal.kernel.model.GroupSoap[] getManageableSiteGroups(java.util.Collection<com.liferay.portal.kernel.model.Portlet> portlets,
                                                                                  int max)
                                                                           throws java.rmi.RemoteException

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

java.rmi.RemoteException

getOrganizationsGroups

public static com.liferay.portal.kernel.model.GroupSoap[] getOrganizationsGroups(com.liferay.portal.kernel.model.OrganizationSoap[] organizations)
                                                                          throws java.rmi.RemoteException

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

java.rmi.RemoteException

getUserGroup

public static com.liferay.portal.kernel.model.GroupSoap getUserGroup(long companyId,
                                                                     long userId)
                                                              throws java.rmi.RemoteException

Returns the group directly associated with the user.

Parameters:

companyId - the primary key of the company

userId - the primary key of the user

Returns:

the group directly associated with the user

Throws:

PortalException - if a portal exception occurred

java.rmi.RemoteException

getUserGroupsGroups

public static com.liferay.portal.kernel.model.GroupSoap[] getUserGroupsGroups(com.liferay.portal.kernel.model.UserGroupSoap[] userGroups)
                                                                       throws java.rmi.RemoteException

Returns the groups associated with the user groups.

Parameters:

userGroups - the user groups

Returns:

the groups associated with the user groups

Throws:

PortalException - if a portal exception occurred

java.rmi.RemoteException

getUserOrganizationsGroups

public static com.liferay.portal.kernel.model.GroupSoap[] getUserOrganizationsGroups(long userId,
                                                                                     int start,
                                                                                     int end)
                                                                              throws java.rmi.RemoteException

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 portal exception occurred

java.rmi.RemoteException

getUserSitesGroups

public static com.liferay.portal.kernel.model.GroupSoap[] getUserSitesGroups()
                                                                      throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

getUserSitesGroups

public static com.liferay.portal.kernel.model.GroupSoap[] getUserSitesGroups(long userId,
                                                                             int start,
                                                                             int end)
                                                                      throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

getUserSitesGroups

public static com.liferay.portal.kernel.model.GroupSoap[] getUserSitesGroups(long userId,
                                                                             java.lang.String[] classNames,
                                                                             int max)
                                                                      throws java.rmi.RemoteException

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 classNames value of null includes the user's layout set group, organization groups, inherited organization groups, and site groups.

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

java.rmi.RemoteException

getUserSitesGroups

public static com.liferay.portal.kernel.model.GroupSoap[] getUserSitesGroups(java.lang.String[] classNames,
                                                                             int max)
                                                                      throws java.rmi.RemoteException

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 classNames value of null includes the user's layout set group, organization groups, inherited organization groups, and site groups.

Parameters:

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

java.rmi.RemoteException

getUserSitesGroupsCount

public static int getUserSitesGroupsCount()
                                   throws java.rmi.RemoteException

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

java.rmi.RemoteException

hasUserGroup

public static boolean hasUserGroup(long userId,
                                   long groupId)
                            throws java.rmi.RemoteException

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 a portal exception occurred

java.rmi.RemoteException

search

public static com.liferay.portal.kernel.model.GroupSoap[] search(long companyId,
                                                                 java.lang.String name,
                                                                 java.lang.String description,
                                                                 java.lang.String[] params,
                                                                 int start,
                                                                 int end)
                                                          throws java.rmi.RemoteException

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

java.rmi.RemoteException

searchCount

public static int searchCount(long companyId,
                              java.lang.String name,
                              java.lang.String description,
                              java.lang.String[] params)
                       throws java.rmi.RemoteException

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:

java.rmi.RemoteException

setRoleGroups

public static void setRoleGroups(long roleId,
                                 long[] groupIds)
                          throws java.rmi.RemoteException

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 a portal exception occurred

java.rmi.RemoteException

unsetRoleGroups

public static void unsetRoleGroups(long roleId,
                                   long[] groupIds)
                            throws java.rmi.RemoteException

Removes the groups from the role.

Parameters:

roleId - the primary key of the role

groupIds - the primary keys of the groups

Throws:

PortalException - if a portal exception occurred

java.rmi.RemoteException

updateFriendlyURL

public static com.liferay.portal.kernel.model.GroupSoap updateFriendlyURL(long groupId,
                                                                          java.lang.String friendlyURL)
                                                                   throws java.rmi.RemoteException

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 a portal exception occurred

java.rmi.RemoteException

updateGroup

public static com.liferay.portal.kernel.model.GroupSoap updateGroup(long groupId,
                                                                    long parentGroupId,
                                                                    java.lang.String[] nameMapLanguageIds,
                                                                    java.lang.String[] nameMapValues,
                                                                    java.lang.String[] descriptionMapLanguageIds,
                                                                    java.lang.String[] descriptionMapValues,
                                                                    int type,
                                                                    boolean manualMembership,
                                                                    int membershipRestriction,
                                                                    java.lang.String friendlyURL,
                                                                    boolean inheritContent,
                                                                    boolean active,
                                                                    com.liferay.portal.kernel.service.ServiceContext serviceContext)
                                                             throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

updateGroup

public static com.liferay.portal.kernel.model.GroupSoap updateGroup(long groupId,
                                                                    java.lang.String typeSettings)
                                                             throws java.rmi.RemoteException

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 a portal exception occurred

java.rmi.RemoteException