com.liferay.portal.service.impl

Class RoleServiceImpl

java.lang.Object

com.liferay.portal.service.BaseServiceImpl

com.liferay.portal.service.base.RoleServiceBaseImpl

com.liferay.portal.service.impl.RoleServiceImpl

All Implemented Interfaces:

com.liferay.portal.kernel.bean.IdentifiableBean, com.liferay.portal.service.BaseService, com.liferay.portal.service.RoleService

public class RoleServiceImpl
extends RoleServiceBaseImpl

Provides the remote service for accessing, adding, unassigning, checking, deleting, and updating roles. Its methods include permission checks.

Author:

Brian Wing Shun Chan

Field Summary

Fields inherited from class com.liferay.portal.service.base.RoleServiceBaseImpl

accountLocalService, accountPersistence, accountService, addressLocalService, addressPersistence, addressService, backgroundTaskLocalService, backgroundTaskPersistence, backgroundTaskService, browserTrackerLocalService, browserTrackerPersistence, classNameLocalService, classNamePersistence, classNameService, clusterGroupLocalService, clusterGroupPersistence, cmisRepositoryLocalService, companyLocalService, companyPersistence, companyService, contactLocalService, contactPersistence, contactService, counterLocalService, countryPersistence, countryService, emailAddressLocalService, emailAddressPersistence, emailAddressService, expandoRowLocalService, expandoRowPersistence, groupFinder, groupLocalService, groupPersistence, groupService, imageLocalService, imagePersistence, imageService, layoutBranchLocalService, layoutBranchPersistence, layoutBranchService, layoutFinder, layoutFriendlyURLLocalService, layoutFriendlyURLPersistence, layoutLocalService, layoutPersistence, layoutPrototypeLocalService, layoutPrototypePersistence, layoutPrototypeService, layoutRevisionLocalService, layoutRevisionPersistence, layoutRevisionService, layoutService, layoutSetBranchLocalService, layoutSetBranchPersistence, layoutSetBranchService, layoutSetLocalService, layoutSetPersistence, layoutSetPrototypeLocalService, layoutSetPrototypePersistence, layoutSetPrototypeService, layoutSetService, layoutTemplateLocalService, listTypePersistence, listTypeService, lockFinder, lockLocalService, lockPersistence, membershipRequestLocalService, membershipRequestPersistence, membershipRequestService, organizationFinder, organizationLocalService, organizationPersistence, organizationService, orgGroupRolePersistence, orgLaborLocalService, orgLaborPersistence, orgLaborService, passwordPolicyFinder, passwordPolicyLocalService, passwordPolicyPersistence, passwordPolicyRelLocalService, passwordPolicyRelPersistence, passwordPolicyService, passwordTrackerLocalService, passwordTrackerPersistence, permissionService, phoneLocalService, phonePersistence, phoneService, pluginSettingLocalService, pluginSettingPersistence, pluginSettingService, portalLocalService, portalPreferencesLocalService, portalPreferencesPersistence, portalService, portletItemLocalService, portletItemPersistence, portletLocalService, portletPersistence, portletPreferencesFinder, portletPreferencesLocalService, portletPreferencesPersistence, portletPreferencesService, portletService, quartzLocalService, regionPersistence, regionService, releaseLocalService, releasePersistence, repositoryEntryLocalService, repositoryEntryPersistence, repositoryLocalService, repositoryPersistence, repositoryService, resourceActionLocalService, resourceActionPersistence, resourceBlockFinder, resourceBlockLocalService, resourceBlockPermissionLocalService, resourceBlockPermissionPersistence, resourceBlockPersistence, resourceBlockService, resourceLocalService, resourcePermissionFinder, resourcePermissionLocalService, resourcePermissionPersistence, resourcePermissionService, resourceTypePermissionFinder, resourceTypePermissionLocalService, resourceTypePermissionPersistence, roleFinder, roleLocalService, rolePersistence, roleService, serviceComponentLocalService, serviceComponentPersistence, shardLocalService, shardPersistence, stagingLocalService, stagingService, subscriptionLocalService, subscriptionPersistence, systemEventLocalService, systemEventPersistence, teamFinder, teamLocalService, teamPersistence, teamService, themeLocalService, themeService, ticketLocalService, ticketPersistence, userFinder, userGroupFinder, userGroupGroupRoleLocalService, userGroupGroupRolePersistence, userGroupGroupRoleService, userGroupLocalService, userGroupPersistence, userGroupRoleFinder, userGroupRoleLocalService, userGroupRolePersistence, userGroupRoleService, userGroupService, userIdMapperLocalService, userIdMapperPersistence, userLocalService, userNotificationDeliveryLocalService, userNotificationDeliveryPersistence, userNotificationEventLocalService, userNotificationEventPersistence, userPersistence, userService, userTrackerLocalService, userTrackerPathLocalService, userTrackerPathPersistence, userTrackerPersistence, virtualHostLocalService, virtualHostPersistence, webDAVPropsLocalService, webDAVPropsPersistence, websiteLocalService, websitePersistence, websiteService, workflowDefinitionLinkLocalService, workflowDefinitionLinkPersistence, workflowInstanceLinkLocalService, workflowInstanceLinkPersistence

