er.javamail
Class ERWOMailDelivery

java.lang.Object
  er.javamail.ERWOMailDelivery

public class ERWOMailDelivery
extends java.lang.Object

Drop-in replacement for WOMailDelivery.

ERWOMailDelivery operates just the same as WOMailDelivery, and has all of the same limitations and weird API. However, instead of using the Sun's broken* and unsupported sun.net.smtp.SmtpClient, it uses JavaMail.

*sun.net.smtp.SmtpClient doesn't put addresses in angle brackets when sending the SMTP MAIL FROM command. Many SMTP servers won't work with it.

See Also:

com.webobjects.appserver.WOMailDelivery

Author:

Jonathan 'Wolf' Rentzsch (jon at redshed dot net)

Constructor Summary

protected

ERWOMailDelivery() Default constructor (don't use).

Method Summary

java.lang.String	composeComponentEmail(java.lang.String fromEmailAddress, com.webobjects.foundation.NSArray toEmailAddresses, com.webobjects.foundation.NSArray bccEmailAddresses, java.lang.String subject, com.webobjects.appserver.WOComponent component, boolean sendNow) Creates and optionally sends a WOComponent as email.
java.lang.String	composePlainTextEmail(java.lang.String fromEmailAddress, com.webobjects.foundation.NSArray toEmailAddresses, com.webobjects.foundation.NSArray bccEmailAddresses, java.lang.String subject, java.lang.String message, boolean sendNow) Creates and optionally sends a plain text email.
void	sendEmail(java.lang.String mailString) Sends the RFC822 mail string created with either composePlainTextEmail(String,NSArray,NSArray,String,String,boolean) or composeComponentEmail(String,NSArray,NSArray,String,WOComponent,boolean).
static ERWOMailDelivery	sharedInstance()
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ERWOMailDelivery

protected ERWOMailDelivery()

Default constructor (don't use). Use sharedInstance() instead.

Method Detail

sharedInstance

public static ERWOMailDelivery sharedInstance()

Returns:

The shared instance.

composePlainTextEmail

public java.lang.String composePlainTextEmail(java.lang.String fromEmailAddress,
                                              com.webobjects.foundation.NSArray toEmailAddresses,
                                              com.webobjects.foundation.NSArray bccEmailAddresses,
                                              java.lang.String subject,
                                              java.lang.String message,
                                              boolean sendNow)

Creates and optionally sends a plain text email.

Parameters:

fromEmailAddress - Originating email address. Required.

toEmailAddresses - Destination email address. Required.

bccEmailAddresses - Array of Strings containing additional addressed to BCC. Null OK.

subject - Subject the the message. Null OK.

message - Body the the message. Required.

sendNow - Whether to send the message right away. If you're going to send the message right away, it's faster to set sendNow to true than set it to false and calling sendEmail(String) later.

composeComponentEmail

public java.lang.String composeComponentEmail(java.lang.String fromEmailAddress,
                                              com.webobjects.foundation.NSArray toEmailAddresses,
                                              com.webobjects.foundation.NSArray bccEmailAddresses,
                                              java.lang.String subject,
                                              com.webobjects.appserver.WOComponent component,
                                              boolean sendNow)

Creates and optionally sends a WOComponent as email.

Parameters:

fromEmailAddress - Originating email address. Required.

toEmailAddresses - Destination email address. Required.

bccEmailAddresses - Array of Strings containing additional addressed to BCC. Null OK.

subject - Subject the the message. Null OK.

component - Body the the message. Required.

sendNow - Whether to send the message right away. If you're going to send the message right away, it's faster to set sendNow to true than set it to false and calling sendEmail(String) later.

sendEmail

public void sendEmail(java.lang.String mailString)

Sends the RFC822 mail string created with either composePlainTextEmail(String,NSArray,NSArray,String,String,boolean) or composeComponentEmail(String,NSArray,NSArray,String,WOComponent,boolean). It's faster to call either method with the sendNow parameter set to true than to use this method.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object