The common process for receiving emails has the following steps:
- Retrieve a set of messages from the server.
- Process the returned set of messages.
- Delete all or some messages, or move them to a specific folder.
Anchor |
---|
| folder_handling |
---|
| folder_handling |
---|
|
Info |
---|
|
Multiexcerpt include |
---|
MultiExcerptName | folder_handling |
---|
PageWithExcerpt | JavaMail |
---|
|
|
Anchor |
---|
| retrieving_messages |
---|
| retrieving_messages |
---|
|
Step 1: Retrieving Messages
You can retrieve messages using one of
- readMessages
- readMessagesFiltered
Both return an Array of ReceivedMail (see Processing Messages further below).
Image Modified | Image Modified |
Operations
readMessages
Multiexcerpt include |
---|
MultiExcerptName | readMessages |
---|
PageWithExcerpt | JavaMail |
---|
|
readMessagesFiltered
Multiexcerpt include |
---|
MultiExcerptName | readMessagesFiltered |
---|
PageWithExcerpt | JavaMail |
---|
|
Types
ReadFlags
Multiexcerpt include |
---|
MultiExcerptName | ReadFlags |
---|
PageWithExcerpt | JavaMail |
---|
|
Filter
Multiexcerpt include |
---|
MultiExcerptName | Filter |
---|
PageWithExcerpt | JavaMail |
---|
|
Anchor |
---|
| processing_messages |
---|
| processing_messages |
---|
|
Step 2: Processing Messages
You can process emails as you need. Retrieved messages are delivered as an Array of ReceivedMail objects, which inherit from Mail and add some more attributes available after receiving:
Image Modified
Classes
ReceivedMail
Multiexcerpt include |
---|
MultiExcerptName | ReceivedMail |
---|
PageWithExcerpt | JavaMail |
---|
|
Attachment
Multiexcerpt include |
---|
MultiExcerptName | Attachment |
---|
PageWithExcerpt | JavaMail |
---|
|
Anchor |
---|
| moving_messages |
---|
| moving_messages |
---|
|
Step 3: Deleting/Moving Messages
After messages have been retrieved, they are often deleted or moved to a specific folder.
Image Modified
Deleting Messages
Deleting messages is done by any one of the following operations:
- deleteMessage
- deleteMessages
- deleteMessagesFiltered
deleteMessage and deleteMessages operate on an instance of ReceivedMail, means you can call them on objects returned by a read on the mailbox. deleteMessagesFiltered operates on a folder and a filter criterion. It deletes all matching messages.
Note |
---|
|
Deletion is always "hard" deletion. Mail items are not moved to "Trash" or "Deleted Items". Once deleted, the message is gone. |
deleteMessage
Multiexcerpt include |
---|
MultiExcerptName | deleteMessage |
---|
PageWithExcerpt | JavaMail |
---|
|
deleteMessages
Multiexcerpt include |
---|
MultiExcerptName | deleteMessages |
---|
PageWithExcerpt | JavaMail |
---|
|
deleteMessagesFiltered
Multiexcerpt include |
---|
MultiExcerptName | deleteMessagesFiltered |
---|
PageWithExcerpt | JavaMail |
---|
|
Moving Messages
Moving messages operates in instances of ReceivedMail, objects returned by a read on the mailbox. You can specify the target folder to move the message to.
Multiexcerpt include |
---|
MultiExcerptName | moveMessage |
---|
PageWithExcerpt | JavaMail |
---|
|