com.atlassian.confluence.mail

Interface MailContentManager

All Superinterfaces:

ContentEntityManager

All Known Implementing Classes:

DefaultMailContentManager

Deprecated.

@Deprecated
public interface MailContentManager
extends ContentEntityManager

Deprecated since 4.2. Archived mail is no longer managed using Mail objects, so this entire manager is obsolete. So as not to break binary compatibility, the manager will remain but all get methods will return nothing, and all mutator methods will fail silently.

Field Summary

Fields inherited from interface com.atlassian.confluence.core.ContentEntityManager

ITERATE_ALL

Method Summary

Modifier and Type	Method and Description
int	findMailTotal(Space space) Deprecated.
Mail	getFirstMailAfter(String spaceKey, long mailId) Deprecated.
Mail	getFirstMailBefore(String spaceKey, long mailId) Deprecated.
List<Mail>	getMail(Space space, boolean currentOnly) Deprecated.
Mail	getMailById(long id) Deprecated. Get a mail by its database id.
Mail	getMailByMessageId(String messageId) Deprecated. Get a mail by its message-id.
List	getMailsByMessageId(String messageId) Deprecated. Get all mails with the matching message-id.
List	getSpaceMail(int firstResult, int maxResults, String spaceKey) Deprecated.
Iterator	getSpaceMailIterator(String spaceKey) Deprecated.
Iterator	getSpaceMailWithAttachmentsIterator(String spaceKey) Deprecated.
void	removeAllMail(Space space) Deprecated.
void	removeAttachmentsForMail(Mail mail) Deprecated.
void	removeMail(Mail mail) Deprecated. since 4.1 - does exactly the same thing as ContentEntityManager.removeContentEntity(com.atlassian.confluence.core.ContentEntityObject)
boolean	spaceHasMail(String spaceKey) Deprecated.
Mail	storeIncomingMail(Space space, byte[] rawMessage) Deprecated. Create a new mail content object in the given space for the given raw RFC822 message.
Mail	storeIncomingMail(Space space, javax.mail.internet.MimeMessage mimeMessage) Deprecated. Create a new mail content object in the given space for the given mimeMessage.

Methods inherited from interface com.atlassian.confluence.core.ContentEntityManager

getById, getNextVersion, getOtherVersion, getPageAndBlogPostsVersionsLastEditedByUser, getPreviousVersion, getRecentlyAddedEntities, getRecentlyModifiedEntities, getRecentlyModifiedEntitiesForUser, getRecentlyModifiedForChangeDigest, getVersionHistorySummaries, getVersionsLastEditedByUser, refreshContentEntity, removeContentEntity, removeHistoricalVersion, revertContentEntityBackToVersion, saveContentEntity, saveContentEntity, saveNewVersion, saveNewVersion, updateContentLinkingTo, updateOutgoingLinksInContent, updateSingleContentLinkinTo, updateSingleContentLinkinTo

Method Detail

getMailById

Mail getMailById(long id)

Deprecated.

Get a mail by its database id. If the mail does not exist, null is returned.

getMailByMessageId

Mail getMailByMessageId(String messageId)

Deprecated.

Get a mail by its message-id. If the mail does not exist, or if there are multiple mails with the same message id, null is returned

getMailsByMessageId

List getMailsByMessageId(String messageId)

Deprecated.

Get all mails with the matching message-id. Mostly you won't need to use this, as you'll generally be looking for a single message, message ids are reasonably unique, and the single-mail method is less code.

Parameters:

messageId - the message id of the mails to retrieve

Returns:

a list of all messages matching that ID

storeIncomingMail

Mail storeIncomingMail(Space space,
                       javax.mail.internet.MimeMessage mimeMessage)
                throws ConfluenceException

Deprecated.

Create a new mail content object in the given space for the given mimeMessage. The message should be in the raw form it was received in. All post-arrival munging such as filter application, multipart content decisions and attachment removal happen inside this method

Parameters:

space - the space to attach the message to

mimeMessage - the message that has been received

Throws:

ConfluenceException

storeIncomingMail

Mail storeIncomingMail(Space space,
                       byte[] rawMessage)

Deprecated.

Create a new mail content object in the given space for the given raw RFC822 message. The message should be in the raw form it was received in. All post-arrival munging such as filter application, multipart content decisions and attachment removal happen inside this method

We use a byte array because RFC822 messages are streams of bytes - character encoding happens after the header is parsed

Parameters:

space - the space to attach the message to

rawMessage - the message that has been received

spaceHasMail

boolean spaceHasMail(String spaceKey)

Deprecated.

getFirstMailAfter

Mail getFirstMailAfter(String spaceKey,
                       long mailId)

Deprecated.

getFirstMailBefore

Mail getFirstMailBefore(String spaceKey,
                        long mailId)

Deprecated.

removeMail

@Deprecated
void removeMail(Mail mail)

Deprecated. since 4.1 - does exactly the same thing as ContentEntityManager.removeContentEntity(com.atlassian.confluence.core.ContentEntityObject)

removes mail and its associated attachments

Parameters:

mail - the mail to remove

removeAttachmentsForMail

void removeAttachmentsForMail(Mail mail)

Deprecated.

getSpaceMailIterator

Iterator getSpaceMailIterator(String spaceKey)

Deprecated.

getSpaceMailWithAttachmentsIterator

Iterator getSpaceMailWithAttachmentsIterator(String spaceKey)

Deprecated.

getSpaceMail

List getSpaceMail(int firstResult,
                  int maxResults,
                  String spaceKey)

Deprecated.

findMailTotal

int findMailTotal(Space space)

Deprecated.

getMail

List<Mail> getMail(Space space,
                   boolean currentOnly)

Deprecated.

removeAllMail

void removeAllMail(Space space)

Deprecated.