com.xpn.xwiki.plugin.mailsender
Class MailSenderPluginApi

java.lang.Object
  com.xpn.xwiki.api.Api
      com.xpn.xwiki.plugin.PluginApi<MailSenderPlugin>
          com.xpn.xwiki.plugin.mailsender.MailSenderPluginApi

All Implemented Interfaces:

MailSender

public class MailSenderPluginApi
extends com.xpn.xwiki.plugin.PluginApi<MailSenderPlugin>
implements MailSender

Plugin that brings powerful mailing capabilities. This is the wrapper accessible from in-document scripts.

Version:

$Id: MailSenderPluginApi.java 13030 2008-09-26 20:55:17Z sdumitriu $

See Also:

MailSender

Field Summary

Fields inherited from class com.xpn.xwiki.api.Api

context

Constructor Summary

MailSenderPluginApi(MailSenderPlugin plugin, com.xpn.xwiki.XWikiContext context)
API constructor.

Method Summary

Mail	createMail() A helper method for Velocity scripts since we cannot create Java objects from Velocity.
MailConfiguration	createMailConfiguration(com.xpn.xwiki.api.XWiki xwiki) A helper method for Velocity scripts since we cannot create Java objects from Velocity.
int	sendHtmlMessage(java.lang.String from, java.lang.String to, java.lang.String cc, java.lang.String bcc, java.lang.String subject, java.lang.String body, java.lang.String alternative, java.util.List<com.xpn.xwiki.api.Attachment> attachments) Sends an HTML mail, with a list of attachments
int	sendMail(Mail mail) Generic method for sending emails.
int	sendMail(Mail mail, MailConfiguration mailConfiguration) Generic method for sending emails.
int	sendMessageFromTemplate(java.lang.String from, java.lang.String to, java.lang.String cc, java.lang.String bcc, java.lang.String language, java.lang.String documentFullName, org.apache.velocity.VelocityContext vcontext) Uses an XWiki document to build the message subject and context, based on variables stored in the VelocityContext.
int	sendTextMessage(java.lang.String from, java.lang.String to, java.lang.String subject, java.lang.String message) Sends a simple text plain mail
int	sendTextMessage(java.lang.String from, java.lang.String to, java.lang.String cc, java.lang.String bcc, java.lang.String subject, java.lang.String message, java.util.List<com.xpn.xwiki.api.Attachment> attachments) Sends a simple text plain mail with a list of files attachments

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

getInternalPlugin, getPlugin, getProtectedPlugin, setPlugin

Methods inherited from class com.xpn.xwiki.api.Api

checkProgrammingRights, convert, convert, getXWikiContext, hasAccessLevel, hasAdminRights, hasProgrammingRights

Methods inherited from class java.lang.Object

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

Constructor Detail

MailSenderPluginApi

public MailSenderPluginApi(MailSenderPlugin plugin,
                           com.xpn.xwiki.XWikiContext context)

API constructor.

Parameters:

plugin - The wrapped plugin object.

context - Context of the request.

See Also:

PluginApi.PluginApi(com.xpn.xwiki.plugin.XWikiPluginInterface,XWikiContext)

Method Detail

sendHtmlMessage

public int sendHtmlMessage(java.lang.String from,
                           java.lang.String to,
                           java.lang.String cc,
                           java.lang.String bcc,
                           java.lang.String subject,
                           java.lang.String body,
                           java.lang.String alternative,
                           java.util.List<com.xpn.xwiki.api.Attachment> attachments)

Sends an HTML mail, with a list of attachments

Specified by:

sendHtmlMessage in interface MailSender

Parameters:

from - the sender

to - the recipient of the message

cc - carbon copy

bcc - hidden carbon copy

subject - the subject of the message

body - the body content of the mail

alternative - the alternative text offered to the mail client

attachments - List of com.xpn.xwiki.api.Attachment that will be attached to the mail.

Returns:

0 on success, -1 on failure. On failure the error message is stored in the XWiki context under the "error" key.

See Also:

MailSender.sendHtmlMessage(String, String, String, String, String, String, String, java.util.List)

sendTextMessage

