Mail

Mail Handler

The MailHandler component provides an API for sending email notifications from a Strolch application.

Implementations

SmtpMailHandler: Sends real emails via an SMTP server.
SimulatedMailHandler: Logs emails to the console or a file instead of sending them. Useful for development and testing.

Features

Synchronous and Asynchronous Sending: Send emails immediately or in the background.
Attachments: Support for adding multiple attachments to emails.
Encryption and Signing: Support for sending encrypted and signed emails.

Sending an Email

MailHandler mailHandler = agent.getComponent(MailHandler.class);

mailHandler.sendMailAsync(
    "recipient@example.com",
    "Subject line",
    "Body text of the email"
);

Sending with Attachments

MailAttachment attachment = new MailAttachment("report.pdf", "application/pdf", pdfData);
mailHandler.sendMailWithAttachmentsAsync(
    "recipient@example.com",
    "Report",
    "Please find the report attached.",
    List.of(attachment)
);

Configuration

The MailHandler is configured in StrolchConfiguration.xml.

<Component>
    <name>MailHandler</name>
    <api>li.strolch.handler.mail.MailHandler</api>
    <impl>li.strolch.handler.mail.SmtpMailHandler</impl>
    <Properties>
        <fromAddr>Strolch System &lt;system@example.com&gt;</fromAddr>
        <username>user@example.com</username>
        <password>XXX</password>
        <auth>true</auth>
        <startTls>true</startTls>
        <host>smtp.example.com</host>
        <port>587</port>
    </Properties>
</Component>

To use the simulation mode:

<Component>
    <name>MailHandler</name>
    <api>li.strolch.handler.mail.MailHandler</api>
    <impl>li.strolch.handler.mail.SimulatedMailHandler</impl>
</Component>