Как отправить email из программы java

35. Java – Отправка Email

Загрузите и разархивируйте эти файлы, во вновь созданных каталогах верхнего уровня вы обнаружите несколько jar-файлов для обоих приложений. Вам необходимо добавить файлы mail.jar и activation.jar в ваш CLASSPATH.

Отправка Email

Вот пример отправки в Java простого электронного письма с вашего компьютера. Предполагается, что ваш локальный хост подключен к Интернету и вполне способен отправлять электронную почту.

Пример

// Название файла SendEmail.java import java.util.*; import javax.mail.*; import javax.mail.internet.*; import javax.activation.*; public class SendEmail < public static void main(String [] args) < // Необходимо указать адрес электронной почты получателя String to = "abcd@gmail.com"; // Необходимо указать адрес электронной почты отправителя String from = "web@gmail.com"; // Предполагая, что вы отправляете электронное письмо с localhost String host = "localhost"; // Получить свойства системы Properties properties = System.getProperties(); // Настроить почтовый сервер properties.setProperty("mail.smtp.host", host); // Получение объекта Session по умолчанию Session session = Session.getDefaultInstance(properties); try < // Создание объекта MimeMessage по умолчанию MimeMessage message = new MimeMessage(session); // Установить От: поле заголовка message.setFrom(new InternetAddress(from)); // Установить Кому: поле заголовка message.addRecipient(Message.RecipientType.TO, new InternetAddress(to)); // Установить тему: поле заголовка message.setSubject("Это тема письма!"); // Теперь установите фактическое сообщение message.setText("Это актуальное сообщение"); // Отправить сообщение Transport.send(message); System.out.println("Сообщение успешно отправлено. "); >catch (MessagingException mex) < mex.printStackTrace(); >> > 

Скомпилируйте и запустите эту программу, чтобы отправить Email в Java:

$ java SendEmail Сообщение успешно отправлено. 

Если вы хотите отправить электронное письмо нескольким получателям, то для указания нескольких ID (идентификаторов) электронной почты необходимо использовать следующие методы:

void addRecipients(Message.RecipientType type, Address[] addresses) throws MessagingException 

Ниже представлено описание параметров:

• type (тип) — Он будет установлен в TO, CC или BCC. В данном CC — это точная копия, а BCC — это черновая копия. Пример: RecipientType.TO (сообщение. Тип получателя. ТО)
• addresses (адреса) — это массив адресов электронной почты. Вам нужно будет использовать метод InternetAddress () (адрес в Интернете) при указании ID электронной почты.

Отправка HTML Email

Вот пример отправки электронного письма HTML с вашего компьютера. Предполагается, что ваш локальный хост подключен к Интернету и вполне способен отправлять электронную почту.

Этот пример очень похож на предыдущий, за исключением того, что здесь мы используем метод setContent() (настройка содержимого) для установки содержимого, вторым аргументом которого является «text / html», чтобы указать то, что содержимое HTML включено в сообщение.

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

Пример

// Название файла SendHTMLEmail.java import java.util.*; import javax.mail.*; import javax.mail.internet.*; import javax.activation.*; public class SendHTMLEmail < public static void main(String [] args) < // Необходимо указать адрес электронной почты получателя String to = "abcd@gmail.com"; // Необходимо указать адрес электронной почты отправителя String from = "web@gmail.com"; // Предполагая, что вы отправляете электронное письмо с localhost String host = "localhost"; // Получить свойства системы Properties properties = System.getProperties(); // Настроить почтовый сервер properties.setProperty("mail.smtp.host", host); // Получение объекта Session по умолчанию Session session = Session.getDefaultInstance(properties); try < // Создание объекта MimeMessage по умолчанию MimeMessage message = new MimeMessage(session); // Установить От: поле заголовка. message.setFrom(new InternetAddress(from)); // Установить Кому: поле заголовка message.addRecipient(Message.RecipientType.TO, new InternetAddress(to)); // Установить тему: поле заголовка message.setSubject("Это тема письма!"); // Отправьте фактическое HTML-сообщение любого размера message.setContent("
Это актуальное сообщение
", "text/html"); // Отправить сообщение Transport.send(message); System.out.println("Сообщение успешно отправлено. "); > catch (MessagingException mex) < mex.printStackTrace(); >> > 

Скомпилируйте и запустите эту программу, чтобы отправить электронное письмо HTML:

$ java SendHTMLEmail Сообщение успешно отправлено. 

Отправка вложения в электронном письме

Вот пример отправки электронного письма с вложением с вашего компьютера. Предполагается, что ваш локальный хост подключен к Интернету и вполне способен отправлять электронную почту.

Пример

// File Name SendFileEmail.java import java.util.*; import javax.mail.*; import javax.mail.internet.*; import javax.activation.*; public class SendFileEmail < public static void main(String [] args) < // Необходимо указать адрес электронной почты получателя String to = "abcd@gmail.com"; // Необходимо указать адрес электронной почты отправителя String from = "web@gmail.com"; // Предполагая, что вы отправляете электронное письмо с localhost String host = "localhost"; // Получить свойства системы Properties properties = System.getProperties(); // Настроить почтовый сервер properties.setProperty("mail.smtp.host", host); // Получение объекта Session по умолчанию Session session = Session.getDefaultInstance(properties); try < // Создание объекта MimeMessage по умолчанию MimeMessage message = new MimeMessage(session); // Установить От: поле заголовка message.setFrom(new InternetAddress(from)); // Установить Кому: поле заголовка message.addRecipient(Message.RecipientType.TO,new InternetAddress(to)); // Установить тему: поле заголовка message.setSubject("Это тема письма!"); // Создание части сообщения BodyPart messageBodyPart = new MimeBodyPart(); // Заполнение сообщения messageBodyPart.setText("Это тело сообщения"); // Создание составного сообщения Multipart multipart = new MimeMultipart(); // Установить часть текстового сообщения multipart.addBodyPart(messageBodyPart); // Часть вторая вложения messageBodyPart = new MimeBodyPart(); String filename = "file.txt"; DataSource source = new FileDataSource(filename); messageBodyPart.setDataHandler(new DataHandler(source)); messageBodyPart.setFileName(filename); multipart.addBodyPart(messageBodyPart); // Отправить полные части сообщения message.setContent(multipart ); // Отправить сообщение Transport.send(message); System.out.println("Сообщение успешно отправлено. "); >catch (MessagingException mex) < mex.printStackTrace(); >> > 

