use 1.0.0
1 file changed
tree: 80595bdaee2840c701125ed7d7ace51ac0ae31ad
  1. .gitignore
  2. .sling-module.json
  5. Jenkinsfile
  8. bnd.bnd
  9. pom.xml
  10. src/

Build Status Test Status License

Apache Sling Commons Messaging Mail

This module is part of the Apache Sling project.

This module provides a simple layer on top of Jakarta Mail (former JavaMail) including a message builder and a service to send mails via SMTPS.

  • Mail Service: sends MIME messages.
  • Message Builder: builds plain text and HTML messages with attachments and inline images
  • Message ID Provider: allows overwriting default message IDs by custom ones


    MailService mailService;

    String subject = "Rudy, A Message to You";
    String text = "Stop your messing around\nBetter think of your future\nTime you straighten right out\nCreating problems in town\n…";
    String html = […];
    byte[] attachment = […];
    byte[] inline = […];

    MimeMessage message = mailService.getMessageBuilder()
        .from("", "Dandy Livingstone")
        .to("", "The Specials")
        .attachment(attachment, "image/png", "attachment.png")
        .inline(inline, "image/png", "inline")


Integration Tests

Integration tests require a running SMTP server. By default a GreenMail server is started.

An external SMTP server for validating messages with real mail clients can be used by setting required properties:

mvn clean install\
  -Dsling.test.mail.smtps.password=password\\\ Sender\\\ Recipient\\\ To