org.bonitasoft.engine.external.identity.mapping

Interface ExternalIdentityMappingService

All Known Implementing Classes:

ExternalIdentityMappingServiceImpl

public interface ExternalIdentityMappingService

Since:

6.0

Author:

Emmanuel Duchastenier, Celine Souchet

Method Summary

Modifier and Type	Method and Description
SExternalIdentityMapping	createExternalIdentityMapping(SExternalIdentityMapping externalIdentityMapping) Create externalIdentityMapping in DB for given externalIdentityMapping
void	deleteAllExternalIdentityMappings() Delete all external identity mapping for the connected tenant
void	deleteExternalIdentityMapping(long mappingId) Delete the id specified externalIdentityMapping
void	deleteExternalIdentityMapping(SExternalIdentityMapping externalIdentityMapping) Delete the specific externalIdentityMapping
SExternalIdentityMapping	getExternalIdentityMappingById(long mappingId) Get externalIdentityMapping by its id
SExternalIdentityMapping	getExternalIdentityMappingById(long mappingId, String suffix, String messageSuffix)
SExternalIdentityMapping	getExternalIdentityMappingForGroup(long mappingId) Get externalIdentityMapping by its id with displayNamePart having group related informations
SExternalIdentityMapping	getExternalIdentityMappingForRole(long mappingId) Get externalIdentityMapping by its id with displayNamePart having role related informations
SExternalIdentityMapping	getExternalIdentityMappingForRoleAndGroup(long mappingId) Get externalIdentityMapping by its id with displayNamePart having role and group related informations
SExternalIdentityMapping	getExternalIdentityMappingForUser(long mappingId) Get externalIdentityMapping by its id with displayNamePart having user related informations
long	getNumberOfExternalIdentityMappings(String kind, org.bonitasoft.engine.persistence.QueryOptions searchOptions, String querySuffix) Get total number of externalIdentityMappings for specific kind according to the queryOptions.
long	getNumberOfExternalIdentityMappingsForUser(String kind, long userId, String externalId, org.bonitasoft.engine.persistence.QueryOptions searchOptions, String querySuffix) Get total number of SExternalIdentityMapping objects associated with the specified externalId and kind for the specific user.
List<SExternalIdentityMapping>	searchExternalIdentityMappings(String kind, org.bonitasoft.engine.persistence.QueryOptions queryOptions, String querySuffix) Get all externalIdentityMappings for specific kind according to the queryOptions.
List<SExternalIdentityMapping>	searchExternalIdentityMappings(String kind, String externalId, org.bonitasoft.engine.persistence.QueryOptions queryOptions) Search all SExternalIdentityMapping objects associated with the specified externalId and kind.
List<SExternalIdentityMapping>	searchExternalIdentityMappingsForUser(String kind, long userId, String externalId, org.bonitasoft.engine.persistence.QueryOptions queryOptions, String querySuffix) Search all SExternalIdentityMapping objects associated with the specified externalId and kind for the specific user.

Method Detail

createExternalIdentityMapping

SExternalIdentityMapping createExternalIdentityMapping(SExternalIdentityMapping externalIdentityMapping)
                                                throws SExternalIdentityMappingAlreadyExistsException,
                                                       SExternalIdentityMappingCreationException

Create externalIdentityMapping in DB for given externalIdentityMapping

Parameters:

externalIdentityMapping - an SExternalIdentityMapping object will be stored in DB

Returns:

the new created SExternalIdentityMapping object

Throws:

SExternalIdentityMappingAlreadyExistsException - error thrown if externalIdentityMapping already exists in DB

SExternalIdentityMappingCreationException

getExternalIdentityMappingById

SExternalIdentityMapping getExternalIdentityMappingById(long mappingId)
                                                 throws SExternalIdentityMappingNotFoundException

Get externalIdentityMapping by its id

Parameters:

mappingId - the identifier of externalIdentityMapping

Returns:

the externalIdentityMapping have id corresponding to the parameter

Throws:

SExternalIdentityMappingNotFoundException - error thrown if no externalIdentityMapping have an id corresponding to the parameter.

getExternalIdentityMappingForUser

SExternalIdentityMapping getExternalIdentityMappingForUser(long mappingId)
                                                    throws SExternalIdentityMappingNotFoundException

Get externalIdentityMapping by its id with displayNamePart having user related informations

Parameters:

mappingId - the identifier of externalIdentityMapping

Returns:

the externalIdentityMapping with displayNamePart having userName informations

Throws:

SExternalIdentityMappingNotFoundException - error thrown if no externalIdentityMapping have an id corresponding to the parameter.

getExternalIdentityMappingForGroup

SExternalIdentityMapping getExternalIdentityMappingForGroup(long mappingId)
                                                     throws SExternalIdentityMappingNotFoundException

Get externalIdentityMapping by its id with displayNamePart having group related informations

Parameters:

mappingId - the identifier of externalIdentityMapping

Returns:

the externalIdentityMapping with displayNamePart having group related informations

Throws:

SExternalIdentityMappingNotFoundException - error thrown if no externalIdentityMapping have an id corresponding to the parameter.

getExternalIdentityMappingForRole

SExternalIdentityMapping getExternalIdentityMappingForRole(long mappingId)
                                                    throws SExternalIdentityMappingNotFoundException

Get externalIdentityMapping by its id with displayNamePart having role related informations

Parameters:

mappingId - the identifier of externalIdentityMapping

Returns:

the externalIdentityMapping with displayNamePart having role related informations

Throws:

SExternalIdentityMappingNotFoundException - error thrown if no externalIdentityMapping have an id corresponding to the parameter.

getExternalIdentityMappingForRoleAndGroup

