Package org.ametys.plugins.newsletter

Class NewsletterDAO

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.plugins.newsletter.NewsletterDAO

All Implemented Interfaces:

LogEnabled, Component, Contextualizable, Serviceable

public class NewsletterDAO
extends AbstractLogEnabled
implements Serviceable, Component, Contextualizable

DAO for manipulating newsletter

Field Summary

Fields

Modifier and Type	Field	Description
static final String	__NEWSLETTER_CONTENT_TYPE	Newsletter content type
static final String	__SEND_TESTING_RIGHT	Right to send a test newsletter
static final String	__TEST_UNIQUE_ID_METADATA	Metadata test-unique-id
static final String	ROLE	The Avalon role

Constructor Summary

Constructors

Constructor	Description
NewsletterDAO()

Method Summary

Modifier and Type	Method	Description
protected String	_getBodyAsHtml(DefaultWebContent content, String dataHolderId, String language)	Get the newsletter HTML body
protected String	_getBodyAsText(DefaultWebContent content, String dataHolderId, String language)	Get the newsletter text body
protected String	_getSubject(DefaultWebContent content, String language)	Get the newsletter mail subject
void	contextualize(Context context)
Category	getCategory(String categoryID)	Get a category
Map<String,Object>	getNewsletterProperties(Content newsletter)	Gets newsletter's properties to JSON format
boolean	isSent(String newsletterId)	Determines if the newsletter was already sent
void	removeTestNewsletter(WebContent content, Site site)	Remove the test newsletter if it exists in live workspace
void	sendNewsletter(DefaultWebContent content, Map<String,String> recipients)	Send the newsletter to the recipients
void	sendNewsletter(DefaultWebContent content, Map<String,String> recipients, String dataHolderId)	Send the newsletter to the recipients
boolean	sendTestNewsletter(String newsletterId, String recipientEmail)	Send the newsletter to a single recipient, while ignoring the subscribers or the workflow state
void	service(ServiceManager smanager)

Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Field Details

ROLE

public static final String ROLE

The Avalon role

__SEND_TESTING_RIGHT

public static final String __SEND_TESTING_RIGHT

Right to send a test newsletter

See Also:

• Constant Field Values

__NEWSLETTER_CONTENT_TYPE

public static final String __NEWSLETTER_CONTENT_TYPE

Newsletter content type

See Also:

• Constant Field Values

__TEST_UNIQUE_ID_METADATA

public static final String __TEST_UNIQUE_ID_METADATA

Metadata test-unique-id

See Also:

• Constant Field Values

Constructor Details

NewsletterDAO

public NewsletterDAO()

Method Details

service

public void service(ServiceManager smanager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Throws:

ContextException

isSent

public boolean isSent(String newsletterId)

Determines if the newsletter was already sent

Parameters:

newsletterId - the id of newsletter

Returns:

true if the newsletter was already sent

getNewsletterProperties

public Map<String,Object> getNewsletterProperties(Content newsletter)

Gets newsletter's properties to JSON format

Parameters:

newsletter - The newsletter

Returns:

The newsletter's properties

sendTestNewsletter

public boolean sendTestNewsletter(String newsletterId,
 String recipientEmail)
                           throws IllegalAccessException

Send the newsletter to a single recipient, while ignoring the subscribers or the workflow state

Parameters:

newsletterId - The newsletter id

recipientEmail - The recipient

Returns:

True if the newsletter was sent

Throws:

IllegalAccessException - If a user tried to send a newsletter with insufficient rights

sendNewsletter

public void sendNewsletter(DefaultWebContent content,
 Map<String,String> recipients)
                    throws IOException

Send the newsletter to the recipients

Parameters:

content - The newsletter

recipients - The recipients of the newsletter

Throws:

IOException - If an error occurred

sendNewsletter

public void sendNewsletter(DefaultWebContent content,
 Map<String,String> recipients,
 String dataHolderId)
                    throws IOException

Send the newsletter to the recipients

Parameters:

content - The newsletter

recipients - The recipients of the newsletter

dataHolderId - The content to use as a data holder proxy for images. Can be null

Throws:

IOException - If an error occurred

_getSubject

protected String _getSubject(DefaultWebContent content,
 String language)

Get the newsletter mail subject

Parameters:

content - The content

language - The language to use

Returns:

The subject

_getBodyAsHtml

protected String _getBodyAsHtml(DefaultWebContent content,
 String dataHolderId,
 String language)
                         throws IOException

Get the newsletter HTML body

Parameters:

content - The content

dataHolderId - The data holder content to use as proxy images

language - The language to use

Returns:

The body

Throws:

IOException - if an I/O error occurred

_getBodyAsText

protected String _getBodyAsText(DefaultWebContent content,
 String dataHolderId,
 String language)
                         throws IOException

Get the newsletter text body

Parameters:

content - The content

dataHolderId - The data holder content to use as proxy images

language - The language to use

Returns:

The body

Throws:

IOException - if an I/O error occurred

getCategory

public Category getCategory(String categoryID)

Get a category

Parameters:

categoryID - The category id

Returns:

The category

removeTestNewsletter

public void removeTestNewsletter(WebContent content,
 Site site)
                          throws javax.jcr.RepositoryException

Remove the test newsletter if it exists in live workspace

Parameters:

content - The content

site - The site of the content

Throws:

javax.jcr.RepositoryException - If an error occurred