com.atlassian.jira.mail.util

Class MailAttachmentsManagerImpl

java.lang.Object

com.atlassian.jira.mail.util.MailAttachmentsManagerImpl

All Implemented Interfaces:

MailAttachmentsManager

public class MailAttachmentsManagerImpl
extends Object
implements MailAttachmentsManager

Field Summary

Fields inherited from interface com.atlassian.jira.mail.util.MailAttachmentsManager

CID_PREFIX

Constructor Summary

Constructors

Constructor and Description
MailAttachmentsManagerImpl(AvatarService avatarService, AvatarTranscoder avatarTranscoder, UserManager userManager, AvatarManager avatarManager, ApplicationProperties applicationProperties)

Method Summary

Modifier and Type	Method and Description
String	addAttachmentAndReturnCid(MailAttachment mailAttachment) Adds an attachment to the mail attachments manager's collection of attachments.
Iterable<javax.mail.BodyPart>	buildAttachmentsBodyParts() Builds bodyPart for each image (including avatars) added to this manager
protected String	getAbsoluteUrl(String path)
int	getAttachmentsCount() Returns the number of attachments added to this manager
String	getAvatarUrl(ApplicationUser user) Returns a link to access user avatar in email message.
String	getAvatarUrl(Avatar avatar, Avatar.Size size, String avatarOwnerDescription) Returns a link to access Avatar (icon for project or some other entity in Jira) in email message.
String	getAvatarUrl(String username) Returns a link to access user avatar in email message.
String	getAvatarUrl(TemplateUser templateUser) Returns a link to access user avatar in email message.
String	getExternalImageUrl(String path) If the path is a relative url tries to add the image specified as an attachment.
String	getImageUrl(String path) Tries to add image specified by path to email attachments.
String	getIssueTypeIconUrl(IssueType issueType)
String	inlineImages(String html) Tries to inline all the images specified by an IMG tag.
String	removeBaseUrl(String url) Tries to remove the baseUrl (eg: http://example.com/jira) or the basePath (/jira) from an URL, and return the result.

Methods inherited from class java.lang.Object

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

Constructor Detail

MailAttachmentsManagerImpl

public MailAttachmentsManagerImpl(AvatarService avatarService,
                                  AvatarTranscoder avatarTranscoder,
                                  UserManager userManager,
                                  AvatarManager avatarManager,
                                  ApplicationProperties applicationProperties)

Method Detail

getAvatarUrl

public String getAvatarUrl(String username)

Description copied from interface: MailAttachmentsManager

Returns a link to access user avatar in email message. If avatar can be attached to email, the cid link is returned, otherwise avatar URL is returned and no image is attached. (E.g. If Gravatar is enabled)

Specified by:

getAvatarUrl in interface MailAttachmentsManager

Returns:

cid link or Avatar URL

getAvatarUrl

public String getAvatarUrl(TemplateUser templateUser)

Description copied from interface: MailAttachmentsManager

Returns a link to access user avatar in email message. If avatar can be attached to email, the cid link is returned, otherwise avatar URL is returned and no image is attached. (E.g. If Gravatar is enabled)

Specified by:

getAvatarUrl in interface MailAttachmentsManager

Returns:

cid link or Avatar URL

getAvatarUrl

public String getAvatarUrl(ApplicationUser user)

Description copied from interface: MailAttachmentsManager

Returns a link to access user avatar in email message. If avatar can be attached to email, the cid link is returned, otherwise avatar URL is returned and no image is attached. (E.g. If Gravatar is enabled)

Specified by:

getAvatarUrl in interface MailAttachmentsManager

Returns:

cid link or Avatar URL

getAvatarUrl

public String getAvatarUrl(@Nonnull
                           Avatar avatar,
                           @Nonnull
                           Avatar.Size size,
                           String avatarOwnerDescription)

Description copied from interface: MailAttachmentsManager

Returns a link to access Avatar (icon for project or some other entity in Jira) in email message.

Specified by:

getAvatarUrl in interface MailAttachmentsManager

Parameters:

avatar - Avatar to display in email

size - avatar size

avatarOwnerDescription - Description of avatar

Returns:

cid link

getIssueTypeIconUrl

public String getIssueTypeIconUrl(IssueType issueType)

addAttachmentAndReturnCid

public String addAttachmentAndReturnCid(MailAttachment mailAttachment)

Description copied from interface: MailAttachmentsManager

Adds an attachment to the mail attachments manager's collection of attachments. This collection will eventually be attached to the email. This method will return a CID that can be used to reference the attachment in the body of an email. Given the same mail attachment multiple times, this method will return the same CID.

Specified by:

addAttachmentAndReturnCid in interface MailAttachmentsManager

Returns:

The CID for an attachment

getImageUrl

public String getImageUrl(String path)

Description copied from interface: MailAttachmentsManager

Tries to add image specified by path to email attachments. Returns image cid link if succeeds or unchanged path if specified path cannot be added as attachment

Specified by:

getImageUrl in interface MailAttachmentsManager

Returns:

inlineImages

public String inlineImages(String html)

Description copied from interface: MailAttachmentsManager

Tries to inline all the images specified by an IMG tag. Replaces the image url with the cid link or unchanged path if specified path cannot be added as attachment

Specified by:

inlineImages in interface MailAttachmentsManager

Parameters:

html - HTML to change.

Returns:

The same HTML with the images inlined.

removeBaseUrl

public String removeBaseUrl(String url)

Description copied from interface: MailAttachmentsManager

Tries to remove the baseUrl (eg: http://example.com/jira) or the basePath (/jira) from an URL, and return the result. Some quick examples (let's assume baseUrl = http://example.com/jira)

• http://example.com/jira/images/icon.png --> /images/icon.png
• /jira/images/icon.png --> /images/icon.png
• /images/icon.png --> /images/icon.png
• http://example.com/test/images/icon.png --> http://example.com/test/images/icon.png
• http://google.com/jira/images/icon.png --> http://google.com/jira/images/icon.png

Specified by:

removeBaseUrl in interface MailAttachmentsManager

Parameters:

url - the url to remove the baseUrl from

Returns:

the url without the baseUrl nor the basePath

getExternalImageUrl

public String getExternalImageUrl(String path)

Description copied from interface: MailAttachmentsManager

If the path is a relative url tries to add the image specified as an attachment. Returns a cid link if successful, or unchanged path if not

Specified by:

getExternalImageUrl in interface MailAttachmentsManager

getAbsoluteUrl

protected String getAbsoluteUrl(String path)

getAttachmentsCount

public int getAttachmentsCount()

Description copied from interface: MailAttachmentsManager

Returns the number of attachments added to this manager

Specified by:

getAttachmentsCount in interface MailAttachmentsManager

Returns:

number of attachments

buildAttachmentsBodyParts

public Iterable<javax.mail.BodyPart> buildAttachmentsBodyParts()

Description copied from interface: MailAttachmentsManager

Builds bodyPart for each image (including avatars) added to this manager

Specified by:

buildAttachmentsBodyParts in interface MailAttachmentsManager

Returns:

Added attachments as list of BodyParts