Redirectpublic class Redirect extends AbstractRedirect A mailet providing configurable redirection services.
Can produce listserver, forward and notify behaviour, with the original
message intact, attached, appended or left out altogether.
It differs from {@link Resend} because
(i) some defaults are different,
notably for the following parameters: <recipients>, <to>,
<reversePath> and <inline>;
(ii) because it allows the use of the <static> parameter;.
Use Resend if you need full control, Redirect if
the more automatic behaviour of some parameters is appropriate.
This built in functionality is controlled by the configuration as laid out below.
In the table please note that the parameters controlling message headers
accept the "unaltered" value, whose meaning is to keep the associated
header unchanged and, unless stated differently, corresponds to the assumed default
if the parameter is missing.
The configuration parameters are:
<recipients> |
A comma delimited list of addresses for recipients of
this message; it will use the "to" list if not specified, and "unaltered"
if none of the lists is specified.
These addresses will only appear in the To: header if no "to" list is
supplied.
Such addresses can contain "full names", like
Mr. John D. Smith <john.smith@xyz.com>.
The list can include constants "sender", "from", "replyTo", "postmaster", "reversePath", "recipients", "to", "null" and "unaltered";
"replyTo" uses the ReplyTo header if available, otherwise the
From header if available, otherwise the Sender header if available, otherwise the return-path;
"from" is made equivalent to "sender", and "to" is made equivalent to "recipients";
"null" is ignored.
|
<to> |
A comma delimited list of addresses to appear in the To: header;
the email will be delivered to any of these addresses if it is also in the recipients
list.
The recipients list will be used if this list is not supplied;
if none of the lists is specified it will be "unaltered".
Such addresses can contain "full names", like
Mr. John D. Smith <john.smith@xyz.com>.
The list can include constants "sender", "from", "replyTo", "postmaster", "reversePath", "recipients", "to", "null" and "unaltered";
"from" uses the From header if available, otherwise the Sender header if available,
otherwise the return-path;
"replyTo" uses the ReplyTo header if available, otherwise the
From header if available, otherwise the Sender header if available, otherwise the return-path;
"recipients" is made equivalent to "to";
if "null" is specified alone it will remove this header.
|
<sender> |
A single email address to appear in the From: and Return-Path: headers and become the sender.
It can include constants "sender", "postmaster" and "unaltered";
"sender" is equivalent to "unaltered".
Default: "unaltered".
|
<message> |
A text message to insert into the body of the email.
Default: no message is inserted.
|
<inline> |
One of the following items:
- unaltered The original message is the new
message, for forwarding/aliasing
- heads The
headers of the original message are appended to the message
- body The
body of the original is appended to the new message
- all Both
headers and body are appended
- none Neither
body nor headers are appended
Default: "body".
|
<attachment> |
One of the following items:
- heads The headers of the original
are attached as text
- body The body of the original
is attached as text
- all Both
headers and body are attached as a single text file
- none Nothing is attached
- message The original message is attached as type message/rfc822,
this means that it can, in many cases, be opened, resent, fw'd, replied
to etc by email client software.
Default: "none".
|
<passThrough> |
true or false, if true the original message continues in the
mailet processor after this mailet is finished. False causes the original
to be stopped.
Default: false.
|
<fakeDomainCheck> |
true or false, if true will check if the sender domain is valid.
Default: true.
|
<attachError> |
true or false, if true any error message available to the
mailet is appended to the message body (except in the case of inline ==
unaltered).
Default: false.
|
<replyTo> |
A single email address to appear in the Reply-To: header.
It can include constants "sender", "postmaster" "null" and "unaltered";
if "null" is specified it will remove this header.
Default: "unaltered".
|
<reversePath> |
A single email address to appear in the Return-Path: header.
It can include constants "sender", "postmaster" and "null";
if "null" is specified then it will set it to <>, meaning "null return path".
Notice: the "unaltered" value is not allowed.
Default: the value of the <sender> parameter, if set, otherwise remains unaltered.
|
<subject> |
An optional string to use as the subject.
Default: keep the original message subject.
|
<prefix> |
An optional subject prefix prepended to the original message
subject, or to a new subject specified with the <subject> parameter.
For example: [Undeliverable mail].
Default: "".
|
<isReply> |
true or false, if true the IN_REPLY_TO header will be set to the
id of the current message.
Default: false.
|
<debug> |
true or false. If this is true it tells the mailet to write some debugging
information to the mailet log.
Default: false.
|
<static> |
true or false. If this is true it tells the mailet that it can
reuse all the initial parameters (to, from, etc) without re-calculating
their values. This will boost performance where a redirect task
doesn't contain any dynamic values. If this is false, it tells the
mailet to recalculate the values for each e-mail processed.
Default: false.
|
Example:
<mailet match="RecipientIs=test@localhost" class="Redirect">
<recipients>x@localhost, y@localhost, z@localhost</recipients>
<to>list@localhost</to>
<sender>owner@localhost</sender>
<message>sent on from James</message>
<inline>unaltered</inline>
<passThrough>FALSE</passThrough>
<replyTo>postmaster</replyTo>
<prefix xml:space="preserve">[test mailing] </prefix>
<!-- note the xml:space="preserve" to preserve whitespace -->
<static>TRUE</static>
</mailet>
and:
<mailet match="All" class="Redirect">
<recipients>x@localhost</recipients>
<sender>postmaster</sender>
<message xml:space="preserve">Message marked as spam:</message>
<inline>heads</inline>
<attachment>message</attachment>
<passThrough>FALSE</passThrough>
<attachError>TRUE</attachError>
<replyTo>postmaster</replyTo>
<prefix>[spam notification]</prefix>
<static>TRUE</static>
</mailet>
replyto can be used instead of
replyTo; such name is kept for backward compatibility. |
Methods Summary |
---|
protected java.lang.String[] | getAllowedInitParameters()Gets the expected init parameters.
String[] allowedArray = {
"static",
"debug",
"passThrough",
"fakeDomainCheck",
"inline",
"attachment",
"message",
"recipients",
"to",
"replyTo",
"replyto",
"reversePath",
"sender",
"subject",
"prefix",
"attachError",
"isReply"
};
return allowedArray;
| protected int | getInLineType()
return getTypeCode(getInitParameter("inline","body"));
| public java.lang.String | getMailetInfo()Returns a string describing this mailet.
return "Redirect Mailet";
| protected java.util.Collection | getRecipients()
Collection newRecipients = new HashSet();
String addressList = getInitParameter("recipients",getInitParameter("to"));
// if nothing was specified, return <CODE>null</CODE> meaning no change
if (addressList == null) {
return null;
}
try {
InternetAddress[] iaarray = InternetAddress.parse(addressList, false);
for (int i = 0; i < iaarray.length; i++) {
String addressString = iaarray[i].getAddress();
MailAddress specialAddress = getSpecialAddress(addressString,
new String[] {"postmaster", "sender", "from", "replyTo", "reversePath", "unaltered", "recipients", "to", "null"});
if (specialAddress != null) {
newRecipients.add(specialAddress);
} else {
newRecipients.add(new MailAddress(iaarray[i]));
}
}
} catch (Exception e) {
throw new MessagingException("Exception thrown in getRecipients() parsing: " + addressList, e);
}
if (newRecipients.size() == 0) {
throw new MessagingException("Failed to initialize \"recipients\" list; empty <recipients> init parameter found.");
}
return newRecipients;
| protected org.apache.mailet.MailAddress | getReversePath()
String addressString = getInitParameter("reversePath");
if(addressString != null) {
MailAddress specialAddress = getSpecialAddress(addressString,
new String[] {"postmaster", "sender", "null"});
if (specialAddress != null) {
return specialAddress;
}
try {
return new MailAddress(addressString);
} catch(Exception e) {
throw new MessagingException("Exception thrown in getReversePath() parsing: " + addressString, e);
}
}
return null;
| protected org.apache.mailet.MailAddress | getReversePath(org.apache.mailet.Mail originalMail)
MailAddress reversePath = super.getReversePath(originalMail);
if (reversePath == null) {
reversePath = getSender(originalMail);
}
return reversePath;
| protected javax.mail.internet.InternetAddress[] | getTo()
InternetAddress[] iaarray = null;
String addressList = getInitParameter("to",getInitParameter("recipients"));
// if nothing was specified, return null meaning no change
if (addressList == null) {
return null;
}
try {
iaarray = InternetAddress.parse(addressList, false);
for(int i = 0; i < iaarray.length; ++i) {
String addressString = iaarray[i].getAddress();
MailAddress specialAddress = getSpecialAddress(addressString,
new String[] {"postmaster", "sender", "from", "replyTo", "reversePath", "unaltered", "recipients", "to", "null"});
if (specialAddress != null) {
iaarray[i] = specialAddress.toInternetAddress();
}
}
} catch (Exception e) {
throw new MessagingException("Exception thrown in getTo() parsing: " + addressList, e);
}
if (iaarray.length == 0) {
throw new MessagingException("Failed to initialize \"to\" list; empty <to> init parameter found.");
}
return iaarray;
| protected boolean | isStatic()
return isStatic;
|
|