Fields inherited from class com.liferay.portal.service.BaseServiceImpl

ANONYMOUS_NAMES, JRUN_ANONYMOUS, ORACLE_ANONYMOUS, SUN_ANONYMOUS, WEBLOGIC_ANONYMOUS

Constructor Summary

Constructors

Constructor and Description
RoleServiceImpl()

Method Summary

Methods

Modifier and Type	Method and Description
com.liferay.portal.model.Role	addRole(java.lang.String className, long classPK, java.lang.String name, java.util.Map<java.util.Locale,java.lang.String> titleMap, java.util.Map<java.util.Locale,java.lang.String> descriptionMap, int type, java.lang.String subtype, com.liferay.portal.service.ServiceContext serviceContext) Adds a role.
com.liferay.portal.model.Role	addRole(java.lang.String name, java.util.Map<java.util.Locale,java.lang.String> titleMap, java.util.Map<java.util.Locale,java.lang.String> descriptionMap, int type) Deprecated. As of 6.2.0, replaced by addRole(String, long, String, Map, Map, int, String, ServiceContext)
void	addUserRoles(long userId, long[] roleIds) Adds the roles to the user.
protected void	checkUserRolesPermission(long userId, long[] roleIds)
void	deleteRole(long roleId) Deletes the role with the primary key and its associated permissions.
protected java.util.List<com.liferay.portal.model.Role>	filterRoles(java.util.List<com.liferay.portal.model.Role> roles)
java.util.List<com.liferay.portal.model.Role>	getGroupRoles(long groupId) Returns all the roles associated with the group.
com.liferay.portal.model.Role	getRole(long roleId) Returns the role with the primary key.
com.liferay.portal.model.Role	getRole(long companyId, java.lang.String name) Returns the role with the name in the company.
java.util.List<com.liferay.portal.model.Role>	getUserGroupGroupRoles(long userId, long groupId) Returns all the user's roles within the user group.
java.util.List<com.liferay.portal.model.Role>	getUserGroupRoles(long userId, long groupId) Returns all the user's roles within the user group.
java.util.List<com.liferay.portal.model.Role>	getUserRelatedRoles(long userId, java.util.List<com.liferay.portal.model.Group> groups) Returns the union of all the user's roles within the groups.
java.util.List<com.liferay.portal.model.Role>	getUserRoles(long userId) Returns all the roles associated with the user.
boolean	hasUserRole(long userId, long companyId, java.lang.String name, boolean inherited) Returns true if the user is associated with the named regular role.
boolean	hasUserRoles(long userId, long companyId, java.lang.String[] names, boolean inherited) Returns true if the user has any one of the named regular roles.
void	unsetUserRoles(long userId, long[] roleIds) Removes the matching roles associated with the user.
com.liferay.portal.model.Role	updateRole(long roleId, java.lang.String name, java.util.Map<java.util.Locale,java.lang.String> titleMap, java.util.Map<java.util.Locale,java.lang.String> descriptionMap, java.lang.String subtype, com.liferay.portal.service.ServiceContext serviceContext) Updates the role with the primary key.

Methods inherited from class com.liferay.portal.service.base.RoleServiceBaseImpl

