1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/hongshuboy-easymail

В этом репозитории не указан файл с открытой лицензией (LICENSE). При использовании обратитесь к конкретному описанию проекта и его зависимостям в коде.
Клонировать/Скачать
Внести вклад в разработку кода
Синхронизировать код
Отмена
Подсказка: Поскольку Git не поддерживает пустые директории, создание директории приведёт к созданию пустого файла .keep.
Loading...
README.md

Использование помощи

Две строки кода позволяют отправить электронное письмо.

Рисунок 1: Старты

Рисунок 2: Размер

Рисунок 3: Версия

Рисунок 4: Дата выпуска

Особенности и преимущества

  • Минимум усилий для отправки электронного письма: две строки кода отправляют электронное письмо.
  • Эффективность: гарантируя простоту использования, мы уделяем внимание эффективности и автоматически выбираем наилучший способ без необходимости вникать в исходный код.
  • Spring: на основе Spring-Mail, полностью поддерживает Spring, но также может использоваться отдельно от Spring.
  • Высокая вероятность доставки: по умолчанию используется двойной отправитель, который повторяет отправку при сбое, чтобы максимально гарантировать доставку до места назначения.

Обновление версии

Версия Ключевое слово Дата обновления Основное обновление содержания
1.0.0 RELEASE 22 февраля 2019 года Выпущена версия RELEASE, функциональное тестирование стабильно
1.0.1 Одиночный режим 16 марта 2019 г. Каталог 1.1, по умолчанию используется одиночный режим, при неизменном способе использования повышается скорость отклика
1.0.2 Пересылка 18 мая 2019 г. Автоматическое переключение пересылки, использование без изменений

Быстрое начало (5 минут для начала работы)

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

Ознакомьтесь со структурой проекта: это проект Maven, если вы не знакомы с Maven, вы можете использовать пакет JAR.

Пример:

Всего четыре строки кода позволят вам полностью отправить электронное письмо.

@Test
public void testSendSimple() throws MailAddressException {
    MimeMail mimeMail = MimeMail.Builder.initMailSender("smtp.163.com", "smtp",465, "hongshuboy@163.com","你的客户端授权码", false);
    List<String> to = new ArrayList<String>();// 收件人集合
    to.add("hongshuboy@qq.com");
    mimeMail.sendMail(to, "你有新的消息", "请到网站内查看"+new Date());
}

1.1 Обязательные настройки, включение POP3/SMTP/IMAP

Для отправки электронных писем через клиент (код) необходимо включить эти настройки в почтовом ящике и получить клиентский пароль (понимается как пароль), поскольку пароль учётной записи использовать нельзя, его необходимо заменить паролем.

Процесс настройки несложен, пожалуйста, выполните поиск самостоятельно, ключевые слова поиска, такие как «как включить POP3 / SMTP / IMAP-сервисы в 163-м почтовом ящике».

1.2 Загрузка зависимого пакета Jar

  • Перейдите по этой ссылке для загрузки пакета Jar или упакуйте этот проект с помощью Maven.
  • Примечание: Если вы не используете Spring Container, вам необходимо дополнительно добавить все пакеты Jar в каталоге /dependencies в свой проект.

1.3 Добавить в путь сборки

Скопируйте только что загруженные несколько пакетов jar в каталог lib вашего проекта, выберите Build Path правой кнопкой мыши -> Add to Build Path.

1.4 Начать отправку

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

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

/**
 *  Ниже приводится простой пример тестирования отправки. Это самый простой способ
 * @throws IOException
 * @throws MailAddressException 自定义异常,邮件地址不正确
 */
@Test
public void testSendSimple() throws MailAddressException {
    MimeMail mimeMail = MimeMail.Builder.initMailSender("smtp.163.com", "smtp",465, "youremailname@163.com","您的客户端授权码", false);
    List<String> to = new ArrayList<String>();// 收件人集合
    to.add("hongshuboy@qq.com");            //发给谁写在这,可以群发
    mimeMail.sendMail(to, "您有新的消息", "请到网站内查看"+new Date());
}

1.5 Дополнение

Если вам снова понадобится объект MimeMail в системе, просто вызовите метод MimeMail.Builder.initMailSender ещё раз, и он будет использовать одноэлементный режим напрямую, чтобы получить первый инициализированный объект, то есть после второго использования он будет напрямую получать первый объект MimeMail и больше не будет создавать его заново. Последующие вызовы могут быть неправильными параметрами.

Пример второго вызова:

MimeMail mail2 = MimeMail.Builder.initMailSender("hello", "world", 100, "a", "b",true);//这里参数可以随便填了
System.out.println(mail == mail2);//这里会输出true,因为直接拿了上一次的对象

