Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Otp |
---|
Methods for reading of email messages are provided by the ReadMessages class. You can:
- read messages matching retrieval constraints (time window, subject line, unread, etc)
- read all messages from the inbox folder
- read specific messages from the inbox folder by message id
- read messages from arbitrary folders
- read specific messages from arbitrary folders by message id
Note that it is formally not guaranteed for message ids to be unique, not even within one folder. Therefore retrieval by id always returns an array of objects (which will most likely hold one element only).
Figure: The ReadMessages Class
Image Modified
All methods of this class return an array of objects of class Mail, which extends MailEnvelope and retrieves headers, content, and (multipart) attachments in addition.
Figure: The Mail Class
Image Modified
Reading All Messages From the Inbox
The following diagram demonstrates how to read all emails from the inbox:
Image Modified
Parameters of method readMessages in detail:
Name | Type | Direction | Description | |||||
---|---|---|---|---|---|---|---|---|
connection | MailConnection | In |
| |||||
deleteOnServer | Boolean | In |
| |||||
return | Array of Mail | Return |
|
Reading Specific Messages from the Inbox Folder by Id
Email messages can be accessed by their id through the readMessagesById method:
Image Modified
Parameters of method readMessagesById in detail:
Name | Type | Direction | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
connection | MailConnection | In |
| ||||||||
id | String | In | Id of the message. | ||||||||
return | Array of Mail | Return |
|
Reading Messages From Arbitrary Folders
In addition to inbox folder, arbitrary folders on the mail server can be read with the readMessagesByFolder method:
Image Modified
Parameters of method readMessagesByFolder in detail:
Name | Type | Direction | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
connection | MailConnection | In |
| ||||||||
folder | String | In | Name of the folder to read. | ||||||||
deleteOnServer | Boolean | In |
| ||||||||
return | Array of Mail | Return |
|
Reading Specific Messages From Arbitrary Folders by Id
In contrast to reading all messages from a folder, you can access a specific message from a folder by specifying its id and calling the readMessagesByFolderAndId method:
Image Modified
Parameters of method readMessagesByFolderAndId in detail:
Name | Type | Direction | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
connection | MailConnection | In |
| ||||||||
id | String | In | Id of the message. | ||||||||
folder | String | In | Folder, in which the message with the specified id is located. | ||||||||
return | Array of Mail | Return |
|
Reading Specific Messages Using Retrieval Constraints
You can specify which messages to retrieve by providing a constraints object to the readMessagesWithConstraints method:
Image Modified
Parameters of method readMessagesWithConstraints in detail:
Name | Type | Direction | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
connection | MailConnection | In |
| ||||||||
constraints | RetrievalConstraints | In |
| ||||||||
return | Array of Mail | Return |
|
Panel | ||
---|---|---|
| ||
|