com.atlassian.crowd.directory.rest.mapper

Class AzureAdRestEntityMapper

java.lang.Object

com.atlassian.crowd.directory.rest.mapper.AzureAdRestEntityMapper

public class AzureAdRestEntityMapper
extends Object

Maps REST entities returned from Microsoft Graph to Crowd entities and vice versa

Constructor Summary

Constructors

Constructor and Description
AzureAdRestEntityMapper()

Method Summary

Modifier and Type	Method and Description
GroupWithMembershipChanges	mapDeltaQueryGroup(GraphDeltaQueryGroup graphGroup, long directoryId) Maps a group obtained from the Azure AD groups endpoint to a Crowd object
DeltaQueryResult<GroupWithMembershipChanges>	mapDeltaQueryGroups(GraphDeltaQueryResult<GraphDeltaQueryGroup> graphGroups, long directoryId) Maps a delta query result for groups to a result suitable for incremental synchronisation.
DeltaQueryResult<UserWithAttributes>	mapDeltaQueryUsers(GraphDeltaQueryResult<GraphDeltaQueryUser> graphUsersList, long directoryId) Maps a delta query result for users to a result suitable for incremental synchronisation.
<T> T	mapDirectoryObject(DirectoryObject directoryObject, Class<T> returnType, long directoryId) Maps an AzureAD directory object to a Crowd object.
<T> List<T>	mapDirectoryObjects(Collection<DirectoryObject> directoryObjects, Class<T> returnType, long directoryId) Maps a collection of directory objects to Crowd objects.
<T> List<T>	mapDirectoryObjects(GraphDirectoryObjectList directoryObjectList, Class<T> returnType, long directoryId) Maps a directory objects response from Azure AD.
<T> T	mapGroup(GraphGroup graphGroup, Class<T> returnType, long directoryId) Maps a group obtained from the Azure AD groups endpoint to a Crowd object
<T> List<T>	mapGroups(Collection<GraphGroup> graphGroups, Class<T> returnType, long directoryId) Maps a collection of Azure AD groups to Crowd groups.
<T> List<T>	mapGroups(GraphGroupList graphGroupList, Class<T> returnType, long directoryId) Maps a groups response from Azure AD to Crowd groups.
<T> T	mapUser(GraphUser graphUser, Class<T> returnType, long directoryId) Maps a user obtained from the Azure AD users endpoint to a Crowd object
<T> List<T>	mapUsers(Collection<GraphUser> graphUsersList, Class<T> returnType, long directoryId) Maps a collection of Azure AD users to Crowd users.
<T> List<T>	mapUsers(GraphUsersList graphUsersList, Class<T> returnType, long directoryId) Maps a users response from Azure AD to Crowd users.

Methods inherited from class java.lang.Object

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

Constructor Detail

AzureAdRestEntityMapper

public AzureAdRestEntityMapper()

Method Detail

mapUsers

public <T> List<T> mapUsers(GraphUsersList graphUsersList,
                            Class<T> returnType,
                            long directoryId)

Maps a users response from Azure AD to Crowd users.

Parameters:

graphUsersList - the response from Azure AD

returnType - the desired return type

directoryId - the id of the Crowd directory

Returns:

a list of mapped Crowd users

mapUsers

public <T> List<T> mapUsers(Collection<GraphUser> graphUsersList,
                            Class<T> returnType,
                            long directoryId)

Maps a collection of Azure AD users to Crowd users.

Parameters:

graphUsersList - the users to map

returnType - the desired return type

directoryId - the id of the Crowd directory

Returns:

a list of mapped Crowd users

mapDeltaQueryUsers

public DeltaQueryResult<UserWithAttributes> mapDeltaQueryUsers(GraphDeltaQueryResult<GraphDeltaQueryUser> graphUsersList,
                                                               long directoryId)

Maps a delta query result for users to a result suitable for incremental synchronisation.

Parameters:

graphUsersList - the users to map

directoryId - the id of the Crowd directory

Returns:

a list of mapped new users, ids of deleted users and a token suitable for change tracking

mapUser

public <T> T mapUser(GraphUser graphUser,
                     Class<T> returnType,
                     long directoryId)

Maps a user obtained from the Azure AD users endpoint to a Crowd object

Parameters:

graphUser - the user obtained from Azure AD

returnType - the desired return type

directoryId - the id of the Crowd directory

Returns:

the mapped Crowd user

mapGroups

public <T> List<T> mapGroups(GraphGroupList graphGroupList,
                             Class<T> returnType,
                             long directoryId)

Maps a groups response from Azure AD to Crowd groups.

Parameters:

graphGroupList - the response from Azure AD

returnType - the desired return type

directoryId - the id of the Crowd directory

Returns:

a list of mapped Crowd groups

mapGroups

public <T> List<T> mapGroups(Collection<GraphGroup> graphGroups,
                             Class<T> returnType,
                             long directoryId)

Maps a collection of Azure AD groups to Crowd groups.

Parameters:

graphGroups - the groups to map

returnType - the desired return type

directoryId - the id of the Crowd directory

Returns:

a list of mapped Crowd groups

mapDeltaQueryGroups

public DeltaQueryResult<GroupWithMembershipChanges> mapDeltaQueryGroups(GraphDeltaQueryResult<GraphDeltaQueryGroup> graphGroups,
                                                                        long directoryId)

Maps a delta query result for groups to a result suitable for incremental synchronisation.

Parameters:

graphGroups - the groups to map

directoryId - the id of the Crowd directory

Returns:

a list of mapped new groups, ids of deleted groups and a token suitable for change tracking

mapDirectoryObjects

public <T> List<T> mapDirectoryObjects(GraphDirectoryObjectList directoryObjectList,
                                       Class<T> returnType,
                                       long directoryId)

Maps a directory objects response from Azure AD. The objects in the response should be of one type (groups or users)

Parameters:

directoryObjectList - the directory objects response from Azure AD

returnType - the desired return type

directoryId - the id of the Crowd directory

Returns:

a list of mapped Crowd objects

mapDirectoryObjects

public <T> List<T> mapDirectoryObjects(Collection<DirectoryObject> directoryObjects,
                                       Class<T> returnType,
                                       long directoryId)

Maps a collection of directory objects to Crowd objects. The objects should be filtered by type (groups or users)

Parameters:

directoryObjects - the directory objects to map

returnType - the desired return type

directoryId - the id of the Crowd directory

Returns:

a list of mapped Crowd objects

mapGroup

public <T> T mapGroup(GraphGroup graphGroup,
                      Class<T> returnType,
                      long directoryId)

Maps a group obtained from the Azure AD groups endpoint to a Crowd object

Parameters:

graphGroup - the group obtained from Azure AD

returnType - the desired return type

directoryId - the id of the Crowd directory

Returns:

the mapped Crowd group

mapDeltaQueryGroup

public GroupWithMembershipChanges mapDeltaQueryGroup(GraphDeltaQueryGroup graphGroup,
                                                     long directoryId)

Maps a group obtained from the Azure AD groups endpoint to a Crowd object

Parameters:

graphGroup - the group obtained from Azure AD

directoryId - the id of the Crowd directory

Returns:

the mapped Crowd group

mapDirectoryObject

public <T> T mapDirectoryObject(DirectoryObject directoryObject,
                                Class<T> returnType,
                                long directoryId)

Maps an AzureAD directory object to a Crowd object. The directory object must be of a concrete type

Parameters:

directoryObject - the result from Azure AD

returnType - the desired return type

directoryId - the id of the Crowd directory

Returns:

the mapped Crowd object

Throws:

IllegalArgumentException - when the directoryObject is a generic DirectoryObject instance