SendMailTransformer

Summary

The SendMailTransformer send mails with optional attachments using a SMTP server and delivers furthermore a status report of each sent mail.

Basic information

Documentation

Using SendMailTransfomer with Cocoon 2.1.8 or recent

Simple example

Add this to the transformers in your sitemap

<map:transformer name="sendmail" src="org.apache.cocoon.mail.transformation.SendMailTransformer"/>

Add this in a pipeline in your sitemap

<map:match pattern="mailme">
    <map:generate src="sendmail.xml"/>
    <map:transform type="sendmail"/>
    <map:serialize type="xml"/>
</map:match>

Example of sendmail.xml. The values in this document override those from the sitemap. You can remove them here if you have set them in the sitemap.

<?xml version="1.0" encoding="UTF-8"?>
<document xmlns:email="http://apache.org/cocoon/transformation/sendmail">
    <email:sendmail>
        <email:smtphost>my.smtp.host</email:smtphost>
        <email:smtpport>25</email:smtpport>
        <email:from>its@me.here</email:from>
        <email:to>thats@you.there</email:to>
        <email:subject>My first mail</email:subject>
        <email:body>The body of the mail</email:body>
    </email:sendmail>
</document>

Advanced examples and parameters

See the  APIdoc

Problem & Solution

Problem

It doesn't matter which SMTP-Host (or SMTP-Port) you fill in, you get the following error:

"Could not connect to SMTP host: localhost, port: 25 (java.net.ConnectException: Connection refused: connect)"

if you have a mailserver running on your machine on port 25:

Exception sending mail java.lang.ClassCastException: java.lang.String

Solution

Cocoon uses geronimo-spec-javamail-*.jar and geronimo-spec-activation-*.jar instead of Sun JavaMail and JAF.

Due to licensing issues, it is not possible to ship the Sun jars with Cocoon, but without these jars, Cocoon would not compile. Therefore the geronimo jars are included.

Remove geronimo-spec-javamail-*.jar and geronimo-spec-activation-*.jar from WEB-INF/lib and restart Cocoon.

If this still doesn't work remove geronimo-spec-javamail-*.jar from /lib/optional and remove it in lib/jars.xml (or comment it with <!-- -->). Copy src/blocks/mail/mocks from Cocoon 2.1.7 to the same directory in Cocoon 2.1.8 and rebuild Cocoon. Then add Sun JavaMail and Activation into WEB-INF/lib and remove geronimo-spec-activation-*.jar.