afterPropertiesSet, destroy, getAccountLocalService, getAccountPersistence, getAccountService, getAddressLocalService, getAddressPersistence, getAddressService, getBackgroundTaskLocalService, getBackgroundTaskPersistence, getBackgroundTaskService, getBeanIdentifier, getBrowserTrackerLocalService, getBrowserTrackerPersistence, getClassNameLocalService, getClassNamePersistence, getClassNameService, getClusterGroupLocalService, getClusterGroupPersistence, getCMISRepositoryLocalService, getCompanyLocalService, getCompanyPersistence, getCompanyService, getContactLocalService, getContactPersistence, getContactService, getCounterLocalService, getCountryPersistence, getCountryService, getEmailAddressLocalService, getEmailAddressPersistence, getEmailAddressService, getExpandoRowLocalService, getExpandoRowPersistence, getGroupFinder, getGroupLocalService, getGroupPersistence, getGroupService, getImageLocalService, getImagePersistence, getImageService, getLayoutBranchLocalService, getLayoutBranchPersistence, getLayoutBranchService, getLayoutFinder, getLayoutFriendlyURLLocalService, getLayoutFriendlyURLPersistence, getLayoutLocalService, getLayoutPersistence, getLayoutPrototypeLocalService, getLayoutPrototypePersistence, getLayoutPrototypeService, getLayoutRevisionLocalService, getLayoutRevisionPersistence, getLayoutRevisionService, getLayoutService, getLayoutSetBranchLocalService, getLayoutSetBranchPersistence, getLayoutSetBranchService, getLayoutSetLocalService, getLayoutSetPersistence, getLayoutSetPrototypeLocalService, getLayoutSetPrototypePersistence, getLayoutSetPrototypeService, getLayoutSetService, getLayoutTemplateLocalService, getListTypePersistence, getListTypeService, getLockFinder, getLockLocalService, getLockPersistence, getMembershipRequestLocalService, getMembershipRequestPersistence, getMembershipRequestService, getModelClass, getModelClassName, getOrganizationFinder, getOrganizationLocalService, getOrganizationPersistence, getOrganizationService, getOrgGroupRolePersistence, getOrgLaborLocalService, getOrgLaborPersistence, getOrgLaborService, getPasswordPolicyFinder, getPasswordPolicyLocalService, getPasswordPolicyPersistence, getPasswordPolicyRelLocalService, getPasswordPolicyRelPersistence, getPasswordPolicyService, getPasswordTrackerLocalService, getPasswordTrackerPersistence, getPermissionService, getPhoneLocalService, getPhonePersistence, getPhoneService, getPluginSettingLocalService, getPluginSettingPersistence, getPluginSettingService, getPortalLocalService, getPortalPreferencesLocalService, getPortalPreferencesPersistence, getPortalService, getPortletItemLocalService, getPortletItemPersistence, getPortletLocalService, getPortletPersistence, getPortletPreferencesFinder, getPortletPreferencesLocalService, getPortletPreferencesPersistence, getPortletPreferencesService, getPortletService, getQuartzLocalService, getRegionPersistence, getRegionService, getReleaseLocalService, getReleasePersistence, getRepositoryEntryLocalService, getRepositoryEntryPersistence, getRepositoryLocalService, getRepositoryPersistence, getRepositoryService, getResourceActionLocalService, getResourceActionPersistence, getResourceBlockFinder, getResourceBlockLocalService, getResourceBlockPermissionLocalService, getResourceBlockPermissionPersistence, getResourceBlockPersistence, getResourceBlockService, getResourceLocalService, getResourcePermissionFinder, getResourcePermissionLocalService, getResourcePermissionPersistence, getResourcePermissionService, getResourceTypePermissionFinder, getResourceTypePermissionLocalService, getResourceTypePermissionPersistence, getRoleFinder, getRoleLocalService, getRolePersistence, getRoleService, getServiceComponentLocalService, getServiceComponentPersistence, getShardLocalService, getShardPersistence, getStagingLocalService, getStagingService, getSubscriptionLocalService, getSubscriptionPersistence, getSystemEventLocalService, getSystemEventPersistence, getTeamFinder, getTeamLocalService, getTeamPersistence, getTeamService, getThemeLocalService, getThemeService, getTicketLocalService, getTicketPersistence, getUserFinder, getUserGroupFinder, getUserGroupGroupRoleLocalService, getUserGroupGroupRolePersistence, getUserGroupGroupRoleService, getUserGroupLocalService, getUserGroupPersistence, getUserGroupRoleFinder, getUserGroupRoleLocalService, getUserGroupRolePersistence, getUserGroupRoleService, getUserGroupService, getUserIdMapperLocalService, getUserIdMapperPersistence, getUserLocalService, getUserNotificationDeliveryLocalService, getUserNotificationDeliveryPersistence, getUserNotificationEventLocalService, getUserNotificationEventPersistence, getUserPersistence, getUserService, getUserTrackerLocalService, getUserTrackerPathLocalService, getUserTrackerPathPersistence, getUserTrackerPersistence, getVirtualHostLocalService, getVirtualHostPersistence, getWebDAVPropsLocalService, getWebDAVPropsPersistence, getWebsiteLocalService, getWebsitePersistence, getWebsiteService, getWorkflowDefinitionLinkLocalService, getWorkflowDefinitionLinkPersistence, getWorkflowInstanceLinkLocalService, getWorkflowInstanceLinkPersistence, runSQL, setAccountLocalService, setAccountPersistence, setAccountService, setAddressLocalService, setAddressPersistence, setAddressService, setBackgroundTaskLocalService, setBackgroundTaskPersistence, setBackgroundTaskService, setBeanIdentifier, setBrowserTrackerLocalService, setBrowserTrackerPersistence, setClassNameLocalService, setClassNamePersistence, setClassNameService, setClusterGroupLocalService, setClusterGroupPersistence, setCMISRepositoryLocalService, setCompanyLocalService, setCompanyPersistence, setCompanyService, setContactLocalService, setContactPersistence, setContactService, setCounterLocalService, setCountryPersistence, setCountryService, setEmailAddressLocalService, setEmailAddressPersistence, setEmailAddressService, setExpandoRowLocalService, setExpandoRowPersistence, setGroupFinder, setGroupLocalService, setGroupPersistence, setGroupService, setImageLocalService, setImagePersistence, setImageService, setLayoutBranchLocalService, setLayoutBranchPersistence, setLayoutBranchService, setLayoutFinder, setLayoutFriendlyURLLocalService, setLayoutFriendlyURLPersistence, setLayoutLocalService, setLayoutPersistence, setLayoutPrototypeLocalService, setLayoutPrototypePersistence, setLayoutPrototypeService, setLayoutRevisionLocalService, setLayoutRevisionPersistence, setLayoutRevisionService, setLayoutService, setLayoutSetBranchLocalService, setLayoutSetBranchPersistence, setLayoutSetBranchService, setLayoutSetLocalService, setLayoutSetPersistence, setLayoutSetPrototypeLocalService, setLayoutSetPrototypePersistence, setLayoutSetPrototypeService, setLayoutSetService, setLayoutTemplateLocalService, setListTypePersistence, setListTypeService, setLockFinder, setLockLocalService, setLockPersistence, setMembershipRequestLocalService, setMembershipRequestPersistence, setMembershipRequestService, setOrganizationFinder, setOrganizationLocalService, setOrganizationPersistence, setOrganizationService, setOrgGroupRolePersistence, setOrgLaborLocalService, setOrgLaborPersistence, setOrgLaborService, setPasswordPolicyFinder, setPasswordPolicyLocalService, setPasswordPolicyPersistence, setPasswordPolicyRelLocalService, setPasswordPolicyRelPersistence, setPasswordPolicyService, setPasswordTrackerLocalService, setPasswordTrackerPersistence, setPermissionService, setPhoneLocalService, setPhonePersistence, setPhoneService, setPluginSettingLocalService, setPluginSettingPersistence, setPluginSettingService, setPortalLocalService, setPortalPreferencesLocalService, setPortalPreferencesPersistence, setPortalService, setPortletItemLocalService, setPortletItemPersistence, setPortletLocalService, setPortletPersistence, setPortletPreferencesFinder, setPortletPreferencesLocalService, setPortletPreferencesPersistence, setPortletPreferencesService, setPortletService, setQuartzLocalService, setRegionPersistence, setRegionService, setReleaseLocalService, setReleasePersistence, setRepositoryEntryLocalService, setRepositoryEntryPersistence, setRepositoryLocalService, setRepositoryPersistence, setRepositoryService, setResourceActionLocalService, setResourceActionPersistence, setResourceBlockFinder, setResourceBlockLocalService, setResourceBlockPermissionLocalService, setResourceBlockPermissionPersistence, setResourceBlockPersistence, setResourceBlockService, setResourceLocalService, setResourcePermissionFinder, setResourcePermissionLocalService, setResourcePermissionPersistence, setResourcePermissionService, setResourceTypePermissionFinder, setResourceTypePermissionLocalService, setResourceTypePermissionPersistence, setRoleFinder, setRoleLocalService, setRolePersistence, setRoleService, setServiceComponentLocalService, setServiceComponentPersistence, setShardLocalService, setShardPersistence, setStagingLocalService, setStagingService, setSubscriptionLocalService, setSubscriptionPersistence, setSystemEventLocalService, setSystemEventPersistence, setTeamFinder, setTeamLocalService, setTeamPersistence, setTeamService, setThemeLocalService, setThemeService, setTicketLocalService, setTicketPersistence, setUserFinder, setUserGroupFinder, setUserGroupGroupRoleLocalService, setUserGroupGroupRolePersistence, setUserGroupGroupRoleService, setUserGroupLocalService, setUserGroupPersistence, setUserGroupRoleFinder, setUserGroupRoleLocalService, setUserGroupRolePersistence, setUserGroupRoleService, setUserGroupService, setUserIdMapperLocalService, setUserIdMapperPersistence, setUserLocalService, setUserNotificationDeliveryLocalService, setUserNotificationDeliveryPersistence, setUserNotificationEventLocalService, setUserNotificationEventPersistence, setUserPersistence, setUserService, setUserTrackerLocalService, setUserTrackerPathLocalService, setUserTrackerPathPersistence, setUserTrackerPersistence, setVirtualHostLocalService, setVirtualHostPersistence, setWebDAVPropsLocalService, setWebDAVPropsPersistence, setWebsiteLocalService, setWebsitePersistence, setWebsiteService, setWorkflowDefinitionLinkLocalService, setWorkflowDefinitionLinkPersistence, setWorkflowInstanceLinkLocalService, setWorkflowInstanceLinkPersistence