Если 163 почтовый ящик сообщает об ошибке 554 DT:SPM, это означает, что он распознал, что вы отправляете спам, другие ошибки, пожалуйста, обратитесь к следующему документу. Проблемы с возвратом сообщений 163 почтового ящика

2. Эффективный способ инициализации

2.1 Настройка домена и пароля отправителя

Если вы не хотите использовать файлы конфигурации, вы можете пропустить эту часть и убедиться, что после включения POP3 / SMTP / IMAP вашего почтового ящика вы можете сразу перейти к следующей части 1.1 без использования свойств (самый простой способ) или 1.2 с использованием свойств.

src\main\resources\mail.properties

  1. На основе существующей конфигурации измените этот файл, введите свой домен отправителя и пароль, рекомендуется настроить 163 и QQ почтовые ящики, таким образом, если отправка не удалась, программа автоматически переключит отправителей для повторной отправки, обеспечивая высокий уровень успеха и незаметное переключение для пользователей.

  2. Если вы настроили только одного отправителя, нет необходимости изменять код, система будет использовать только этого отправителя для отправки (но вам нужно удалить конфигурацию spring, обратите внимание на часть A).

Откройте почтовый ящик POP3 / SMTP / IMAP

Чтобы использовать Java Mail, сначала включите POP3 / SMTP / IMAP в почтовом ящике, пароль в конфигурации не является вашим паролем входа, например, 163 почтовый ящик, также выберите пароль клиента в настройках и получите пароль авторизации, поместите его в файл конфигурации * (src \ main \ resources \ mail.properties) * в позиции mail.password.

A: Если вы настроили только один почтовый ящик

Вы хотите использовать только одного отправителя? Затем удалите <bean> тег в файле src \ main \ resources \ spring-mailx.xml, который не использует отправителя.

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

2.2 Наконец-то можно начать тестирование после простой конфигурации

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

Использование контейнера Spring для инициализации

Этот способ также прост в использовании и имеет значительное улучшение скорости. Клонировать проект на локальный компьютер

  1. Изменить файл mail.properties в папке src\main\resources (настроить содержимое над знаком равенства) (если вам нужен только один отправитель, вы можете настроить только его и обязательно выполнить третий шаг)

  2. (Необязательно) Изменить файл spring-mailx.xml в папке src\main\resources (если на втором шаге вы настроили только одного отправителя, здесь нужно удалить лишнего)

  3. (Необязательно) Если вам нужно отправлять вложения или отображать изображения в письмах, поместите вложения или изображения в папку src\main\resources и измените соответствующий исходный код в методе MimeMail.sendMail(List to, String subject, String Text, boolean retry) (комментарии очень понятные)

  4. [Непосредственно импортировать проект и использовать Maven для связывания этого проекта как зависимости] или [использовать Maven для повторной упаковки проекта (пропустите Maven Test или удалите файлы java в папке src\test, иначе будет ошибка) и импортируйте Jar]

  5. В файле spring.xml проекта импортируйте файл конфигурации spring-mailx.xml из simple mail, чтобы текущий проект мог использовать MimeMail для отправки писем. Используйте @Autowired для внедрения, где это необходимо. Смотрите демонстрацию ниже.

Метод использования компонента Spring Mail в файле spring.xml верхнего уровня проекта на шестом шаге

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

    <!-- Импортировать spring компонента почты -->
    <import resource="classpath*:spring-mailx.xml"/>
    <!-- Продолжить настройку -->
    <bean id="xxx" class="xxx.xxxx">
        ...
    </bean>

Обратите внимание на возможные ошибки:

  • Если используется верхний контейнер, два контейнера внутри не должны иметь <context:property-placeholder location="xx"/>, поместите этот узел в верхний файл spring.xml.

Если вы считаете, что это полезно для вас, поставьте звезду~

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

Обратная связь по вопросам

hongshu@weweb.top

starts

Пожертвование

Биткойн: 1MGLaexfJYyzz3CqSrssSX1fNhy8Mc7xwW

Ethereum: 0xf5C299A307e7fd1C2106faf52d3AF918c2835A58

Комментарии ( 0 )

Вы можете оставить комментарий после Вход в систему

Введение

Простой отправитель электронных писем на основе Spring Mail, отправка писем с помощью двух строк кода, поддерживает массовую рассылку, Java-письма. (Обновление остановлено, посетите GitHub) Развернуть Свернуть
Отмена

Обновления (2)

все

Участники

все

Недавние действия

Загрузить больше
Больше нет результатов для загрузки
1
https://api.gitlife.ru/oschina-mirror/hongshuboy-easymail.git
git@api.gitlife.ru:oschina-mirror/hongshuboy-easymail.git
oschina-mirror
hongshuboy-easymail
hongshuboy-easymail
master