com.xpn.xwiki.plugin.mailsender
Class MailSenderPlugin

java.lang.Object
  com.xpn.xwiki.plugin.XWikiDefaultPlugin
      com.xpn.xwiki.plugin.mailsender.MailSenderPlugin

All Implemented Interfaces:

com.xpn.xwiki.plugin.XWikiPluginInterface

public class MailSenderPlugin
extends com.xpn.xwiki.plugin.XWikiDefaultPlugin

Plugin that brings powerful mailing capabilities.

Version:

$Id: MailSenderPlugin.java 18438 2009-04-10 13:53:45Z vmassol $

See Also:

MailSender

Field Summary

static java.lang.String	EMAIL_XWIKI_CLASS_NAME
static int	ERROR
static int	ERROR_TEMPLATE_EMAIL_OBJECT_NOT_FOUND
static java.lang.String	ID
protected static java.lang.String	URL_SEPARATOR

Constructor Summary

MailSenderPlugin(java.lang.String name, java.lang.String className, com.xpn.xwiki.XWikiContext context)

Method Summary

void	addAttachments(javax.mail.Multipart mpart, java.util.List<com.xpn.xwiki.api.Attachment> attachments, com.xpn.xwiki.XWikiContext context) Add attachments to a multipart message
javax.mail.Multipart	createMimeMultipart(Mail mail, com.xpn.xwiki.XWikiContext context) Creates a Multipart MIME Message (multiple content-types within the same message) from an existing mail
protected java.lang.String	evaluate(java.lang.String property, org.apache.velocity.context.Context context) Evaluates a String property containing Velocity
protected java.lang.String	getFileName(java.lang.String path) Get a file name from its path
java.lang.String	getName()
com.xpn.xwiki.api.Api	getPluginApi(com.xpn.xwiki.plugin.XWikiPluginInterface plugin, com.xpn.xwiki.XWikiContext context)
void	init(com.xpn.xwiki.XWikiContext context)
protected com.xpn.xwiki.objects.classes.BaseClass	initMailClass(com.xpn.xwiki.XWikiContext context) Creates the Mail XWiki Class
static java.lang.String[]	parseAddresses(java.lang.String email) Split comma separated list of emails
org.apache.velocity.VelocityContext	prepareVelocityContext(java.lang.String fromAddr, java.lang.String toAddr, java.lang.String ccAddr, java.lang.String bccAddr, org.apache.velocity.VelocityContext vcontext, com.xpn.xwiki.XWikiContext context) Prepares a Mail Velocity context
boolean	sendMail(Mail mailItem, MailConfiguration mailConfiguration, com.xpn.xwiki.XWikiContext context) Send a single Mail
boolean	sendMail(Mail mailItem, com.xpn.xwiki.XWikiContext context) Send a single Mail
int	sendMailFromTemplate(java.lang.String templateDocFullName, java.lang.String from, java.lang.String to, java.lang.String cc, java.lang.String bcc, java.lang.String language, org.apache.velocity.VelocityContext vcontext, com.xpn.xwiki.XWikiContext context) Uses an XWiki document to build the message subject and context, based on variables stored in the VelocityContext.
boolean	sendMails(java.util.Collection<Mail> emails, MailConfiguration mailConfiguration, com.xpn.xwiki.XWikiContext context) Send a Collection of Mails (multiple emails)
boolean	sendMails(java.util.Collection<Mail> emails, com.xpn.xwiki.XWikiContext context) Send a Collection of Mails (multiple emails)
void	virtualInit(com.xpn.xwiki.XWikiContext context)

Methods inherited from class com.xpn.xwiki.plugin.XWikiDefaultPlugin

beginParsing, beginRendering, commonTagsHandler, downloadAttachment, endParsing, endRendering, endRenderingHandler, flushCache, flushCache, getClassName, insidePREHandler, outsidePREHandler, setClassName, setName, startRenderingHandler