Methods inherited from class com.liferay.portal.service.BaseServiceImpl

getClassLoader, getGuestOrUser, getGuestOrUserId, getPermissionChecker, getUser, getUserId

Methods inherited from class java.lang.Object

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

Constructor Detail

RoleServiceImpl

public RoleServiceImpl()

Method Detail

addRole

public com.liferay.portal.model.Role addRole(java.lang.String className,
                                    long classPK,
                                    java.lang.String name,
                                    java.util.Map<java.util.Locale,java.lang.String> titleMap,
                                    java.util.Map<java.util.Locale,java.lang.String> descriptionMap,
                                    int type,
                                    java.lang.String subtype,
                                    com.liferay.portal.service.ServiceContext serviceContext)
                                      throws com.liferay.portal.kernel.exception.PortalException,
                                             com.liferay.portal.kernel.exception.SystemException

Adds a role. The user is reindexed after role is added.

Parameters:

className - the name of the class for which the role is created

classPK - the primary key of the class for which the role is created (optionally 0)

name - the role's name

titleMap - the role's localized titles (optionally null)

descriptionMap - the role's localized descriptions (optionally null)

type - the role's type (optionally 0)

subtype - the role's subtype (optionally null)

serviceContext - the service context to be applied (optionally null). Can set the expando bridge attributes for the role.