public int sendTextMessage(java.lang.String from,
                           java.lang.String to,
                           java.lang.String subject,
                           java.lang.String message)

Sends a simple text plain mail

Specified by:

sendTextMessage in interface MailSender

Parameters:

from - the sender

to - the recipient of the message

subject - the subject of the message

message - the body of the message

Returns:

0 on success, -1 on failure. On failure the error message is stored in the XWiki context under the "error" key.

See Also:

MailSender.sendTextMessage(String, String, String, String)

sendTextMessage

public int sendTextMessage(java.lang.String from,
                           java.lang.String to,
                           java.lang.String cc,
                           java.lang.String bcc,
                           java.lang.String subject,
                           java.lang.String message,
                           java.util.List<com.xpn.xwiki.api.Attachment> attachments)

Sends a simple text plain mail with a list of files attachments

Specified by:

sendTextMessage in interface MailSender

Parameters:

from - the sender

to - the recipient of the message

cc - carbon copy

bcc - hidden carbon copy

subject - the subject of the message

message - the body of the message

attachments - List of com.xpn.xwiki.api.Attachment that will be attached to the mail.

Returns:

0 on success, -1 on failure. On failure the error message is stored in the XWiki context under the "error" key.

See Also:

MailSender.sendTextMessage(String, String, String, String, String, String, java.util.List)

sendMessageFromTemplate

public int sendMessageFromTemplate(java.lang.String from,
                                   java.lang.String to,
                                   java.lang.String cc,
                                   java.lang.String bcc,
                                   java.lang.String language,
                                   java.lang.String documentFullName,
                                   org.apache.velocity.VelocityContext vcontext)

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

Specified by:

sendMessageFromTemplate in interface MailSender

Parameters:

from - Email sender

to - Email recipient

cc - Email Carbon Copy

bcc - Email Hidden Carbon Copy

language - Language of the email

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

vcontext - Velocity context passed to the velocity renderer

Returns:

0 on success, -1 on failure. On failure the error message is stored in the XWiki context under the "error" key.

See Also:

MailSender.sendMessageFromTemplate(String, String, String, String, String, String, VelocityContext)

createMail

public Mail createMail()

A helper method for Velocity scripts since we cannot create Java objects from Velocity.

Specified by:

createMail in interface MailSender

Returns:

An empty mail message to be populated with recipient addresses, subject, message, etc.

See Also:

MailSender.createMail()

sendMail

public int sendMail(Mail mail)

Generic method for sending emails. The passed Mail object has to be populated by the caller to set the correct fields. All the other sendHtmlXXX() and sendTextXXX() methods are specialized helper versions of this generic method.

Specified by:

sendMail in interface MailSender

Parameters:

mail - the already populated mail Object to be sent

Returns:

0 on success, -1 on failure. On failure the error message is stored in the XWiki context under the "error" key.

See Also:

MailSender.sendMail(Mail)

createMailConfiguration

public MailConfiguration createMailConfiguration(com.xpn.xwiki.api.XWiki xwiki)

A helper method for Velocity scripts since we cannot create Java objects from Velocity.

Specified by:

createMailConfiguration in interface MailSender

Parameters:

xwiki - the XWiki object used to get the default values from the XWiki Preferences ("smtp_server" and "smtp_from").

Returns:

A mail server configuration, initialized with values from XWiki Preferences, but which can be overriden by users.

See Also:

MailSender.createMailConfiguration(com.xpn.xwiki.api.XWiki)

sendMail

public int sendMail(Mail mail,
                    MailConfiguration mailConfiguration)

Generic method for sending emails. The passed Mail object has to be populated by the caller to set the correct fields. The passed Mail Configuration allows the user to override the default connection properties (SMTP host, SMTP port, SMTP from, etc). All the other sendHtmlXXX() and sendTextXXX() methods are specialized helper versions of this generic method.

Specified by:

sendMail in interface MailSender

Parameters:

mail - the already populated mail Object to be sent

mailConfiguration - the configuration to use

Returns:

0 on success, -1 on failure. On failure the error message is stored in the XWiki context under the "error" key.

See Also:

MailSender.sendMail(Mail, MailConfiguration)