Введение

jfinal-mail-plugin — это плагин для отправки электронной почты в jfinal, поддерживающий отправку обычных писем и писем с приложениями. Содержание писем можно генерировать через шаблоны, а также поддерживаются несколько источников отправки электронной почты. Он наследует основные цели Jfinal "быстрое развитие, небольшой объем кода, простота обучения..." и требует всего двух строк кода для отправки электронной почты! Это позволяет вам экономить время и проводить его со своей второй половинкой, семьей и друзьями :). Основной код был перенесён из модуля электронной почты пакета spring-context-support, а примеры использования JavaMailSender объекта можно найти в документации Spring по отправке электронной почты.

Maven зависимости

<!-- Для jfinal 3.0 -->
<dependency>
    <groupId>cn.fsdev</groupId>
    <artifactId>jfinal-mail-plugin</artifactId>
    <version>3.0</version>
</dependency>

<!-- Для версий jfinal 2.0 - 2.2 -->
<dependency>
    <groupId>cn.fsdev</groupId>
    <artifactId>jfinal-mail-plugin</artifactId>
    <version>2.2.1</version>
</dependency>

Примеры

1. Создание конфигурационного файла для электронной почты:

# Хост SMTP сервера
host=smtp.qq.com
# Протокол
protocol=smtp
# Порт
port=465
# Адрес отправителя
username=
# Пароль
password=
# Авторизация SMTP
mail.smtp.auth=true
# Время ожидания
mail.smtp.timeout=5000
# SSL подключение
mail.smtp.ssl.enable=true

2. Включите плагин в JFinalConfig

me.add(new MailPlugin(PropKit.use("mail.properties").getProperties()));
```#### 3. Отправка письма с фиксированным содержанием
```java
// Обычное письмо
MailKit.send("получатель", Arrays.asList("копия1", "копия2"), "тема письма", "текст письма");
// Письмо с приложением
MailKit.send("получатель", Arrays.asList("копия1", "копия2"), "тема письма", "текст письма", Arrays.asList(new File("приложение1"), new File("приложение2")));

4. Отправка писем с использованием шаблонов

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

// Обычное письмо
Map<String, Object> dataMap = new HashMap<>();
dataMap.put("var1", "переменная1");
dataMap.put("var2", "переменная2");
MailKit.send("получатель", Arrays.asList("копия1", "копия2"), "тема письма", "шаблон пути", dataMap);

// Письмо с приложением
MailKit.send("получатель", Arrays.asList("копия1", "копия2"), "тема письма", "шаблон пути", dataMap, Arrays.asList(new File("приложение1"), new File("приложение2")));

5. Поддержка нескольких источников электронной почты

Плагин поддерживает не один источник отправки электронной почты, а несколько с высокой скоростью.

1. При запуске плагина указывается имя источника отправки: me.add(new MailPlugin("mail2", PropKit.use("mail2.properties").getProperties()));

2. При отправке электронной почты указывается источник отправки: MailKit.use("mail2").send(...);

Условия использования

Среда виртуальной машины: JDK 1.6+ Версия JFinal: tag2.2 (скомпилирована на основе 2.2, теоретически поддерживается версия 2.0+, основная линия на основе jfinal 3.0)