Package com.onec.mail

Class MailService

java.lang.Object

com.onec.mail.MailService

public class MailService
extends Object

High-level mail facade. Three modes of use:

• send(MailMessage) - synchronous dispatch via the active provider.
• queue(MailMessage) - durable queue via the mail outbox; relayed asynchronously with retry.
• send(Object, String, String...) - render a registered MailTemplate bound to target.getClass() and dispatch (queued or direct based on config).

Default routing of send(Object, String, String...) is controlled by onec.mail.use-outbox.

Recipients on the MailSuppressionList (hard bounces, complaints, unsubscribes) are dropped before dispatch; a message left with no recipients is skipped entirely.

Constructor Summary

Constructors

Constructor	Description
MailService(MailDispatcher dispatcher, MailTemplateRegistry templates, MailRenderer renderer, MailProperties properties, MailOutbox outbox, MailSuppressionList suppressionList, com.fasterxml.jackson.databind.ObjectMapper objectMapper)

Method Summary

Modifier and Type	Method	Description
UUID	queue(MailMessage message)	Durable queue.
UUID	queue(MailMessage message, String idempotencyKey)	Durable queue with an idempotency key: enqueuing twice with the same key dispatches once.
UUID	queue(Object target, String templateName, String idempotencyKey, Map<String,Object> extras, String... recipients)
UUID	queue(Object target, String templateName, Map<String,Object> extras, String... recipients)
void	send(MailMessage message)	Synchronous dispatch via the configured provider.
void	send(Object target, String templateName, String... recipients)
void	send(Object target, String templateName, Map<String,Object> extras, String... recipients)	Render a template registered against target.getClass() and dispatch.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

MailService

public MailService(MailDispatcher dispatcher,
 MailTemplateRegistry templates,
 MailRenderer renderer,
 MailProperties properties,
 MailOutbox outbox,
 MailSuppressionList suppressionList,
 com.fasterxml.jackson.databind.ObjectMapper objectMapper)

Method Details

send

public void send(MailMessage message)

Synchronous dispatch via the configured provider. Suppressed recipients are removed first.

queue

public UUID queue(MailMessage message)

Durable queue. Picked up by the relay and dispatched asynchronously with retry/backoff.

queue

public UUID queue(MailMessage message,
 String idempotencyKey)

Durable queue with an idempotency key: enqueuing twice with the same key dispatches once. Use a stable business id (e.g. "booking-confirmed:" + booking.number) to make retries safe.

send

public void send(Object target,
 String templateName,
 Map<String,Object> extras,
 String... recipients)

Render a template registered against target.getClass() and dispatch.

send

public void send(Object target,
 String templateName,
 String... recipients)

queue

public UUID queue(Object target,
 String templateName,
 Map<String,Object> extras,
 String... recipients)

queue

public UUID queue(Object target,
 String templateName,
 String idempotencyKey,
 Map<String,Object> extras,
 String... recipients)