Methods inherited from class java.lang.Object

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

Field Detail

ERROR_TEMPLATE_EMAIL_OBJECT_NOT_FOUND

public static int ERROR_TEMPLATE_EMAIL_OBJECT_NOT_FOUND

ERROR

public static int ERROR

EMAIL_XWIKI_CLASS_NAME

public static final java.lang.String EMAIL_XWIKI_CLASS_NAME

See Also:

Constant Field Values

ID

public static final java.lang.String ID

See Also:

Constant Field Values

URL_SEPARATOR

protected static final java.lang.String URL_SEPARATOR

See Also:

Constant Field Values

Constructor Detail

MailSenderPlugin

public MailSenderPlugin(java.lang.String name,
                        java.lang.String className,
                        com.xpn.xwiki.XWikiContext context)

See Also:

XWikiDefaultPlugin.XWikiDefaultPlugin(String,String,com.xpn.xwiki.XWikiContext)

Method Detail

init

public void init(com.xpn.xwiki.XWikiContext context)

Specified by:

init in interface com.xpn.xwiki.plugin.XWikiPluginInterface

Overrides:

init in class com.xpn.xwiki.plugin.XWikiDefaultPlugin

See Also:

XWikiDefaultPlugin.init(XWikiContext)

virtualInit

public void virtualInit(com.xpn.xwiki.XWikiContext context)

Specified by:

virtualInit in interface com.xpn.xwiki.plugin.XWikiPluginInterface

Overrides:

virtualInit in class com.xpn.xwiki.plugin.XWikiDefaultPlugin

See Also:

XWikiDefaultPlugin.virtualInit(XWikiContext)

getPluginApi

public com.xpn.xwiki.api.Api getPluginApi(com.xpn.xwiki.plugin.XWikiPluginInterface plugin,
                                          com.xpn.xwiki.XWikiContext context)

Specified by:

getPluginApi in interface com.xpn.xwiki.plugin.XWikiPluginInterface

Overrides:

getPluginApi in class com.xpn.xwiki.plugin.XWikiDefaultPlugin

See Also:

XWikiDefaultPlugin.getPluginApi(XWikiPluginInterface, XWikiContext)

parseAddresses

public static java.lang.String[] parseAddresses(java.lang.String email)

Split comma separated list of emails

Parameters:

email - comma separated list of emails

Returns:

An array containing the emails

initMailClass

protected com.xpn.xwiki.objects.classes.BaseClass initMailClass(com.xpn.xwiki.XWikiContext context)
                                                         throws com.xpn.xwiki.XWikiException

Creates the Mail XWiki Class

Parameters:

context - Context of the request

Returns:

the Mail XWiki Class

Throws:

com.xpn.xwiki.XWikiException

addAttachments

public void addAttachments(javax.mail.Multipart mpart,
                           java.util.List<com.xpn.xwiki.api.Attachment> attachments,
                           com.xpn.xwiki.XWikiContext context)
                    throws com.xpn.xwiki.XWikiException,
                           java.io.IOException,
                           javax.mail.MessagingException

Add attachments to a multipart message

Parameters:

mpart - Multipart message

attachments - List of attachments

Throws:

com.xpn.xwiki.XWikiException

java.io.IOException

javax.mail.MessagingException

createMimeMultipart

public javax.mail.Multipart createMimeMultipart(Mail mail,
                                                com.xpn.xwiki.XWikiContext context)
                                         throws javax.mail.MessagingException,
                                                com.xpn.xwiki.XWikiException,
                                                java.io.IOException

Creates a Multipart MIME Message (multiple content-types within the same message) from an existing mail

Parameters:

mail - The original Mail

Returns:

The Multipart MIME message

Throws:

javax.mail.MessagingException

com.xpn.xwiki.XWikiException

java.io.IOException

evaluate

protected java.lang.String evaluate(java.lang.String property,
                                    org.apache.velocity.context.Context context)
                             throws java.lang.Exception