Returns:

the role

Throws:

com.liferay.portal.kernel.exception.PortalException - if a user with the primary key could not be found, if the user did not have permission to add roles, if the class name or the role name were invalid, or if the role is a duplicate

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

addRole

public com.liferay.portal.model.Role addRole(java.lang.String name,
                                    java.util.Map<java.util.Locale,java.lang.String> titleMap,
                                    java.util.Map<java.util.Locale,java.lang.String> descriptionMap,
                                    int type)
                                      throws com.liferay.portal.kernel.exception.PortalException,
                                             com.liferay.portal.kernel.exception.SystemException

Deprecated. As of 6.2.0, replaced by addRole(String, long, String, Map, Map, int, String, ServiceContext)

Adds a role. The user is reindexed after role is added.

Parameters:

name - the role's name

titleMap - the role's localized titles (optionally null)

descriptionMap - the role's localized descriptions (optionally null)

type - the role's type (optionally 0)

Returns:

the role

Throws:

com.liferay.portal.kernel.exception.PortalException - if a user with the primary key could not be found, if the user did not have permission to add roles, if the class name or the role name were invalid, or if the role is a duplicate

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

addUserRoles

public void addUserRoles(long userId,
                long[] roleIds)
                  throws com.liferay.portal.kernel.exception.PortalException,
                         com.liferay.portal.kernel.exception.SystemException

