com.atlassian.jira.service.util.handler

Class MessageUserProcessorImpl

java.lang.Object

com.atlassian.jira.service.util.handler.MessageUserProcessorImpl

All Implemented Interfaces:

MessageUserProcessor

@Internal
public class MessageUserProcessorImpl
extends Object
implements MessageUserProcessor

Since:

v5.0

Constructor Summary

Constructors

Constructor and Description
MessageUserProcessorImpl(UserManager userManager, UserSearchService userSearchService)

Method Summary

Modifier and Type	Method and Description
ApplicationUser	findUserByEmail(String emailAddress) Returns the first User found with an email address that equals the given emailAddress case insensitively.
ApplicationUser	findUserByUsername(String username) Finds the user with the given username or returns null if there is no such User.
ApplicationUser	getAuthorFromSender(javax.mail.Message message) For each sender of the given message in turn, look up a User first with a case-insensitively equal email address, and failing that, with a username equal to the email address.

Methods inherited from class java.lang.Object

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

Constructor Detail

MessageUserProcessorImpl

public MessageUserProcessorImpl(UserManager userManager,
                                UserSearchService userSearchService)

Method Detail

getAuthorFromSender

@Nullable
public ApplicationUser getAuthorFromSender(javax.mail.Message message)
                                              throws javax.mail.MessagingException

For each sender of the given message in turn, look up a User first with a case-insensitively equal email address, and failing that, with a username equal to the email address.

JIRA wants to do this because when we create users in email handlers, we set email and username equal. If a user subsequently changes their email address, we must not assume they don't exist and create them with the email address as the username.

Specified by:

getAuthorFromSender in interface MessageUserProcessor

Parameters:

message - the message from which to get the User.

Returns:

the User matching the sender of the message or null if none found.

Throws:

javax.mail.MessagingException - if there's strife getting the message sender.

findUserByUsername

@Nullable
public ApplicationUser findUserByUsername(String username)

Finds the user with the given username or returns null if there is no such User. Convenience method which doesn't throw up.

Specified by:

findUserByUsername in interface MessageUserProcessor

Parameters:

username - the username.

Returns:

the User or null.

findUserByEmail

@Nullable
public ApplicationUser findUserByEmail(String emailAddress)

Returns the first User found with an email address that equals the given emailAddress case insensitively.

Specified by:

findUserByEmail in interface MessageUserProcessor

Parameters:

emailAddress - the email address to match.

Returns:

the User.