Evaluates a String property containing Velocity

Parameters:

property - The String property

context - Context of the request

Returns:

The evaluated String

Throws:

java.lang.Exception

getFileName

protected java.lang.String getFileName(java.lang.String path)

Get a file name from its path

Parameters:

path - The file path

Returns:

The file name

getName

public java.lang.String getName()

Specified by:

getName in interface com.xpn.xwiki.plugin.XWikiPluginInterface

Overrides:

getName in class com.xpn.xwiki.plugin.XWikiDefaultPlugin

prepareVelocityContext

public org.apache.velocity.VelocityContext prepareVelocityContext(java.lang.String fromAddr,
                                                                  java.lang.String toAddr,
                                                                  java.lang.String ccAddr,
                                                                  java.lang.String bccAddr,
                                                                  org.apache.velocity.VelocityContext vcontext,
                                                                  com.xpn.xwiki.XWikiContext context)

Prepares a Mail Velocity context

Parameters:

fromAddr - Mail from

toAddr - Mail to

ccAddr - Mail cc

bccAddr - Mail bcc

vcontext - The Velocity context to prepare

Returns:

The prepared context

sendMail

public boolean sendMail(Mail mailItem,
                        com.xpn.xwiki.XWikiContext context)
                 throws javax.mail.MessagingException,
                        java.io.UnsupportedEncodingException

Send a single Mail

Parameters:

mailItem - The Mail to send

Returns:

True if the the email has been sent

Throws:

javax.mail.MessagingException

java.io.UnsupportedEncodingException

sendMail

public boolean sendMail(Mail mailItem,
                        MailConfiguration mailConfiguration,
                        com.xpn.xwiki.XWikiContext context)
                 throws javax.mail.MessagingException,
                        java.io.UnsupportedEncodingException

Send a single Mail

Parameters:

mailItem - The Mail to send

Returns:

True if the the email has been sent

Throws:

javax.mail.MessagingException

java.io.UnsupportedEncodingException

sendMails

public boolean sendMails(java.util.Collection<Mail> emails,
                         com.xpn.xwiki.XWikiContext context)
                  throws javax.mail.MessagingException,
                         java.io.UnsupportedEncodingException

Send a Collection of Mails (multiple emails)

Parameters:

emails - Mail Collection

Returns:

True in any case (TODO ?)

Throws:

javax.mail.MessagingException

java.io.UnsupportedEncodingException

sendMails

public boolean sendMails(java.util.Collection<Mail> emails,
                         MailConfiguration mailConfiguration,
                         com.xpn.xwiki.XWikiContext context)
                  throws javax.mail.MessagingException,
                         java.io.UnsupportedEncodingException

Send a Collection of Mails (multiple emails)

Parameters:

emails - Mail Collection

Returns:

True in any case (TODO ?)

Throws:

javax.mail.MessagingException

java.io.UnsupportedEncodingException

sendMailFromTemplate

public int sendMailFromTemplate(java.lang.String templateDocFullName,
                                java.lang.String from,
                                java.lang.String to,
                                java.lang.String cc,
                                java.lang.String bcc,
                                java.lang.String language,
                                org.apache.velocity.VelocityContext vcontext,
                                com.xpn.xwiki.XWikiContext context)
                         throws com.xpn.xwiki.XWikiException

Uses an XWiki document to build the message subject and context, based on variables stored in the VelocityContext. Sends the email.

Parameters:

templateDocFullName - Full name of the template to be used (example: XWiki.MyEmailTemplate). The template needs to have an XWiki.Email object attached

from - Email sender

to - Email recipient

cc - Email Carbon Copy

bcc - Email Hidden Carbon Copy

language - Language of the email

vcontext - Velocity context passed to the velocity renderer

Returns:

True if the email has been sent

Throws:

com.xpn.xwiki.XWikiException