[seam-dev] Is this the mail API you always wanted?

[Dan Allen]

Seam devs,

Cody is looking for some feedback on the mail module [1] before he drafts a
reference guide and puts the API on ice.

Seam mail is important because, let's face it, the Java Mail API needs a
makeover. Thankfully, the CDI programming model offers the necessary hooks
to create a modernized mail API capable of deep integration with the Java EE
platform (specifically the Java Mail API and container-managed sessions).

Seam Mail offers a fluent API that makes sending e-mail in Java a painless
experience. But an e-mail is nothing without the content. That's why Seam
Mail offers several templating options, such as Velocity, as well as an
extensible template SPI, to allow you to select your templating solution of
choice. With Seam Mail, you'll be sending e-mail from your application in no
time.

Is this how you imagined it would be?

Basic:

   @Inject
   private Instance<MailMessage> mailMessage;

   @Inject
   private Session session;

   mailMessage.get()
         .from("Seam Framework", "seam at jboss.org")
         .to("John Smith", "john.smith at acme.com")
         .subject("Text Message from Seam Mail - " +
java.util.UUID.randomUUID().toString())
         .textBody(text)
         .send(session);

Velocity:

   @Inject
   private Instance<VelocityMailMessage> velocityMailMessage;

   @Inject
   private Session session;

   velocityMailMessage.get().from("Seam Framework", "seam at jboss.org")
         .to(person.getName(), person.getEmail())
         .subject("HTML Message from Seam Mail - " +
java.util.UUID.randomUUID().toString())
         .templateHTMLFromClassPath("template.html.vm")
         .put("version", "Seam 3")
         .importance(MessagePriority.HIGH)
         .addAttachment(new URL("
http://www.seamframework.org/themes/sfwkorg/img/seam_icon_large.png"),
"seamLogo.png", ContentDisposition.INLINE);
         .send(session);

We look forward to your feedback.

-Dan

[1] http://github.com/seam/mail
http://seamframework.org/Seam3/Mail

-- 
Dan Allen
Principal Software Engineer, Red Hat | Author of Seam in Action
Registered Linux User #231597

http://www.google.com/profiles/dan.j.allen#about
http://mojavelinux.com
http://mojavelinux.com/seaminaction
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/seam-dev/attachments/20110207/224db76d/attachment.html