4.8.4.3. Настройка параметров отправки email
Параметры отправки email могут быть настроены с помощью перечисленных ниже свойств приложения. Все они являются параметрами времени выполнения и хранятся в базе данных, однако могут быть переопределены для конкретного блока Middleware в его файле app.properties
.
Все параметры отправки email доступны через конфигурационный интерфейс EmailerConfig
.
-
cuba.email.fromAddress
- адрес отправителя по умолчанию. Принимается во внимание, если не указан атрибутEmailInfo.from
.Значение по умолчанию:
DoNotReply@localhost
-
cuba.email.smtpHost
- адрес SMTP сервера.Значение по умолчанию:
test.host
-
cuba.email.smtpPort
- порт SMTP сервера.Значение по умолчанию:
25
-
cuba.email.smtpAuthRequired
- требуется ли аутентификация на SMTP сервере. Соответствует параметруmail.smtp.auth
, передаваемому при создании объектаjavax.mail.Session
.Значение по умолчанию:
false
-
cuba.email.smtpStarttlsEnable
- задает использование командыSTARTTLS
при аутентификации на SMTP сервере. Соответствует параметруmail.smtp.starttls.enable
, передаваемому при создании объектаjavax.mail.Session
.Значение по умолчанию:
false
-
cuba.email.smtpUser
- имя пользователя для аутентификации на SMTP сервере. -
cuba.email.smtpPassword
- пароль пользователя для аутентификации на SMTP сервере. -
cuba.email.delayCallCount
- используется при асинхронной отправке email из очереди для пропуска нескольких первых вызововEmailManager.queueEmailsToSend()
сразу после старта сервера, чтобы снизить нагрузку во время инициализации приложения. Отправка email начнется следующим вызовом.Значение по умолчанию:
2
-
cuba.email.messageQueueCapacity
- при асинхронной отправке количество сообщений, читаемое из очереди и отправляемое за один вызовEmailManager.queueEmailsToSend()
.Значение по умолчанию:
100
-
cuba.email.defaultSendingAttemptsCount
- при асинхронной отправке email количество попыток отправки по умолчанию. Принимается во внимание, если при вызовеEmailer.sendEmailAsync()
не указан параметрattemptsCount
.Значение по умолчанию:
10
-
cuba.email.maxSendingTimeSec
- максимальное предполагаемое время в секундах, требуемое для отправки сообщения на SMTP сервер. Используется при асинхронной отправке для оптимизации выборки объектовSendingMessage
из очереди в БД.Значение по умолчанию: 120
-
cuba.email.sendAllToAdmin
- указывает, что все сообщения должны отправляться на адресcuba.email.adminAddress
, независимо от указанного адреса получателя. Этот параметр рекомендуется использовать во время отладки системы.Значение по умолчанию:
false
-
cuba.email.adminAddress
- адрес, на который отправляются все сообщения при включенном свойствеcuba.email.sendAllToAdmin
.Значение по умолчанию:
admin@localhost
-
cuba.emailerUserLogin
- логин пользователя системы, под которым регистрируется механизм асинхронной отправки email для того, чтобы иметь возможность сохранить информацию в базе данных. Рекомендуется создать отдельного пользователя (напримерemailer
) без пароля, чтобы под его именем нельзя было войти через пользовательский интерфейс приложения. Это полезно для поиска в логе сервера сообщений, касаемых отсылки email.Значение по умолчанию:
admin
Просмотреть текущие значения параметров, а также отправить тестовое сообщение, можно с помощью JMX-бина app-core.cuba:type=Emailer
.