SExternalIdentityMapping getExternalIdentityMappingForRoleAndGroup(long mappingId)
                                                            throws SExternalIdentityMappingNotFoundException

Get externalIdentityMapping by its id with displayNamePart having role and group related informations

Parameters:

mappingId - the identifier of externalIdentityMapping

Returns:

the externalIdentityMapping with displayNamePart having role and group related informations

Throws:

SExternalIdentityMappingNotFoundException - error thrown if no externalIdentityMapping have an id corresponding to the parameter.

deleteExternalIdentityMapping

void deleteExternalIdentityMapping(long mappingId)
                            throws SExternalIdentityMappingNotFoundException,
                                   SExternalIdentityMappingDeletionException

Delete the id specified externalIdentityMapping

Parameters:

mappingId - the identifier of externalIdentityMapping

Throws:

SExternalIdentityMappingNotFoundException - error thrown if no externalIdentityMapping have an id corresponding to the parameter.

SExternalIdentityMappingDeletionException

deleteExternalIdentityMapping

void deleteExternalIdentityMapping(SExternalIdentityMapping externalIdentityMapping)
                            throws SExternalIdentityMappingDeletionException

Delete the specific externalIdentityMapping

Parameters:

externalIdentityMapping - the externalIdentityMapping will be deleted

Throws:

SExternalIdentityMappingDeletionException

deleteAllExternalIdentityMappings

void deleteAllExternalIdentityMappings()
                                throws SExternalIdentityMappingDeletionException

Delete all external identity mapping for the connected tenant

Throws:

SExternalIdentityMappingDeletionException

Since:

6.1

searchExternalIdentityMappings

List<SExternalIdentityMapping> searchExternalIdentityMappings(String kind,
                                                              org.bonitasoft.engine.persistence.QueryOptions queryOptions,
                                                              String querySuffix)
                                                       throws org.bonitasoft.engine.persistence.SBonitaReadException

Get all externalIdentityMappings for specific kind according to the queryOptions. use querySuffix to indicate what the displayNamePart is related to

Parameters:

kind - the discriminator of the SExternalIdentityMapping to search for.

queryOptions - a QueryOptions object containing some query conditions

querySuffix - The query suffix, it can be "USER", "GROUP", "ROLE", "MEMBERSHIP";

Returns:

a list of SExternalIdentityMapping objects matching the criteria.

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfExternalIdentityMappings

long getNumberOfExternalIdentityMappings(String kind,
                                         org.bonitasoft.engine.persistence.QueryOptions searchOptions,
                                         String querySuffix)
                                  throws org.bonitasoft.engine.persistence.SBonitaReadException

Get total number of externalIdentityMappings for specific kind according to the queryOptions.

Parameters:

kind - the discriminator of the SExternalIdentityMapping to search for.

searchOptions - a QueryOptions object containing some query conditions

querySuffix - the query suffix, it can be "USER", "GROUP", "ROLE", "MEMBERSHIP";

Returns:

number of externalIdentityMappings matching the criteria.

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

searchExternalIdentityMappingsForUser

List<SExternalIdentityMapping> searchExternalIdentityMappingsForUser(String kind,
                                                                     long userId,
                                                                     String externalId,
                                                                     org.bonitasoft.engine.persistence.QueryOptions queryOptions,
                                                                     String querySuffix)
                                                              throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all SExternalIdentityMapping objects associated with the specified externalId and kind for the specific user. Use querySuffix to indicate what the displayNamePart is related to

Parameters:

kind - the discriminator of the SExternalIdentityMapping to search for.

userId - The identifier of user

externalId - the external Id identifying the SExternalIdentityMappings to search.

queryOptions - a QueryOptions object containing some query conditions

querySuffix - the query suffix, it can be "USER", "GROUP", "ROLE", "MEMBERSHIP";

Returns:

the list of results matching the criteria.

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfExternalIdentityMappingsForUser

long getNumberOfExternalIdentityMappingsForUser(String kind,
                                                long userId,
                                                String externalId,
                                                org.bonitasoft.engine.persistence.QueryOptions searchOptions,
                                                String querySuffix)
                                         throws org.bonitasoft.engine.persistence.SBonitaReadException

Get total number of SExternalIdentityMapping objects associated with the specified externalId and kind for the specific user. Use querySuffix to indicate what the displayNamePart is related to

Parameters:

kind - the discriminator of the SExternalIdentityMapping to search for.

userId - The identifier of user

externalId - the external Id identifying the SExternalIdentityMappings to search.

searchOptions - a QueryOptions object containing some query conditions

querySuffix - the query suffix, it can be "USER", "GROUP", "ROLE", "MEMBERSHIP";

Returns:

the number of externalIdentityMappings matching the criteria.

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

searchExternalIdentityMappings

List<SExternalIdentityMapping> searchExternalIdentityMappings(String kind,
                                                              String externalId,
                                                              org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                       throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all SExternalIdentityMapping objects associated with the specified externalId and kind.

Parameters:

kind - the discriminator of the SExternalIdentityMapping to search for.

externalId - the external Id identifying the SExternalIdentityMappings to search.

queryOptions - a QueryOptions object containing some query conditions

Returns:

the list of results matching the criteria.

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException - in case of search error.

getExternalIdentityMappingById

SExternalIdentityMapping getExternalIdentityMappingById(long mappingId,
                                                        String suffix,
                                                        String messageSuffix)
                                                 throws SExternalIdentityMappingNotFoundException

Parameters:

mappingId -

suffix - the query suffix to specify (ForUser, ForGroup, ...)

messageSuffix -

Returns:

Throws:

SExternalIdentityMappingNotFoundException