Adds the roles to the user. The user is reindexed after the roles are added.

Parameters:

userId - the primary key of the user

roleIds - the primary keys of the roles

Throws:

com.liferay.portal.kernel.exception.PortalException - if a user with the primary key could not be found or if the user did not have permission to assign members to one of the roles

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

deleteRole

public void deleteRole(long roleId)
                throws com.liferay.portal.kernel.exception.PortalException,
                       com.liferay.portal.kernel.exception.SystemException

Deletes the role with the primary key and its associated permissions.

Parameters:

roleId - the primary key of the role

Throws:

com.liferay.portal.kernel.exception.PortalException - if the user did not have permission to delete the role, if a role with the primary key could not be found, if the role is a default system role, or if the role's resource could not be found

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getGroupRoles

public java.util.List<com.liferay.portal.model.Role> getGroupRoles(long groupId)
                                                            throws com.liferay.portal.kernel.exception.PortalException,
                                                                   com.liferay.portal.kernel.exception.SystemException

Returns all the roles associated with the group.

Parameters:

groupId - the primary key of the group

Returns:

the roles associated with the group

Throws:

com.liferay.portal.kernel.exception.PortalException - if a portal exception occurred

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getRole

public com.liferay.portal.model.Role getRole(long roleId)
                                      throws com.liferay.portal.kernel.exception.PortalException,
                                             com.liferay.portal.kernel.exception.SystemException

Returns the role with the primary key.

Parameters:

roleId - the primary key of the role

Returns:

the role with the primary key

Throws:

com.liferay.portal.kernel.exception.PortalException - if a role with the primary key could not be found or if the user did not have permission to view the role

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getRole

public com.liferay.portal.model.Role getRole(long companyId,
                                    java.lang.String name)
                                      throws com.liferay.portal.kernel.exception.PortalException,
                                             com.liferay.portal.kernel.exception.SystemException

Returns the role with the name in the company.

The method searches the system roles map first for default roles. If a role with the name is not found, then the method will query the database.

Parameters:

companyId - the primary key of the company

name - the role's name

Returns:

the role with the name

Throws:

com.liferay.portal.kernel.exception.PortalException - if a role with the name could not be found in the company or if the user did not have permission to view the role

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getUserGroupGroupRoles

public java.util.List<com.liferay.portal.model.Role> getUserGroupGroupRoles(long userId,
                                                                   long groupId)
                                                                     throws com.liferay.portal.kernel.exception.PortalException,
                                                                            com.liferay.portal.kernel.exception.SystemException

Returns all the user's roles within the user group.

Parameters:

userId - the primary key of the user

groupId - the primary key of the group

Returns:

the user's roles within the user group

Throws:

com.liferay.portal.kernel.exception.PortalException - if a portal exception occurred

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getUserGroupRoles

public java.util.List<com.liferay.portal.model.Role> getUserGroupRoles(long userId,
                                                              long groupId)
                                                                throws com.liferay.portal.kernel.exception.PortalException,
                                                                       com.liferay.portal.kernel.exception.SystemException

Returns all the user's roles within the user group.

Parameters:

userId - the primary key of the user

groupId - the primary key of the group

Returns:

the user's roles within the user group

Throws:

com.liferay.portal.kernel.exception.PortalException - if a portal exception occurred

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getUserRelatedRoles

public java.util.List<com.liferay.portal.model.Role> getUserRelatedRoles(long userId,
                                                                java.util.List<com.liferay.portal.model.Group> groups)
                                                                  throws com.liferay.portal.kernel.exception.PortalException,
                                                                         com.liferay.portal.kernel.exception.SystemException

