com.atlassian.crowd.manager.application
Interface AliasManager

public interface AliasManager

API to manage application-specific user aliases.

Method Summary

java.lang.String	findAliasByUsername(Application application, java.lang.String username) Will return the 'alias' associated to the user.
java.lang.String	findUsernameByAlias(Application application, java.lang.String authenticatingUsername) Will return the 'real' username of the authenticating user.
void	removeAlias(Application application, java.lang.String username) Remove an application-specific alias for a username.
java.util.List<java.lang.String>	search(EntityQuery entityQuery) Perform an AliasQuery search on the alias tables of Crowd.
void	storeAlias(Application application, java.lang.String username, java.lang.String alias) Add or update the application-specific alias for a username.

Method Detail

findUsernameByAlias

java.lang.String findUsernameByAlias(Application application,
                                     java.lang.String authenticatingUsername)

Will return the 'real' username of the authenticating user. This returned username maybe the username passed in, if the user does not have a configured 'alias' for the given application

Parameters:

application - the application the user is associated with

authenticatingUsername - the username passed to the application for authentication

Returns:

The 'real' username of the authenticating user, or the passed in username

Throws:

java.lang.IllegalArgumentException - if either application or authenticatingUsername are null

findAliasByUsername

java.lang.String findAliasByUsername(Application application,
                                     java.lang.String username)

Will return the 'alias' associated to the user. If an alias does not exist the 'real' username will be returned

Parameters:

application - the application the user is associated with

username - the 'real' username of the user

Returns:

if an alias exists it will be returned, otherwise the username will be returned.

Throws:

java.lang.IllegalArgumentException - if either application or authenticatingUsername are null

search

java.util.List<java.lang.String> search(EntityQuery entityQuery)

Perform an AliasQuery search on the alias tables of Crowd.

Parameters:

entityQuery - Will accept an entity query for aliases as an AliasQuery

Returns:

a java.util.List of usernames for a given AliasQuery or an empty list

storeAlias

void storeAlias(Application application,
                java.lang.String username,
                java.lang.String alias)
                throws AliasAlreadyInUseException

Add or update the application-specific alias for a username.

Parameters:

application - application context.

username - real username of user in directory.

alias - application-specific alias (cannot be null or blank).

Throws:

java.lang.IllegalArgumentException - if parameters are null or blank.

AliasAlreadyInUseException - the alias is already in use by another user for the given application.

removeAlias

void removeAlias(Application application,
                 java.lang.String username)
                 throws AliasAlreadyInUseException

Remove an application-specific alias for a username. This method will silently succeed if the username has no application-specific alias.

Parameters:

application - application context.

username - real username of user in directory.

Throws:

AliasAlreadyInUseException - the username is already in use by another user as their alias for the given application.