Получить письмо (Java)

Контекст

Контекст для работы с почтовым сервером.

Контекст

Да

Папка с письмами

Папка, в которой нужно искать письма на почте. Значение по умолчанию – «Входящие». Если выбрано «Пользовательская папка», необходимо заполнить соответствующее поле. При работе с протоколом POP3 параметр игнорируется, поиск писем происходит только в системной папке с входящими письмами.

• Выпадающий список со значениями:
  • Все
  • Входящие
  • Черновики
  • Спам
  • Отмеченные
  • Важные
  • Отправленные
  • Удалённые
  • Пользовательская папка 
• Если выбрано "Все", то поиск писем производится во всех папках почты.
• Если выбрано "Пользовательская папка", нужно указать название искомой папки в поле "Пользовательская папка".

Строка

Нет

Пользовательская папка

Название папки, в которой нужно искать письма на почте. Нужно указывать то название, которое используется на сервере почты. Чтобы указать более одной папки, используйте «|». При работе с протоколом POP3 параметр игнорируется, поиск писем происходит только в системной папке с входящими письмами. 

• Чтобы параметр был учтен при поиске, в поле "Папка с письмами" нужно выбрать "Пользовательская папка". Иначе параметр будет проигнорирован.
• Название папок не чувствительно к регистру.
• С помощью параметра можно искать и системные папки, и те, что создал сам пользователь (см. подробнее в требованиях ниже под таблицей). 

Строка

Нет

Адрес отправителя письма. Может быть указан в виде регулярного выражения. Чтобы указать более одного отправителя, используйте «;» или «,».

Строка

Нет

Кому

Адрес получателя письма. Может быть указан в виде регулярного выражения. Чтобы указать более одного получателя, используйте «;» или «,».

Строка

Нет

Копия

Адрес получателя копии письма. Может быть указан в виде регулярного выражения. Чтобы указать более одного отправителя, используйте «;» или «,».

Строка

Нет

Тема

Тема письма. Может быть указана в виде регулярного выражения. 

Строка

Нет

Тело письма

Текст письма. Может быть указан в виде регулярного выражения. 

Строка

Нет

Название вложения

Название вложения в письме. Может быть указано в виде регулярного выражения. 

Строка

Нет

Непрочитанные

Если значение «true», то письма будут выбираться только среди непрочитанных, иначе – будут рассмотрены все полученные письма.

Логический

Нет

Количество

Количество писем, которое необходимо прочитать из почтового ящика по указанным фильтрам.

Число

Нет

Папка для вложений

Путь к папке, в которой будут созданы подпапки для сохранения вложений из писем.

Путь к папке

Нет

Включить html текст

Если значение «true», то в теле письма будет указана полная информация о стилях, иначе – будет получен только текст письма.

Логический

Нет

Поиск по шаблону

Если значение «true», то значения параметров будут считаться регулярными выражениями. Если значение «false», значения параметров будут восприниматься как обычный текст, и при подключении с протоколом IMAP увеличится скорость поиска писем.

Логический

Сохранить изображения

Если значение «true», то изображения из тела письма будут сохранены, иначе – сохранены не будут. Для сохранения также необходимо заполнить поле «Папка для вложений».

Изображения сохраняются в "Папку для вложений" в подпапку, созданную для каждого письма.

Если отмечен чекбокс "Сохранить изображения", но не заполнена "Папка для вложений", будет вызвана ошибка. 

Фильтр по дате получения письма. Будут выбраны только те письма, которые были получены, начина с указанной даты.

• Если не заполнены параметры "Начиная с даты" и "Заканчивая датой", то поиск будет среди всех писем без учета даты их получения (но с учетом др. указанных фильтров).
• Поиск будет только среди тех писем, которые были получены в диапазоне:
  • от даты\времени из поля "Начиная с даты" и до даты\времени из поля "Заканчивая датой" включительно, если заполнены оба параметра.
  • от даты\времени из поля "Начиная с даты" и до текущей даты\времени, если заполнено только поле "Начиная с даты".
  • от начала списка сообщений (даты\времени получения самого старого письма) до даты\времени из поля "Заканчивая датой", если заполнено только поле "Заканчивая датой".
• Если по указанному промежутку времени не найдено сообщений, то возвращается пустая таблица.

Фильтр по дате получения письма. Будут выбраны только те письма, которые были получены до указанной даты включительно.

Аналогично параметру «Начиная с даты». 

Таблица результатов

Полученные письма

Таблица, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Таблица имеет следующий набор столбцов:

• Id - идентификатор письма
• From - почтовый адрес отправителя
• To - почтовые адреса всех основных получателей
• CC - почтовые адреса всех получателей копии письма
• Subject - тема письма
• Body - тело письма
• Path - путь до сформированной подпапки, в которую были сохранены файлы вложений
• DateTime – дата и время получения письма

Количество писем

Количество найденных писем.