Returns the union of all the user's roles within the groups.

Parameters:

userId - the primary key of the user

groups - the groups (optionally null)

Returns:

the union of all the user's roles within the groups

Throws:

com.liferay.portal.kernel.exception.PortalException - if a portal exception occurred

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

getUserRoles

public java.util.List<com.liferay.portal.model.Role> getUserRoles(long userId)
                                                           throws com.liferay.portal.kernel.exception.PortalException,
                                                                  com.liferay.portal.kernel.exception.SystemException

Returns all the roles associated with the user.

Parameters:

userId - the primary key of the user

Returns:

the roles associated with the user

Throws:

com.liferay.portal.kernel.exception.PortalException - if a portal exception occurred

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

hasUserRole

public boolean hasUserRole(long userId,
                  long companyId,
                  java.lang.String name,
                  boolean inherited)
                    throws com.liferay.portal.kernel.exception.PortalException,
                           com.liferay.portal.kernel.exception.SystemException

Returns true if the user is associated with the named regular role.

Parameters:

userId - the primary key of the user

companyId - the primary key of the company

name - the name of the role

inherited - whether to include the user's inherited roles in the search

Returns:

true if the user is associated with the regular role; false otherwise

Throws:

com.liferay.portal.kernel.exception.PortalException - if a role with the name could not be found in the company or if a default user for the company could not be found

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

hasUserRoles

public boolean hasUserRoles(long userId,
                   long companyId,
                   java.lang.String[] names,
                   boolean inherited)
                     throws com.liferay.portal.kernel.exception.PortalException,
                            com.liferay.portal.kernel.exception.SystemException

Returns true if the user has any one of the named regular roles.

Parameters:

userId - the primary key of the user

companyId - the primary key of the company

names - the names of the roles

inherited - whether to include the user's inherited roles in the search

Returns:

true if the user has any one of the regular roles; false otherwise

Throws:

com.liferay.portal.kernel.exception.PortalException - if any one of the roles with the names could not be found in the company or if the default user for the company could not be found

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

unsetUserRoles

public void unsetUserRoles(long userId,
                  long[] roleIds)
                    throws com.liferay.portal.kernel.exception.PortalException,
                           com.liferay.portal.kernel.exception.SystemException

Removes the matching roles associated with the user. The user is reindexed after the roles are removed.

Parameters:

userId - the primary key of the user

roleIds - the primary keys of the roles

Throws:

com.liferay.portal.kernel.exception.PortalException - if a user with the primary key could not be found, if the user did not have permission to remove members from a role, or if a role with any one of the primary keys could not be found

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

updateRole

public com.liferay.portal.model.Role updateRole(long roleId,
                                       java.lang.String name,
                                       java.util.Map<java.util.Locale,java.lang.String> titleMap,
                                       java.util.Map<java.util.Locale,java.lang.String> descriptionMap,
                                       java.lang.String subtype,
                                       com.liferay.portal.service.ServiceContext serviceContext)
                                         throws com.liferay.portal.kernel.exception.PortalException,
                                                com.liferay.portal.kernel.exception.SystemException

Updates the role with the primary key.

Parameters:

roleId - the primary key of the role

name - the role's new name

titleMap - the new localized titles (optionally null) to replace those existing for the role

descriptionMap - the new localized descriptions (optionally null) to replace those existing for the role

subtype - the role's new subtype (optionally null)

serviceContext - the service context to be applied (optionally null). Can set the expando bridge attributes for the role.

Returns:

the role with the primary key

Throws:

com.liferay.portal.kernel.exception.PortalException - if the user did not have permission to update the role, if a role with the primary could not be found, or if the role's name was invalid

com.liferay.portal.kernel.exception.SystemException - if a system exception occurred

checkUserRolesPermission

protected void checkUserRolesPermission(long userId,
                            long[] roleIds)
                                 throws com.liferay.portal.kernel.exception.PortalException

Throws:

com.liferay.portal.kernel.exception.PortalException

filterRoles

protected java.util.List<com.liferay.portal.model.Role> filterRoles(java.util.List<com.liferay.portal.model.Role> roles)
                                                             throws com.liferay.portal.kernel.exception.PortalException

Throws:

com.liferay.portal.kernel.exception.PortalException