Interface RoleLocalService

All Superinterfaces:
BaseLocalService, CTService<Role>, PersistedModelLocalService
All Known Implementing Classes:
RoleLocalServiceWrapper

Provides the local service interface for Role. Methods of this service will not have security checks based on the propagated JAAS credentials because this service can only be accessed from within the same VM.
Author:
Brian Wing Shun Chan
See Also:
{$generated.description}
  • Method Details

    • addGroupRole

      boolean addGroupRole(long groupId, long roleId)
    • addGroupRole

      boolean addGroupRole(long groupId, Role role)
    • addGroupRoles

      boolean addGroupRoles(long groupId, List<Role> roles)
    • addGroupRoles

      boolean addGroupRoles(long groupId, long[] roleIds)
    • addRole

      @Indexable(type=REINDEX) Role addRole(Role role)
      Adds the role to the database. Also notifies the appropriate model listeners.

      Important: Inspect RoleLocalServiceImpl for overloaded versions of the method. If provided, use these entry points to the API, as the implementation logic may require the additional parameters defined there.

      Parameters:
      role - the role
      Returns:
      the role that was added
    • addRole

      Role addRole(String externalReferenceCode, long userId, String className, long classPK, String name, Map<Locale,String> titleMap, Map<Locale,String> descriptionMap, int type, String subtype, ServiceContext serviceContext) throws PortalException
      Throws:
      PortalException
    • addUserRole

      boolean addUserRole(long userId, long roleId) throws PortalException
      Throws:
      PortalException
    • addUserRole

      boolean addUserRole(long userId, Role role) throws PortalException
      Throws:
      PortalException
    • addUserRoles

      boolean addUserRoles(long userId, List<Role> roles) throws PortalException
      Throws:
      PortalException
    • addUserRoles

      boolean addUserRoles(long userId, long[] roleIds) throws PortalException
      Throws:
      PortalException
    • checkSystemRoles

      void checkSystemRoles() throws PortalException
      Checks to ensure that the system roles map has appropriate default roles in each company.
      Throws:
      PortalException
    • checkSystemRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) void checkSystemRoles(long companyId) throws PortalException
      Checks to ensure that the system roles map has appropriate default roles in the company.
      Parameters:
      companyId - the primary key of the company
      Throws:
      PortalException
    • clearGroupRoles

      void clearGroupRoles(long groupId)
    • clearUserRoles

      void clearUserRoles(long userId) throws PortalException
      Throws:
      PortalException
    • createPersistedModel

      PersistedModel createPersistedModel(Serializable primaryKeyObj) throws PortalException
      Specified by:
      createPersistedModel in interface PersistedModelLocalService
      Throws:
      PortalException
    • createRole

      @Transactional(enabled=false) Role createRole(long roleId)
      Creates a new role with the primary key. Does not add the role to the database.
      Parameters:
      roleId - the primary key for the new role
      Returns:
      the new role
    • deleteGroupRole

      void deleteGroupRole(long groupId, long roleId)
    • deleteGroupRole

      void deleteGroupRole(long groupId, Role role)
    • deleteGroupRoles

      void deleteGroupRoles(long groupId, List<Role> roles)
    • deleteGroupRoles

      void deleteGroupRoles(long groupId, long[] roleIds)
    • deletePersistedModel

      PersistedModel deletePersistedModel(PersistedModel persistedModel) throws PortalException
      Specified by:
      deletePersistedModel in interface PersistedModelLocalService
      Throws:
      PortalException
    • deleteRole

      @Indexable(type=DELETE) Role deleteRole(long roleId) throws PortalException
      Deletes the role with the primary key from the database. Also notifies the appropriate model listeners.

      Important: Inspect RoleLocalServiceImpl for overloaded versions of the method. If provided, use these entry points to the API, as the implementation logic may require the additional parameters defined there.

      Parameters:
      roleId - the primary key of the role
      Returns:
      the role that was removed
      Throws:
      PortalException - if a role with the primary key could not be found
    • deleteRole

      Deletes the role from the database. Also notifies the appropriate model listeners.

      Important: Inspect RoleLocalServiceImpl for overloaded versions of the method. If provided, use these entry points to the API, as the implementation logic may require the additional parameters defined there.

      Parameters:
      role - the role
      Returns:
      the role that was removed
      Throws:
      PortalException
    • deleteUserRole

      void deleteUserRole(long userId, long roleId) throws PortalException
      Throws:
      PortalException
    • deleteUserRole

      void deleteUserRole(long userId, Role role) throws PortalException
      Throws:
      PortalException
    • deleteUserRoles

      void deleteUserRoles(long userId, List<Role> roles) throws PortalException
      Throws:
      PortalException
    • deleteUserRoles

      void deleteUserRoles(long userId, long[] roleIds) throws PortalException
      Throws:
      PortalException
    • dslQuery

      @Transactional(propagation=SUPPORTS, readOnly=true) <T> T dslQuery(com.liferay.petra.sql.dsl.query.DSLQuery dslQuery)
      Specified by:
      dslQuery in interface PersistedModelLocalService
    • dslQueryCount

      @Transactional(propagation=SUPPORTS, readOnly=true) int dslQueryCount(com.liferay.petra.sql.dsl.query.DSLQuery dslQuery)
      Specified by:
      dslQueryCount in interface PersistedModelLocalService
    • dynamicQuery

    • dynamicQuery

      @Transactional(propagation=SUPPORTS, readOnly=true) <T> List<T> dynamicQuery(DynamicQuery dynamicQuery)
      Performs a dynamic query on the database and returns the matching rows.
      Parameters:
      dynamicQuery - the dynamic query
      Returns:
      the matching rows
    • dynamicQuery

      @Transactional(propagation=SUPPORTS, readOnly=true) <T> List<T> dynamicQuery(DynamicQuery dynamicQuery, int start, int end)
      Performs a dynamic query on the database and returns a range of the matching rows.

      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 com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent, then the query will include the default ORDER BY logic from com.liferay.portal.model.impl.RoleModelImpl.

      Parameters:
      dynamicQuery - the dynamic query
      start - the lower bound of the range of model instances
      end - the upper bound of the range of model instances (not inclusive)
      Returns:
      the range of matching rows
    • dynamicQuery

      @Transactional(propagation=SUPPORTS, readOnly=true) <T> List<T> dynamicQuery(DynamicQuery dynamicQuery, int start, int end, OrderByComparator<T> orderByComparator)
      Performs a dynamic query on the database and returns an ordered range of the matching rows.

      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 com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent, then the query will include the default ORDER BY logic from com.liferay.portal.model.impl.RoleModelImpl.

      Parameters:
      dynamicQuery - the dynamic query
      start - the lower bound of the range of model instances
      end - the upper bound of the range of model instances (not inclusive)
      orderByComparator - the comparator to order the results by (optionally null)
      Returns:
      the ordered range of matching rows
    • dynamicQueryCount

      @Transactional(propagation=SUPPORTS, readOnly=true) long dynamicQueryCount(DynamicQuery dynamicQuery)
      Returns the number of rows matching the dynamic query.
      Parameters:
      dynamicQuery - the dynamic query
      Returns:
      the number of rows matching the dynamic query
    • dynamicQueryCount

      @Transactional(propagation=SUPPORTS, readOnly=true) long dynamicQueryCount(DynamicQuery dynamicQuery, Projection projection)
      Returns the number of rows matching the dynamic query.
      Parameters:
      dynamicQuery - the dynamic query
      projection - the projection to apply to the query
      Returns:
      the number of rows matching the dynamic query
    • fetchRole

      @Transactional(propagation=SUPPORTS, readOnly=true) Role fetchRole(long roleId)
    • fetchRole

      @Transactional(propagation=SUPPORTS, readOnly=true) Role fetchRole(long companyId, String name)
      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:
      Returns the role with the name or null if a role with the name could not be found in the company
    • fetchRoleByExternalReferenceCode

      @Transactional(propagation=SUPPORTS, readOnly=true) Role fetchRoleByExternalReferenceCode(String externalReferenceCode, long companyId)
    • fetchRoleByUuidAndCompanyId

      @Transactional(propagation=SUPPORTS, readOnly=true) Role fetchRoleByUuidAndCompanyId(String uuid, long companyId)
      Returns the role with the matching UUID and company.
      Parameters:
      uuid - the role's UUID
      companyId - the primary key of the company
      Returns:
      the matching role, or null if a matching role could not be found
    • getActionableDynamicQuery

    • getAssigneesTotal

      @Transactional(propagation=SUPPORTS, readOnly=true) int getAssigneesTotal(long roleId) throws PortalException
      Throws:
      PortalException
    • getDefaultGroupRole

      @Transactional(propagation=SUPPORTS, readOnly=true) Role getDefaultGroupRole(long groupId) throws PortalException
      Returns the default role for the group with the primary key.

      If the group is a site, then the default role is RoleConstants#SITE_MEMBER. If the group is an organization, then the default role is RoleConstants#ORGANIZATION_USER. If the group is a user or user group, then the default role is RoleConstants#POWER_USER. For all other group types, the default role is RoleConstants#USER.

      Parameters:
      groupId - the primary key of the group
      Returns:
      the default role for the group with the primary key
      Throws:
      PortalException
    • getExportActionableDynamicQuery

      @Transactional(propagation=SUPPORTS, readOnly=true) ExportActionableDynamicQuery getExportActionableDynamicQuery(PortletDataContext portletDataContext)
    • getGroupPrimaryKeys

      @Transactional(propagation=SUPPORTS, readOnly=true) long[] getGroupPrimaryKeys(long roleId)
      Returns the groupIds of the groups associated with the role.
      Parameters:
      roleId - the roleId of the role
      Returns:
      long[] the groupIds of groups associated with the role
    • getGroupRelatedRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getGroupRelatedRoles(long groupId) throws PortalException
      Throws:
      PortalException
    • getGroupRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getGroupRoles(long groupId)
    • getGroupRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getGroupRoles(long groupId, int start, int end)
    • getGroupRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getGroupRoles(long groupId, int start, int end, OrderByComparator<Role> orderByComparator)
    • getGroupRolesAndTeamRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getGroupRolesAndTeamRoles(long companyId, String name, List<String> excludedNames, String title, String description, int[] types, long excludedTeamRoleId, long teamGroupId, int start, int end)
    • getGroupRolesAndTeamRolesCount

      @Transactional(propagation=SUPPORTS, readOnly=true) int getGroupRolesAndTeamRolesCount(long companyId, String name, List<String> excludedNames, String title, String description, int[] types, long excludedTeamRoleId, long teamGroupId)
    • getGroupRolesCount

      @Transactional(propagation=SUPPORTS, readOnly=true) int getGroupRolesCount(long groupId)
    • getIndexableActionableDynamicQuery

      @Transactional(propagation=SUPPORTS, readOnly=true) IndexableActionableDynamicQuery getIndexableActionableDynamicQuery()
    • getOSGiServiceIdentifier

      String getOSGiServiceIdentifier()
      Returns the OSGi service identifier.
      Returns:
      the OSGi service identifier
    • getPersistedModel

      @Transactional(propagation=SUPPORTS, readOnly=true) PersistedModel getPersistedModel(Serializable primaryKeyObj) throws PortalException
      Specified by:
      getPersistedModel in interface PersistedModelLocalService
      Throws:
      PortalException
    • getResourceRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) Map<String,List<String>> getResourceRoles(long companyId, String name, int scope, String primKey)
      Returns a map of role names to associated action IDs for the named resource in the company within the permission scope.
      Parameters:
      companyId - the primary key of the company
      name - the resource name
      scope - the permission scope
      primKey - the primary key of the resource's class
      Returns:
      the role names and action IDs
    • getResourceRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getResourceRoles(long companyId, String name, int scope, String primKey, String actionId)
      Returns all the roles associated with the action ID in the company within the permission scope.
      Parameters:
      companyId - the primary key of the company
      name - the resource name
      scope - the permission scope
      primKey - the primary key of the resource's class
      actionId - the name of the resource action
      Returns:
      the roles
    • getRole

      @Transactional(propagation=SUPPORTS, readOnly=true) Role getRole(long roleId) throws PortalException
      Returns the role with the primary key.
      Parameters:
      roleId - the primary key of the role
      Returns:
      the role
      Throws:
      PortalException - if a role with the primary key could not be found
    • getRole

      @Transactional(propagation=SUPPORTS, readOnly=true) Role getRole(long companyId, String name) throws PortalException
      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:
      PortalException
    • getRoleByExternalReferenceCode

      @Transactional(propagation=SUPPORTS, readOnly=true) Role getRoleByExternalReferenceCode(String externalReferenceCode, long companyId) throws PortalException
      Throws:
      PortalException
    • getRoleByUuidAndCompanyId

      @Transactional(propagation=SUPPORTS, readOnly=true) Role getRoleByUuidAndCompanyId(String uuid, long companyId) throws PortalException
      Returns the role with the matching UUID and company.
      Parameters:
      uuid - the role's UUID
      companyId - the primary key of the company
      Returns:
      the matching role
      Throws:
      PortalException - if a matching role could not be found
    • getRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getRoles(int start, int end)
      Returns a range of all the roles.

      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 com.liferay.portal.kernel.dao.orm.QueryUtil#ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent, then the query will include the default ORDER BY logic from com.liferay.portal.model.impl.RoleModelImpl.

      Parameters:
      start - the lower bound of the range of roles
      end - the upper bound of the range of roles (not inclusive)
      Returns:
      the range of roles
    • getRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getRoles(int type, String subtype)
      Returns all the roles of the type and subtype.
      Parameters:
      type - the role's type (optionally 0)
      subtype - the role's subtype (optionally null)
      Returns:
      the roles of the type and subtype
    • getRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getRoles(long companyId)
      Returns all the roles in the company.
      Parameters:
      companyId - the primary key of the company
      Returns:
      the roles in the company
    • getRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getRoles(long companyId, int[] types)
      Returns all the roles with the types.
      Parameters:
      companyId - the primary key of the company
      types - the role types (optionally null)
      Returns:
      the roles with the types
    • getRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getRoles(long companyId, long classNameId, long[] classPKs, int type)
    • getRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getRoles(long[] roleIds) throws PortalException
      Returns all the roles with the primary keys.
      Parameters:
      roleIds - the primary keys of the roles
      Returns:
      the roles with the primary keys
      Throws:
      PortalException
    • getRolesCount

      @Transactional(propagation=SUPPORTS, readOnly=true) int getRolesCount()
      Returns the number of roles.
      Returns:
      the number of roles
    • getSubtypeRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getSubtypeRoles(String subtype)
      Returns all the roles of the subtype.
      Parameters:
      subtype - the role's subtype (optionally null)
      Returns:
      the roles of the subtype
    • getSubtypeRolesCount

      @Transactional(propagation=SUPPORTS, readOnly=true) int getSubtypeRolesCount(String subtype)
      Returns the number of roles of the subtype.
      Parameters:
      subtype - the role's subtype (optionally null)
      Returns:
      the number of roles of the subtype
    • getTeamRole

      @Transactional(propagation=SUPPORTS, readOnly=true) Role getTeamRole(long companyId, long teamId) throws PortalException
      Returns the team role in the company.
      Parameters:
      companyId - the primary key of the company
      teamId - the primary key of the team
      Returns:
      the team role in the company
      Throws:
      PortalException
    • getTeamRoleMap

      @Transactional(propagation=SUPPORTS, readOnly=true) Map<Team,Role> getTeamRoleMap(long groupId) throws PortalException
      Returns the team role map for the group.
      Parameters:
      groupId - the primary key of the group
      Returns:
      the team role map for the group
      Throws:
      PortalException
    • getTeamRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getTeamRoles(long groupId) throws PortalException
      Returns the team roles in the group.
      Parameters:
      groupId - the primary key of the group
      Returns:
      the team roles in the group
      Throws:
      PortalException
    • getTeamRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getTeamRoles(long groupId, long[] excludedRoleIds) throws PortalException
      Returns the team roles in the group, excluding the specified role IDs.
      Parameters:
      groupId - the primary key of the group
      excludedRoleIds - the primary keys of the roles to exclude (optionally null)
      Returns:
      the team roles in the group, excluding the specified role IDs
      Throws:
      PortalException
    • getTeamsRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getTeamsRoles(long companyId, long[] teamIds) throws PortalException
      Returns the team roles in the company.
      Parameters:
      companyId - the primary key of the company
      teamIds - the primary keys of the teams
      Returns:
      the team roles in the company
      Throws:
      PortalException
    • getTypeRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getTypeRoles(int type)
      Returns all the roles of the type.
      Parameters:
      type - the role's type (optionally 0)
      Returns:
      the range of the roles of the type
    • getTypeRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getTypeRoles(int type, int start, int end)
      Returns a range of all the roles of the type.
      Parameters:
      type - the role's type (optionally 0)
      start - the lower bound of the range of roles to return
      end - the upper bound of the range of roles to return (not inclusive)
      Returns:
      the range of the roles of the type
    • getTypeRolesCount

      @Transactional(propagation=SUPPORTS, readOnly=true) int getTypeRolesCount(int type)
      Returns the number of roles of the type.
      Parameters:
      type - the role's type (optionally 0)
      Returns:
      the number of roles of the type
    • getUserGroupGroupRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getUserGroupGroupRoles(long userId, long groupId)
      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
    • getUserGroupGroupRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getUserGroupGroupRoles(long userId, long groupId, int start, int end)
    • getUserGroupGroupRolesCount

      @Transactional(propagation=SUPPORTS, readOnly=true) int getUserGroupGroupRolesCount(long userId, long groupId)
    • getUserGroupRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getUserGroupRoles(long userId, long groupId)
      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
    • getUserPrimaryKeys

      @Transactional(propagation=SUPPORTS, readOnly=true) long[] getUserPrimaryKeys(long roleId)
      Returns the userIds of the users associated with the role.
      Parameters:
      roleId - the roleId of the role
      Returns:
      long[] the userIds of users associated with the role
    • getUserRelatedRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getUserRelatedRoles(long userId, List<Group> groups)
      Returns the union of all the user's roles within the groups. If no groups are provided, only the user's directly assigned roles are returned.
      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
    • getUserRelatedRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getUserRelatedRoles(long userId, long groupId)
      Returns all the user's roles within the group.
      Parameters:
      userId - the primary key of the user
      groupId - the primary key of the group
      Returns:
      the user's roles within the group
    • getUserRelatedRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getUserRelatedRoles(long userId, long[] groupIds)
      Returns the union of all the user's roles within the groups. If no groupIds are provided, only the user's directly assigned roles are returned.
      Parameters:
      userId - the primary key of the user
      groupIds - the primary keys of the groups
      Returns:
      the union of all the user's roles within the groups
    • getUserRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getUserRoles(long userId)
    • getUserRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getUserRoles(long userId, int start, int end)
    • getUserRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getUserRoles(long userId, int start, int end, OrderByComparator<Role> orderByComparator)
    • getUserRolesCount

      @Transactional(propagation=SUPPORTS, readOnly=true) int getUserRolesCount(long userId)
    • getUserTeamRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> getUserTeamRoles(long userId, long groupId)
    • hasGroupRole

      @Transactional(propagation=SUPPORTS, readOnly=true) boolean hasGroupRole(long groupId, long roleId)
    • hasGroupRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) boolean hasGroupRoles(long groupId)
    • hasUserRole

      @Transactional(propagation=SUPPORTS, readOnly=true) boolean hasUserRole(long userId, long roleId)
    • hasUserRole

      @ThreadLocalCachable @Transactional(propagation=SUPPORTS, readOnly=true) boolean hasUserRole(long userId, long companyId, String name, boolean inherited) throws PortalException
      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:
      PortalException
    • hasUserRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) boolean hasUserRoles(long userId)
    • hasUserRoles

      @Transactional(propagation=SUPPORTS, readOnly=true) boolean hasUserRoles(long userId, long companyId, String[] names, boolean inherited) throws PortalException
      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:
      PortalException
    • search

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> search(long companyId, String keywords, Integer[] types, int start, int end, OrderByComparator<Role> orderByComparator)
      Returns an ordered range of all the roles that match the keywords and types.

      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
      keywords - the keywords (space separated), which may occur in the role's name or description (optionally null)
      types - the role types (optionally null)
      start - the lower bound of the range of roles to return
      end - the upper bound of the range of roles to return (not inclusive)
      orderByComparator - the comparator to order the roles (optionally null)
      Returns:
      the ordered range of the matching roles, ordered by orderByComparator
      See Also:
    • search

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> search(long companyId, String keywords, Integer[] types, LinkedHashMap<String,Object> params, int start, int end, OrderByComparator<Role> orderByComparator)
      Returns an ordered range of all the roles that match the keywords, types, and params.

      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
      keywords - the keywords (space separated), which may occur in the role's name or description (optionally null)
      types - the role types (optionally null)
      params - the finder parameters. Can specify values for the "usersRoles" key. For more information, see RoleFinder
      start - the lower bound of the range of roles to return
      end - the upper bound of the range of roles to return (not inclusive)
      orderByComparator - the comparator to order the roles (optionally null)
      Returns:
      the ordered range of the matching roles, ordered by orderByComparator
      See Also:
    • search

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> search(long companyId, String name, String description, Integer[] types, int start, int end, OrderByComparator<Role> orderByComparator)
      Returns an ordered range of all the roles that match the name, description, and types.

      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 role's name (optionally null)
      description - the role's description (optionally null)
      types - the role types (optionally null)
      start - the lower bound of the range of the roles to return
      end - the upper bound of the range of the roles to return (not inclusive)
      orderByComparator - the comparator to order the roles (optionally null)
      Returns:
      the ordered range of the matching roles, ordered by orderByComparator
      See Also:
    • search

      @Transactional(propagation=SUPPORTS, readOnly=true) List<Role> search(long companyId, String name, String description, Integer[] types, LinkedHashMap<String,Object> params, int start, int end, OrderByComparator<Role> orderByComparator)
      Returns an ordered range of all the roles that match the name, description, types, and params.

      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 role's name (optionally null)
      description - the role's description (optionally null)
      types - the role types (optionally null)
      params - the finder's parameters. Can specify values for the "usersRoles" key. For more information, see RoleFinder
      start - the lower bound of the range of the roles to return
      end - the upper bound of the range of the roles to return (not inclusive)
      orderByComparator - the comparator to order the roles (optionally null)
      Returns:
      the ordered range of the matching roles, ordered by orderByComparator
      See Also:
    • searchCount

      @Transactional(propagation=SUPPORTS, readOnly=true) int searchCount(long companyId, String keywords, Integer[] types)
      Returns the number of roles that match the keywords and types.
      Parameters:
      companyId - the primary key of the company
      keywords - the keywords (space separated), which may occur in the role's name or description (optionally null)
      types - the role types (optionally null)
      Returns:
      the number of matching roles
    • searchCount

      @Transactional(propagation=SUPPORTS, readOnly=true) int searchCount(long companyId, String keywords, Integer[] types, LinkedHashMap<String,Object> params)
      Returns the number of roles that match the keywords, types and params.
      Parameters:
      companyId - the primary key of the company
      keywords - the keywords (space separated), which may occur in the role's name or description (optionally null)
      types - the role types (optionally null)
      params - the finder parameters. For more information, see RoleFinder
      Returns:
      the number of matching roles
    • searchCount

      @Transactional(propagation=SUPPORTS, readOnly=true) int searchCount(long companyId, String name, String description, Integer[] types)
      Returns the number of roles that match the name, description, and types.
      Parameters:
      companyId - the primary key of the company
      name - the role's name (optionally null)
      description - the role's description (optionally null)
      types - the role types (optionally null)
      Returns:
      the number of matching roles
    • searchCount

      @Transactional(propagation=SUPPORTS, readOnly=true) int searchCount(long companyId, String name, String description, Integer[] types, LinkedHashMap<String,Object> params)
      Returns the number of roles that match the name, description, types, and params.
      Parameters:
      companyId - the primary key of the company
      name - the role's name (optionally null)
      description - the role's description (optionally null)
      types - the role types (optionally null)
      params - the finder parameters. Can specify values for the "usersRoles" key. For more information, see RoleFinder
      Returns:
      the number of matching roles
    • setGroupRoles

      void setGroupRoles(long groupId, long[] roleIds)
    • setUserRoles

      void setUserRoles(long userId, long[] roleIds) throws PortalException
      Throws:
      PortalException
    • unsetUserRoles

      void unsetUserRoles(long userId, long[] roleIds) throws PortalException
      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:
      PortalException
    • updateExternalReferenceCode

      Role updateExternalReferenceCode(long roleId, String externalReferenceCode) throws PortalException
      Throws:
      PortalException
    • updateExternalReferenceCode

      Role updateExternalReferenceCode(Role role, String externalReferenceCode) throws PortalException
      Throws:
      PortalException
    • updateRole

      Role updateRole(long roleId, String name, Map<Locale,String> titleMap, Map<Locale,String> descriptionMap, String subtype, ServiceContext serviceContext) throws PortalException
      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 expando bridge attributes for the role.
      Returns:
      the role with the primary key
      Throws:
      PortalException
    • updateRole

      @Indexable(type=REINDEX) Role updateRole(Role role)
      Updates the role in the database or adds it if it does not yet exist. Also notifies the appropriate model listeners.

      Important: Inspect RoleLocalServiceImpl for overloaded versions of the method. If provided, use these entry points to the API, as the implementation logic may require the additional parameters defined there.

      Parameters:
      role - the role
      Returns:
      the role that was updated
    • validateName

      void validateName(String name) throws PortalException
      Throws:
      PortalException
    • getCTPersistence

      @Transactional(enabled=false) CTPersistence<Role> getCTPersistence()
      Specified by:
      getCTPersistence in interface CTService<Role>
    • getModelClass

      @Transactional(enabled=false) Class<Role> getModelClass()
      Specified by:
      getModelClass in interface CTService<Role>
    • updateWithUnsafeFunction

      @Transactional(rollbackFor=java.lang.Throwable.class) <R, E extends Throwable> R updateWithUnsafeFunction(com.liferay.petra.function.UnsafeFunction<CTPersistence<Role>,R,E> updateUnsafeFunction) throws E
      Specified by:
      updateWithUnsafeFunction in interface CTService<Role>
      Throws:
      E extends Throwable