Package com.atlassian.confluence.mail.template

Class MailNotificationQueueItem

java.lang.Object

com.atlassian.confluence.mail.template.AbstractMailNotificationQueueItem

com.atlassian.confluence.mail.template.MailNotificationQueueItem

All Implemented Interfaces:

com.atlassian.core.task.Task, com.atlassian.mail.queue.MailQueueItem, Serializable, Comparable<com.atlassian.mail.queue.MailQueueItem>

Direct Known Subclasses:

PreRenderedMailNotificationQueueItem

@Deprecated(forRemoval=true,
            since="9.4")
public class MailNotificationQueueItem
extends AbstractMailNotificationQueueItem

Deprecated, for removal: This API element is subject to removal in a future version.

since 9.4

Handles mail notifications to Confluence users

See Also:

• DispatchService
• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.atlassian.confluence.mail.template.AbstractMailNotificationQueueItem

AbstractMailNotificationQueueItem.EncodeUtil

Field Summary

Fields

Modifier and Type	Field	Description
static final String	TEMPLATES_LOCATION	Deprecated. since 5.2, use #getDefaultTemplateLocation(String)

Fields inherited from class com.atlassian.confluence.mail.template.AbstractMailNotificationQueueItem

body, dateQueued, MIME_TYPE_HTML, MIME_TYPE_TEXT

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	MailNotificationQueueItem(com.atlassian.user.User user, String templateContent, String subject)	Deprecated, for removal: This API element is subject to removal in a future version.
protected	MailNotificationQueueItem(com.atlassian.user.User user, String templateLocation, String templateFileName, String subject)	Deprecated, for removal: This API element is subject to removal in a future version.

Method Summary

Modifier and Type	Method	Description
static MailNotificationQueueItem	createFromTemplateContent(com.atlassian.user.User user, String templateContent, String subject)	Deprecated, for removal: This API element is subject to removal in a future version.
static MailNotificationQueueItem	createFromTemplateFile(com.atlassian.user.User user, String templateFileName, String subject)	Deprecated, for removal: This API element is subject to removal in a future version.
static MailNotificationQueueItem	createFromTemplateFileAndLocation(com.atlassian.user.User user, String templateLocation, String templateFileName, String subject)	Deprecated, for removal: This API element is subject to removal in a future version.
protected com.atlassian.mail.Email	createMailObject()	Deprecated, for removal: This API element is subject to removal in a future version.
protected static String	getDefaultTemplateLocation(@Nullable com.atlassian.user.User user, @Nullable String templateFileName)	Deprecated, for removal: This API element is subject to removal in a future version. Returns the default location for the given user and template name.
protected String	getMimeType()	Deprecated, for removal: This API element is subject to removal in a future version.
protected static String	getMimeTypeForUser(com.atlassian.user.User user)	Deprecated, for removal: This API element is subject to removal in a future version. TODO: CONFDEV-3278
static UserAccessor	getUserAccessor()	Deprecated. since 8.7, use component injection

Methods inherited from class com.atlassian.confluence.mail.template.AbstractMailNotificationQueueItem

addUtilsToContext, addVelocityContextParam, clearContext, compareTo, execute, getBody, getDateQueued, getLastError, getRenderedContent, getRenderedContent, getSendCount, getSubject, getTemplateContent, getTemplateFileName, getTemplateLocation, getVelocityContextParam, hasError, incrementSendCount, isRecognisedMimeType, preRenderBody, removeVelocityContextParam, renderTemplate, retrieveMailServer, send, setBody, setLastError, setSubject, setTemplateContent, setTemplateFileName, setTemplateLocation, transformForEmail

Methods inherited from class java.lang.Object

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

Field Details

TEMPLATES_LOCATION

public static final String TEMPLATES_LOCATION

Deprecated.

since 5.2, use #getDefaultTemplateLocation(String)

See Also:

• Constant Field Values

Constructor Details

MailNotificationQueueItem

protected MailNotificationQueueItem(com.atlassian.user.User user,
 String templateLocation,
 String templateFileName,
 String subject)

Deprecated, for removal: This API element is subject to removal in a future version.

MailNotificationQueueItem

protected MailNotificationQueueItem(com.atlassian.user.User user,
 String templateContent,
 String subject)

Deprecated, for removal: This API element is subject to removal in a future version.

Method Details

createFromTemplateFile

public static MailNotificationQueueItem createFromTemplateFile(com.atlassian.user.User user,
 String templateFileName,
 String subject)

Deprecated, for removal: This API element is subject to removal in a future version.

createFromTemplateFileAndLocation

public static MailNotificationQueueItem createFromTemplateFileAndLocation(com.atlassian.user.User user,
 String templateLocation,
 String templateFileName,
 String subject)

Deprecated, for removal: This API element is subject to removal in a future version.

createFromTemplateContent

public static MailNotificationQueueItem createFromTemplateContent(com.atlassian.user.User user,
 String templateContent,
 String subject)

Deprecated, for removal: This API element is subject to removal in a future version.

getMimeType

protected String getMimeType()

Deprecated, for removal: This API element is subject to removal in a future version.

createMailObject

protected com.atlassian.mail.Email createMailObject()

Deprecated, for removal: This API element is subject to removal in a future version.

Specified by:

createMailObject in class AbstractMailNotificationQueueItem

getMimeTypeForUser

protected static String getMimeTypeForUser(com.atlassian.user.User user)

Deprecated, for removal: This API element is subject to removal in a future version.

TODO: CONFDEV-3278

With the switch to XHTML from wiki markup, we no longer support TEXT or HTML selection. It is always HTML, but some day we might want to add support for something else, so keep the structure for selection in place, but just hidden.

Parameters:

user - The user to check

Returns:

the user's preferred format for email notifications

getDefaultTemplateLocation

protected static String getDefaultTemplateLocation(@Nullable com.atlassian.user.User user,
 @Nullable String templateFileName)

Deprecated, for removal: This API element is subject to removal in a future version.

Returns the default location for the given user and template name.

If a template name ends with .vm indicating a Velocity template, a path relative to the webapp context is returned. In any other case, a completeKey pointing to a web resource is returned.

Parameters:

user - the name of the user for which the default location should be retrieved, currently not used

templateFileName - the name of the template for which the default location should be retrieved

Returns:

the default template location

getUserAccessor

@Deprecated
public static UserAccessor getUserAccessor()

Deprecated.

since 8.7, use component injection