Скомпилируйте и запустите эту программу, чтобы отправить электронное письмо HTML:

$ java SendFileEmail Сообщение успешно отправлено. 

Часть аутентификации пользователя

Если для аутентификации требуется предоставить ID пользователя и пароль серверу электронной почты, вы можете установить эти свойства следующим образом:

props.setProperty("mail.user", "myuser"); props.setProperty("mail.password", "mypwd"); 

Остальная часть механизма отправки электронной почты останется такой, как описано выше.

Оглавление

• 1. Java – Самоучитель для начинающих
• 2. Java – Обзор языка
• 3. Java – Установка и настройка
• 4. Java – Синтаксис
• 5. Java – Классы и объекты
• 6. Java – Конструкторы
• 7. Java – Типы данных и литералы
• 8. Java – Типы переменных
• 9. Java – Модификаторы
• 10. Java – Операторы
• 11. Java – Циклы и операторы цикла
• 11.1. Java – Цикл while
• 11.2. Java – Цикл for
• 11.3. Java – Улучшенный цикл for
• 11.4. Java – Цикл do..while
• 11.5. Java – Оператор break
• 11.6. Java – Оператор continue
• 12. Java – Операторы принятия решений
• 12.1. Java – Оператор if
• 12.2. Java – Оператор if..else
• 12.3. Java – Вложенный оператор if
• 12.4. Java – Оператор switch..case
• 12.5. Java – Условный оператор (? 🙂
• 13. Java – Числа
• 13.1. Java – Методы byteValue(), shortValue(), intValue(), longValue(), floatValue(), doubleValue()
• 13.2. Java – Метод compareTo()
• 13.3. Java – Метод equals()
• 13.4. Java – Метод valueOf()
• 13.5. Java – Метод toString()
• 13.6. Java – Метод parseInt()
• 13.7. Java – Метод Math.abs()
• 13.8. Java – Метод Math.ceil()
• 13.9. Java – Метод Math.floor()
• 13.10. Java – Метод Math.rint()
• 13.11. Java – Метод Math.round()
• 13.12. Java – Метод Math.min()
• 13.13. Java – Метод Math.max()
• 13.14. Java – Метод Math.exp()
• 13.15. Java – Метод Math.log()
• 13.16. Java – Метод Math.pow()
• 13.17. Java – Метод Math.sqrt()
• 13.18. Java – Метод Math.sin()
• 13.19. Java – Метод Math.cos()
• 13.20. Java – Метод Math.tan()
• 13.21. Java – Метод Math.asin()
• 13.22. Java – Метод Math.acos()
• 13.23. Java – Метод Math.atan()
• 13.24. Java – Метод Math.atan2()
• 13.25. Java – Метод Math.toDegrees()
• 13.26. Java – Метод Math.toRadians()
• 13.27. Java – Метод Math.random()
• 14. Java – Символы
• 14.1. Java – Метод Character.isLetter()
• 14.2. Java – Метод Character.isDigit()
• 14.3. Java – Метод Character.isWhitespace()
• 14.4. Java – Метод Character.isUpperCase()
• 14.5. Java – Метод Character.isLowerCase()
• 14.6. Java – Метод Character.toUpperCase()
• 14.7. Java – Метод Character.toLowerCase()
• 14.8. Java – Метод Character.toString()
• 15. Java – Строки
• 15.1. Java – Метод charAt()
• 15.2. Java – Метод compareTo()
• 15.3. Java – Метод compareToIgnoreCase()
• 15.4. Java – Метод concat()
• 15.5. Java – Метод contentEquals()
• 15.6. Java – Метод copyValueOf()
• 15.7. Java – Метод endsWith()
• 15.8. Java – Метод equals()
• 15.9. Java – Метод equalsIgnoreCase()
• 15.10. Java – Метод getBytes()
• 15.11. Java – Метод getChars()
• 15.12. Java – Метод hashCode()
• 15.13. Java – Метод indexOf()
• 15.14. Java – Метод intern()
• 15.15. Java – Метод lastIndexOf()
• 15.16. Java – Метод length()
• 15.17. Java – Метод matches()
• 15.18. Java – Метод regionMatches()
• 15.19. Java – Метод replace()
• 15.20. Java – Метод replaceAll()
• 15.21. Java – Метод replaceFirst()
• 15.22. Java – Метод split()
• 15.23. Java – Метод startsWith()
• 15.24. Java – Метод subSequence()
• 15.25. Java – Метод substring()
• 15.26. Java – Метод toCharArray()
• 15.27. Java – Метод toLowerCase()
• 15.28. Java – Метод toString()
• 15.29. Java – Метод toUpperCase()
• 15.30. Java – Метод trim()
• 15.31. Java – Метод valueOf()
• 15.32. Java – Классы StringBuilder и StringBuffer
• 15.32.1. Java – Метод append()
• 15.32.2. Java – Метод reverse()
• 15.32.3. Java – Метод delete()
• 15.32.4. Java – Метод insert()
• 15.32.5. Java – Метод replace()
• 16. Java – Массивы
• 17. Java – Дата и время
• 18. Java – Регулярные выражения
• 19. Java – Методы
• 20. Java – Потоки ввода/вывода, файлы и каталоги
• 20.1. Java – Класс ByteArrayInputStream
• 20.2. Java – Класс DataInputStream
• 20.3. Java – Класс ByteArrayOutputStream
• 20.4. Java – Класс DataOutputStream
• 20.5. Java – Класс File
• 20.6. Java – Класс FileReader
• 20.7. Java – Класс FileWriter
• 21. Java – Исключения
• 21.1. Java – Встроенные исключения
• 22. Java – Вложенные и внутренние классы
• 23. Java – Наследование
• 24. Java – Переопределение
• 25. Java – Полиморфизм
• 26. Java – Абстракция
• 27. Java – Инкапсуляция
• 28. Java – Интерфейсы
• 29. Java – Пакеты
• 30. Java – Структуры данных
• 30.1. Java – Интерфейс Enumeration
• 30.2. Java – Класс BitSet
• 30.3. Java – Класс Vector
• 30.4. Java – Класс Stack
• 30.5. Java – Класс Dictionary
• 30.6. Java – Класс Hashtable
• 30.7. Java – Класс Properties
• 31. Java – Коллекции
• 31.1. Java – Интерфейс Collection
• 31.2. Java – Интерфейс List
• 31.3. Java – Интерфейс Set
• 31.4. Java – Интерфейс SortedSet
• 31.5. Java – Интерфейс Map
• 31.6. Java – Интерфейс Map.Entry
• 31.7. Java – Интерфейс SortedMap
• 31.8. Java – Класс LinkedList
• 31.9. Java – Класс ArrayList
• 31.10. Java – Класс HashSet
• 31.11. Java – Класс LinkedHashSet
• 31.12. Java – Класс TreeSet
• 31.13. Java – Класс HashMap
• 31.14. Java – Класс TreeMap
• 31.15. Java – Класс WeakHashMap
• 31.16. Java – Класс LinkedHashMap
• 31.17. Java – Класс IdentityHashMap
• 31.18. Java – Алгоритмы Collection
• 31.19. Java – Iterator и ListIterator
• 31.20. Java – Comparator
• 32. Java – Дженерики
• 33. Java – Сериализация
• 34. Java – Сеть
• 34.1. Java – Обработка URL
• 35. Java – Отправка Email
• 36. Java – Многопоточность
• 36.1. Java – Синхронизация потоков
• 36.2. Java – Межпоточная связь
• 36.3. Java – Взаимная блокировка потоков
• 36.4. Java – Управление потоками
• 37. Java – Основы работы с апплетами
• 38. Java – Javadoc

как отправить письмо из джава приложения? [закрыт]

Закрыт. Этот вопрос необходимо уточнить или дополнить подробностями. Ответы на него в данный момент не принимаются.

Хотите улучшить этот вопрос? Добавьте больше подробностей и уточните проблему, отредактировав это сообщение.

Закрыт 1 год назад .

Подскажите пожалуйста, как отправить письмо из джава приложения? отправлять нужно с моей почты (gmail.com)

Отслеживать
задан 8 апр 2022 в 21:20
LsdLucifer LsdLucifer
11 1 1 серебряный знак 6 6 бронзовых знаков

1 ответ 1

Сортировка: Сброс на вариант по умолчанию

нашел подробную инструкцию вот тут:

//1. Gmail SMTP через TLS SMTP = smtp.gmail.com Port = 587 SendEmailTLS.java import javax.mail.*; import javax.mail.internet.InternetAddress; import javax.mail.internet.MimeMessage; import java.util.Properties; public class SendEmailTLS < public static void main(String[] args) < final String username = "[email protected]"; final String password = "password"; Properties prop = new Properties(); prop.put("mail.smtp.host", "smtp.gmail.com"); prop.put("mail.smtp.port", "587"); prop.put("mail.smtp.auth", "true"); prop.put("mail.smtp.starttls.enable", "true"); //TLS Session session = Session.getInstance(prop, new javax.mail.Authenticator() < protected PasswordAuthentication getPasswordAuthentication() < return new PasswordAuthentication(username, password); >>); try < Message message = new MimeMessage(session); message.setFrom(new InternetAddress("[email protected]")); message.setRecipients( Message.RecipientType.TO, InternetAddress.parse("[email protected], [email protected]") ); message.setSubject("Testing Gmail TLS"); message.setText("Dear Mail Crawler," + "\n\n Please do not spam my email!"); Transport.send(message); System.out.println("Done"); > catch (MessagingException e) < e.printStackTrace(); >> > 

Отправка писем java – примеры

Для отправки электронной почты с использованием Java-приложения достаточно просто, но для начала на вашем компьютере должны быть установлены JavaMail API и Java Activation Framework (JAF). Вы можете загрузить последнюю версию JavaMail и JAF со стандартного веб-сайта Java.

Загрузите и разархивируйте эти файлы, во вновь созданных каталогах верхнего уровня вы найдете несколько jar-файлов для обоих приложений. Необходимо добавить файлы mail.jar и activation.jar в ваш CLASSPATH.

Отправить простое электронное письмо

Вот пример отправки простого электронного письма с вашего компьютера с помощью Java. Предполагается, что ваш локальный хост подключен к Интернету и достаточно способен отправлять электронную почту.

Пример

// File Name SendEmail.java import java.util.*; import javax.mail.*; import javax.mail.internet.*; import javax.activation.*; public class SendEmail < public static void main(String [] args) < // Recipient's email ID needs to be mentioned. String to = "abcd@gmail.com"; // Sender's email ID needs to be mentioned String from = "web@gmail.com"; // Assuming you are sending email from localhost String host = "localhost"; // Get system properties Properties properties = System.getProperties(); // Setup mail server properties.setProperty("mail.smtp.host", host); // Get the default Session object. Session session = Session.getDefaultInstance(properties); try < // Create a default MimeMessage object. MimeMessage message = new MimeMessage(session); // Set From: header field of the header. message.setFrom(new InternetAddress(from)); // Set To: header field of the header. message.addRecipient(Message.RecipientType.TO, new InternetAddress(to)); // Set Subject: header field message.setSubject("This is the Subject Line!"); // Now set the actual message message.setText("This is actual message"); // Send message Transport.send(message); System.out.println("Sent message successfully. "); >catch (MessagingException mex) < mex.printStackTrace(); >> >

Скомпилируйте и запустите эту программу, чтобы отправить простое электронное письмо –

Итог

$ java SendEmail Sent message successfully.

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

void addRecipients(Message.RecipientType type, Address[] addresses) throws MessagingException

Вот описание параметров –

• type – Это будет установлено в TO, CC или BCC. Здесь CC представляет Carbon Copy, а BCC представляет Black Carbon Copy. Пример:

Message.RecipientType.TO

• addresses – это массив адресов электронной почты. Вам нужно будет использовать метод InternetAddress() при указании идентификаторов электронной почты.

Отправить HTML письмо

Вот пример отправки электронной почты в формате HTML с вашего компьютера. Здесь предполагается, что ваш локальный хост подключен к Интернету и достаточно способен отправлять электронную почту. Этот пример очень похож на предыдущий, за исключением того, что здесь мы используем метод setContent() для установки содержимого, вторым аргументом которого является «text / html», чтобы указать, что содержимое HTML включено в сообщение.

Используя этот пример, вы можете отправить настолько большой, насколько вам нравится, контент HTML.

Пример

// File Name SendHTMLEmail.java import java.util.*; import javax.mail.*; import javax.mail.internet.*; import javax.activation.*; public class SendHTMLEmail < public static void main(String [] args) < // Recipient's email ID needs to be mentioned. String to = "abcd@gmail.com"; // Sender's email ID needs to be mentioned String from = "web@gmail.com"; // Assuming you are sending email from localhost String host = "localhost"; // Get system properties Properties properties = System.getProperties(); // Setup mail server properties.setProperty("mail.smtp.host", host); // Get the default Session object. Session session = Session.getDefaultInstance(properties); try < // Create a default MimeMessage object. MimeMessage message = new MimeMessage(session); // Set From: header field of the header. message.setFrom(new InternetAddress(from)); // Set To: header field of the header. message.addRecipient(Message.RecipientType.TO, new InternetAddress(to)); // Set Subject: header field message.setSubject("This is the Subject Line!"); // Send the actual HTML message, as big as you like message.setContent("
This is actual message
", "text/html"); // Send message Transport.send(message); System.out.println("Sent message successfully. "); > catch (MessagingException mex) < mex.printStackTrace(); >> >

Скомпилируйте и запустите эту программу для отправки электронного письма в формате HTML –

Итог

$ java SendHTMLEmail Sent message successfully.

Отправить вложение в E-mail

Вот пример, чтобы отправить электронное письмо с вложением с вашего компьютера. Здесь предполагается, что ваш локальный хост подключен к Интернету и достаточно способен отправлять электронную почту.

Пример

// File Name SendFileEmail.java import java.util.*; import javax.mail.*; import javax.mail.internet.*; import javax.activation.*; public class SendFileEmail < public static void main(String [] args) < // Recipient's email ID needs to be mentioned. String to = "abcd@gmail.com"; // Sender's email ID needs to be mentioned String from = "web@gmail.com"; // Assuming you are sending email from localhost String host = "localhost"; // Get system properties Properties properties = System.getProperties(); // Setup mail server properties.setProperty("mail.smtp.host", host); // Get the default Session object. Session session = Session.getDefaultInstance(properties); try < // Create a default MimeMessage object. MimeMessage message = new MimeMessage(session); // Set From: header field of the header. message.setFrom(new InternetAddress(from)); // Set To: header field of the header. message.addRecipient(Message.RecipientType.TO,new InternetAddress(to)); // Set Subject: header field message.setSubject("This is the Subject Line!"); // Create the message part BodyPart messageBodyPart = new MimeBodyPart(); // Fill the message messageBodyPart.setText("This is message body"); // Create a multipar message Multipart multipart = new MimeMultipart(); // Set text message part multipart.addBodyPart(messageBodyPart); // Part two is attachment messageBodyPart = new MimeBodyPart(); String filename = "file.txt"; DataSource source = new FileDataSource(filename); messageBodyPart.setDataHandler(new DataHandler(source)); messageBodyPart.setFileName(filename); multipart.addBodyPart(messageBodyPart); // Send the complete message parts message.setContent(multipart ); // Send message Transport.send(message); System.out.println("Sent message successfully. "); >catch (MessagingException mex) < mex.printStackTrace(); >> >

Скомпилируйте и запустите эту программу для отправки электронного письма в формате HTML –

Итог

$ java SendFileEmail Sent message successfully.

Часть аутентификации пользователя

Если для аутентификации требуется предоставить идентификатор пользователя и пароль для сервера электронной почты, вы можете установить эти свойства следующим образом:

props.setProperty("mail.user", "myuser"); props.setProperty("mail.password", "mypwd");

Остальная часть механизма отправки электронной почты останется такой, как описано выше.

Средняя оценка 5 / 5. Количество голосов: 1

Спасибо, помогите другим — напишите комментарий, добавьте информации к статье.

Или поделись статьей

Видим, что вы не нашли ответ на свой вопрос.

Помогите улучшить статью.

Напишите комментарий, что можно добавить к статье, какой информации не хватает.

Электронная почта и работа с ней в Java-приложениях

Disclaimer
Статья написана для новичков и тех, кому хочется шаг за шагом понять как устроена работа с электронной почтой из Java-приложений. Желающие быстро понять как отправлять электронные письма из Spring-приложений могут сразу переходить к 3 части.

Эту статью я решил написать, потому что не нашел русскоязычных источников про работу c электронной почтой из Java, описывающих имеющиеся библиотеки достаточно полно. На хабре существует статья, посвященная очень узкой задаче по чтению писем (и выводу их содержимого в консоль) и статья с how-to по отправлению
письма с вложениями при помощи Spring Email. Также существует несколько статей (например) на тематических ресурсах, которые приводят порядок действий при работе
с электронной почтой. В этих источниках мне не хватало объяснения основ, на которых стоит
электронная почта и взгляда с высоты на существующие библиотеки для работы с почтой в Java.

Для таких же лапкообразных, как я, написана эта статья. Она дает общие представления о работе электронной почты, разъясняет основные сущности библиотеки Jakarta Mail и дает советы о том, как работать с электронной почтой в Spring-приложениях.

1. Электронная почта

Сегодня электронная почта кажется устаревшей технологией, которая нужна только для того чтобы зарегистрироваться на сайтах, куда забыли прикрутить авторизацию с помощью Google, Vk или Facebook -аккаунта. Возможно, так и есть, но наверняка вы до сих пор получаете электронные письма о падении сборки от вашего CI-инструмента или уведомления о пул-реквестах от вашего репозитория на свой почтовый ящик.

Электронная почта была создана на заре интернета и позаимствовала многие свои идеи из реального мира. Подобно тому как в оффлайне для отправки и получения писем нам требуются почтовые отделения, в электронной почте нам нужны почтовые сервера, т.е. электронная почта основана на модели клиент-сервер. В крупных компаниях сисадмины разворачивают свои собственные почтовые сервера, в маленьких компаниях используют почтовые сервера, предоставляемые специальными провайдерами, например: Яндекс.Почта, Gmail и др.

Популярные почтовые серверы: Postfix, Sendmail, Apache James, Zimbra.

Для работы с письмами на стороне клиента используются десктопные приложения вроде Outlook или The Bat!, либо веб-приложения вроде Gmail или Яндекс.Почта.

Предположим, что человек А решил отправить письмо человеку Б. Он пишет его в своем почтовом клиенте и нажимает кнопку «отправить». Письмо отправляется по протоколу SMTP на почтовый сервер клиента А. Этот почтовый сервер пересылает письмо почтовому серверу клиенту Б также при помощи протокола SMTP. Когда клиент Б решит проверить почту, он сделает запрос к своему почтовому серверу с помощью протокола POP3 или IMAP. В случае использования протокола POP3 письма будут выкачены на устройство клиента Б и удалены с почтового сервера. При использовании протокола IMAP клиенту Б будут переданы копии писем,
а оригиналы останутся храниться на почтовом сервере.

Электронное письмо

Электронное письмо состоит из следующих частей:

• Заголовки — тема письма, адрес отправителя, адреса получателей и служебная информация.
• Тело письма — текст, html, картинки, вложения.

Раньше тело письма могло состоять только из символов ASCII, но с развитием почтовых систем, появилась возможность добавлять в тело html-разметку, изображения, а также прикладывать к письму различные файлы. Для того чтобы правильно выделять различные части из письма, были разработаны MIME-типы — многоцелевые расширения интернет-почты.

Для отправки писем используется протокол SMTP. А для их приема используется либо протокол POP3, либо IMAP.

Существуют и другие почтовые протоколы, но три перечисленных выше — наиболее популярны.

Почтовые протоколы

Все почтовые протоколы относятся к самому высокому уровню модели OSI и основаны на TCP.
У каждого из нижеперечисленных протоколов существует защищенная версия, основанная на SSL.

SMTP

Simple Mail Transfer Protocol — простой протокол передачи писем. Используется для рассылки писем.

SMTP использует порт 25 или 587. А его защищенная версия SMTPS слушает порт 465.

POP3

Post Office Protocol v3 — почтовый протокол. Используется для чтения писем. POP3 при выкачивании письма на клиентский компьютер удаляет письмо с почтового сервера. Недостатком этого протокола является то, что при просмотре письма на одном клиентском компьютере это письмо уже нельзя будет посмотреть с другого устройства.

POP3 слушает порт 110. А его защищенная версия POP3S слушает порт 995.

IMAP

Internet Message Access Protocol — протокол доступа к электронной почте. Альтернатива протоколу POP3. IMAP подгружает на клиент только мета-информацию письма, а остальные
данные предоставляет по требованию.

IMAP слушает порт 143. А его защищенная версия IMAPS слушает порт 993.

MIME-типы

Multipurpose Internet Mail Extensions — многоцелевые расширения интернет-почты. MIME используется, для того чтобы обозначить тип передаваемого контента с помощью протоколов, которые первоначально были предназначены только для передачи текстовой информации, например SMTP и HTTP.

MIME первоначально предназначался для электронной почты, но впоследствии начал использоваться не только в ней, но и в HTTP.

Тип определяется двумя словами, записанными через прямой слеш. Первое слово — это общий тип, а второе — уточнение.

image/jpeg

MIME позволяет устанавливать иерархию вложенности одних блоков контента в другие.
При этом блоки контента могут быть смешанного содержимого. Для таких блоков используется общий тип multipart , нам еще встретится этот термин.

2. Работа с электронной почтой с помощью Jakarta Mail

Jakarta Mail — это библиотека / фреймворк, использующийся для создания, отправки и чтения электронной почты из Java-кода. Библиотека входит в состав Jakarta EE. Ранее библиотека называлась JavaMail, но с 2017 года она переехала под крыло Jakarta.

Как принято в Java EE, сама библиотека предоставляет только базовые сущности, не зависящие от конкретных реализаций. Эти основные классы находятся в пакете javax.mail . Помимо этого к библиотеке прикладывается Reference Implementation для основных протоколов — SMTP, POP3, IMAP. Все классы, относящиеся к этим протоколам, находятся в пакете com.sun.mail . Для использования других протоколов, не входящих в Reference Implementation, необходимо подключать сторонние библиотеки.

Для обработки различных форматов данных, которые могут быть вложены в электронное письмо, Jakarta Mail использует библиотеку JavaBeans Activation Framework — при использовании автоматического сборщика эта зависимость будет подтянута в ваш проект транзитивно.

На текущий момент актуальной версией Jakarta Mail является 1.6.5, но близится выпуск версии 2.0.0, главным «нововведением» которого станет переименование основного пакета с
javax.mail на jakarta.mail .

В Jakarta Mail не входит почтовый сервер. Для отправки писем по SMTP или получения по IMAP или POP3 требуется развернуть собственный почтовый сервер или использовать существующий.

Настройка почтовых серверов

Как следует из первой части, для отправки и получения электронных писем необходимо поддерживать соединение с почтовыми серверами. В Jakarta Mail почтовые сервера представляют объекты классов Transport и Store для отправления и чтения писем соответственно.

Настройка соединения с почтовыми серверами происходит с помощью пар ключ-значение, передаваемых в виде объекта класса Properties . Например для настройки SMTP-соединения с почтовым сервером Яндекс.Почты достаточно следующих параметров:

mail.transport.protocol = smtps mail.smtp.host = smtp.yandex.ru mail.smtp.port = 465 mail.smtp.user = artem.boiar mail.smtp.ssl.enable = true mail.smtp.auth = true mail.debug = true

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

Сессия

На основе объекта Properties создается сессия:

final Session session = Session.getInstance(mailProperties, authenticator);

Обычно сессия создается одна для всего приложения. Она представляет собой сеанс работы с почтовыми серверами. Почти каждый объект библиотеки должен принадлежать какой-либо сессии.

Аутентификация

Вторым аргументом при создании сессии необходимо передать объект абстрактного класса Authenticator , у которого требуется переопределить метод getPasswordAuthentication() (по умолчанию возвращает null, почему он не был сделан абстрактным — неизвестно).

Этот метод используется сессией для связи с почтовым сервером — метод будет вызываться при каждом обращении к серверу. При его вызове возвращается объект класса PasswordAuthentication , который представляет собой обычное DTO для хранения логина и пароля.

final Authenticator authenticator = new Authenticator() < @Override protected PasswordAuthentication getPasswordAuthentication() < return new PasswordAuthentication( this.getDefaultUserName(), PropUtils.getPassword() ); >>

Разработчиками библиотеки подразумевается, что внутри этого метода можно запросить пароль у пользователя или достать его из хранилища. При получении пароля можно пользоваться значениями полей класса Authenticator : IP почтового сервера, тип протокола, используемый
порт и даже имя дефолтного пользователя.

Почти все сущности, представляющие какие-либо объекты предметной области, представлены абстрактными классами, реализация которых зависит от конкретного протокола:

• Message — электронное письмо;
• BodyPart — фрагмент электронного письма: основная часть или вложение;
• Address — адрес отправителя или получателя;
• Folder — папка, в которой хранятся электронные письма;
• SearchTerm — условие поиска писем в папке;
• MailEvent — событие, произошедшее с письмом.
  Обработка событий основывается на паттерне Наблюдатель.

Примечание — в данной статье обработка событий не рассмотрена.

Письма

Электронные письма представляются с помощью абстрактного класса Message , у которого есть один наследник — MimeMessage (реализации различных протоколов могут дополнительно расширять этот класс).

Электронное письмо состоит из метаинформации: отправитель, получатели, тема, дата отправки и др.,- и основной части: текст и вложения. Основная часть письма представлена в виде фрагментов BodyPart , которые хранятся в контейнере Multipart . Подробнее о фрагментах — ниже.

Каждое письмо привязывается к конкретной сессии. При создании нового письма в конструктор передается объект сессии:

final Message message = new MimeMessage(session);

Для установки значений полей метаинформации используются обычные сеттеры. При установке получателей необходимо указывать еще тип адресантов, для этого у класса Message есть внутренний класс RecipientType , который представляет собой различные виды адресантов:

• TO — прямой получатель;
• CC — получатель копии;
• BCC — получатель скрытой копии.

Поля с такими названиями можно найти в интерфейсе любого почтового клиента при написании письма.

message.setFrom("artem.boiar@yandex.ru"); message.setRecipients(Message.RecipientType.TO, "joshua.bloch@google.com"); message.setRecipients(Message.RecipientType.CC, "tagir.valeev@jetbrains.com"); message.setRecipients(Message.RecipientType.BCC, "sergey.egorov@pivotal.com"); message.setSubject("Java 20 new hot features");

Флаги

При чтении писем можно изменять их состояние, устанавливая им различные флаги. Стандартные флаги представлены в классе Flags :

• ANSWERED — отвечено
• DELETED — удалено
• DRAFT — черновик
• FLAGGED — выделено
• RECENT — недавнее
• SEEN — просмотрено
• USER — пользовательский флаг

Флаги устанавливаются в сообщении в нужное положение с помощью метода setFlag(Flag, boolean set) .

Адреса

Адреса используются для идентификации получателя письма.

Класс Address является абстрактным и по сути имеет всего одну реализацию — InternetAddress (есть еще NewsAddress для мамонтов, пользующихся Usenet’ом).

InternetAddress представляет привычные нам адреса электронной почты, записанные в формате:

trisha.gee@jetbrains.com

Помимо адреса объекты могут хранить в себе имя адресанта в любой кодировке:

internetAddress.setPersonal("Сергей Куксенко");

Для того чтобы создать объект InternetAddress можно воспользоваться одним из конструкторов, либо распарсить строку с несколькими адресами в массив:

InternetAddress[] recipients = InternetAddress.parse( "kuksenko@oracle.com, baruh@jfrog.com, golodnyj@yandex.ru");

Примечание — для валидации адресов электронной почты, приходящих от пользователя в виде строк, можно пользоваться аннотацией @Email , объявленной в библиотеке Bean Validation.

Фрагменты письма

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

В Jakarta Mail фрагмент письма представлен абстрактным классом BodyPart и его реализацией MimeBodyPart .
Тип фрагмента определяется параметром disposition :

• INLINE для основной части письма и
• ATTACHMENT для вложения.

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

Наиболее часто используемые MIME-типы для частей:

• text/plain для основной части письма и
• application/octet-stream для вложений.

Для создания фрагмента письма можно пользоваться обычным конструктором:

final MimeBodyPart mailBody = new MimeBodyPart(); final MimeBodyPart attachment = new MimeBodyPart();

На UML-диаграмме наследования, приведенной выше, объявлен еще интерфейс Part , который реализуется почти всеми классами, относящимися к письму. В нем объявлены методы доступа к метаинформации письма. Это довольно странное решение — как-будто у различных фрагментов одного письма могут быть различные адресанты или темы письма.

Запись контента

После создания фрагмента необходимо записать в него полезную нагрузку. Для основной части используется метод setText() , а для вложения — attachFile() или setContent() .

mailBody.setText("Java 20 new features.\nLook at the attachments."); attachment.attachFile(file);

MIME-тип вложения в большинстве случаев определяется автоматически по расширению файла.

Чтение контента

Для чтения контента из пришедшего письма можно воспользоваться методом
void saveFile(File) для сохранения контента на диск или
void writeTo(OutputStream) для перенаправления контента в указанный поток.

Мультифрагменты

Фрагменты BodyPart для помещения в письмо объединяются в структуру Multipart . MimeBodyPart соответственно объединяются в структуру MimeMultipart .

final Multipart multipart = new MimeMultipart(); for (BodyPart bodyPart: bodyParts) < //cannot use streams because of checked exception multipart.addBodyPart(bodyPart); >

После этого мультипарт вкладывается в письмо:

message.setContent(multipart);

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

Для хранения писем на почтовом сервере используются папки. Обычно папка по умолчанию называется INBOX (в POP3 это единственная папка).

Папки организуют древовидную структуру. В некоторых реализациях папки могут хранить в себе что-то одно: папки или письма, — в других (например, IMAP) сразу и то, и другое.

Папка может находиться в открытом и закрытом состоянии. При извлечении папки она находится в закрытом состоянии. Чтобы прочитать письма, находящиеся в ней, необходимо сначала открыть ее open(int mode) в одной из двух режимов: только для чтения READ_ONLY или на чтение и запись — READ_WRITE .

Folder folder = store.getDefaultFolder(); folder.open(Folder.READ_WRITE);

Операции с содержимым папки могут выполняться только в открытом состоянии, а операции над самой папкой только в закрытом состоянии.

Для извлечения писем из папки можно использовать метод getMessages() , возвращающий все письма из папки:

Message[] messages = folder.getMessages();

Письма располагаются в папке аналогично списку и имеют номера, начиная с 1 . Для получения писем по их порядковым номерам используются разновидности приведенного выше метода.

При использовании протокола IMAP из папки достаются легковесные объекты
вместо полноценных сообщений. Необходимые части сообщения подтягиваются с почтового сервера по требованию, либо можно сразу загрузить полную версию письма, вызвав метод fetch() класса Folder, передав в него желаемые письма.

Папки позволяют удалять письма, но сделать это можно только с теми письмами, которые помечены флагом DELETED .

Поиск писем

Jakarta Mail позволяет проводить поиск по письмам в папках. Для составления поискового запроса предназначен абстрактный класс SearchTerm , имеющий множество реализаций для поиска по различным критериям: теме письма, дате отправления, отправителю, флагам и пр. Различные критерии поиска могут объединяться в один поисковый запрос.

После составление поискового запроса он запускается по указанной папке:

final FromTerm fromTerm = new FromTerm(new InternetAddress("artem.boiar@yandex.ru")); final SubjectTerm subjectTerm = new SubjectTerm("Java"); final AndTerm termsSummary = new AndTerm(fromTerm, subjectTerm); final Message[] foundMessages = folder.search(termsSummary);

3. Работа с электронной почтой в среде Spring

Для удобства использования библиотеки Jakarta Mail в Spring-приложениях была разработана библиотека Spring Email, которая по сути является фасадом к API Jakarta Mail.
Все классы библиотеки находятся в пакете org.springframework.mail , который можно подтянуть с помощью зависимости spring-boot-starter-mail .

В большинстве Java-приложений не требуется читать письма с почтового сервера, чаще всего необходимо только рассылать электронную почту (например для подтверждения регистрации в вашем веб-приложении или для рассылки уведомлений). В связи с этим Spring Email предоставляет API только для отправки писем.

Интересный факт — в разработке Spring Mail принимал участие наш земляк — Дмитрий Копыленко.

Библиотека Spring Email предоставляет ряд классов и интерфейсов, которые хорошо вписываются в общую концепцию фреймворка. Все что нужно для отправки электронного сообщения из вашего кода, это заинжектить бин отправителя и передать ему письмо с помощью метода send() .

В библиотеке выделяются два вида писем: простые и MIME-письма. Простые не могут содержать в своем теле ничего кроме текста, MIME-письма могут содержать в теле html-верстку, изображения и иметь вложения.

Отправка простых писем

Простые письма представлены классом SimpleMailMessage . Этот класс полностью независим от сущностей библиотеки Jakarta Mail — все его методы принимают примитивы и объекты стандартной библиотеки Java.

final SimpleMailMessage simpleMail = new SimpleMailMessage(); simpleMail.setFrom("artem.boiar@yandex.ru"); simpleMail.setTo("yegor.bugaenko@huawei.com"); simpleMail.setSubject("Java 20 new hot features"); simpleMail.setText("Java 20 new hot features. No attachments :(");

Отправить созданное письмо можно с помощью бина интерфейса MailSender .

this.mailSender.send(simpleMail);

Отправка MIME-писем

Для работы с MIME-письмами используется класс MimeMessage из Jakarta Mail. Для тех случаев, когда требуется одинаковый интерфейс для работы с простыми и MIME-письмами существует класс адаптер MimeMailMessage , который как и SimpleMailMessage реализует интерфейс MailMessage .

Для создания объектов MimeMessage в библиотеке есть класс-помощник — MimeMessageHelper . Этот класс предоставляет удобный фасад для работы с телом письма, его
мультимедийными вставками и вложениями. Пользоваться им очень просто: достаточно обернуть в него объект MIME-письма и задать все необходимые параметры:

final MimeMessage mimeMessage = this.mailSender.createMimeMessage(); final MimeMessageHelper messageHelper = new MimeMessageHelper(mimeMessage, true); messageHelper.setFrom("artem.boiar@yandex.ru"); messageHelper.setTo("artyom.boyarshinov@cosysoft.ru"); messageHelper.setSubject("Java 20 new hot features"); messageHelper.setText("Java 20 new hot features. Look at the attachment.\nAlso look at my great cat!"); messageHelper.addInline("", FileUtils.getImage()); messageHelper.addAttachment("java-new-features.txt", FileUtils.getFile());

Таким образом MimeMessageHelper избавляет разработчика от необходимости создания BodyPart , и их сборки в Multipart , предоставляя удобное линейное API.

Для отправки MIME-писем используется бин интерфейса JavaMailSender :

this.javaMailSender.send(mimeMessage);

Помимо всего прочего в Spring Email существует callback-интерфейс для создания MIME-писем — MimeMessagePreparator . Этот интерфейс является функциональным и может быть заменен лямбдой Consumer , принимающей MimeMessage .

final MimeMessagePreparator preparator = mimeMessage -> < final MimeMessageHelper messageHelper = new MimeMessageHelper(mimeMessage, true); messageHelper.setFrom("artem.boiar@yandex.ru"); messageHelper.setTo("vlad.mihalcea@hibernate.com"); messageHelper.setSubject("Java 20 new hot features"); messageHelper.setText("Java 20 new hot features. Look at the attachment"); messageHelper.addAttachment("java-new-features.txt", FileUtils.getFile()); >;

Обработка исключений

В отличие от Jakarta Mail, все методы Spring Email бросают непроверяемые исключения.
Эти исключения являются runtime обертками над проверяемыми исключениями Jakarta Mail.

Особый интерес представляет исключение MailSendException . Оно позволяет извлечь конкретные письма, при отправке которых были инициированы исключения, с помощью метода getFailedMessages() :

catch (MailSendException exc) < MapexceptionsByMails = exc.getFailedMessages(); //. >

Настройка Spring Mail

Spring Email предоставляет удобный способ настройки соединения с SMTP сервером посредством обычного application.properties / application.yml -файла. Это упрощает настройку отправителя электронных писем, так как бин JavaMailSenderImpl конфигурируется самостоятельно при поднятии контекста.

spring: mail: protocol: smtps host: smtp.yandex.ru port: 465 username: artem.boiar password: passw0rd

Список источников и полезных ресурсов

1 часть

• В. Олифер, Н. Олифер. Компьютерные сети.
• Википедия. Электронная почта.
• Хабр. Протоколы верхнего уровня.

2 часть

• Официальная документация на Jakarta Mail.
• Github репозиторий Jakarta Mail.
• Настройки почтовых серверов.
• Книга Eliote Rusty Harold. JavaMail API — 2013.

3 часть

• Официальная документация на Spring Email.
• Гайд по Spring Email на Baeldung.
• Видеоурок по отправке писем с помощью Spring Email.