org.apache.james.mailrepository.javamail
Interface UIDPlusFolder

All Superinterfaces:

FolderInterface, javax.mail.UIDFolder

All Known Implementing Classes:

UIDPlusFolderAdapter

public interface UIDPlusFolder
extends javax.mail.UIDFolder, FolderInterface

Interim interface to provide access to UID PLUS methods reflecting RFC 2359, until official Javamail API offers this.

Nested Class Summary

Nested classes/interfaces inherited from interface javax.mail.UIDFolder

javax.mail.UIDFolder.FetchProfileItem

Field Summary

Fields inherited from interface javax.mail.UIDFolder

LASTUID

Method Summary

javax.mail.Message[]	addMessages(javax.mail.Message[] msgs) Appends the given messages to the folder and returns corresponding instances of the appended messages. Implementations may require the folder to be open.
long[]	addUIDMessages(javax.mail.Message[] msgs) Appends the given messages to the folder and returns corresponding uids. Implementations may require the folder to be open.

Methods inherited from interface javax.mail.UIDFolder

getMessageByUID, getMessagesByUID, getMessagesByUID, getUID, getUIDValidity

Methods inherited from interface org.apache.james.mailrepository.javamail.FolderInterface

appendMessages, close, create, delete, exists, expunge, getFullName, getMessage, getMessageCount, getMessages, getName, getNewMessageCount, getPermanentFlags, getType, getUnreadMessageCount, isOpen, list, open, renameTo

Method Detail

addUIDMessages

long[] addUIDMessages(javax.mail.Message[] msgs)
                      throws javax.mail.MessagingException

Appends the given messages to the folder and returns corresponding uids.
Implementations may require the folder to be open.

Parameters:

msgs - messages to append

Returns:

array of same size and sequenze of msgs containing corresponding uids or -1, if something went wrong

Throws:

javax.mail.MessagingException

java.lang.IllegalStateException - when folder has to be open

See Also:

Folder.appendMessages(javax.mail.Message[])

addMessages

javax.mail.Message[] addMessages(javax.mail.Message[] msgs)
                                 throws javax.mail.MessagingException

Appends the given messages to the folder and returns corresponding instances of the appended messages.
Implementations may require the folder to be open.

Parameters:

msgs - messages to append

Returns:

array of same size and sequenze of msgs containing corresponding added messages or null, if something went wrong

Throws:

javax.mail.MessagingException

java.lang.IllegalStateException - when folder has to be open

See Also:

Folder.appendMessages(javax.mail.Message[])