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 String	__NEWSLETTER_CONTENT_TYPE	Newsletter content type
static String	__SEND_TESTING_RIGHT	Right to send a test newsletter
static String	__TEST_UNIQUE_ID_METADATA	Metadata test-unique-id
private CategoryProviderExtensionPoint	_categoryProviderEP
private Context	_context
private CurrentUserProvider	_currentUserProvider
private RenderingContextHandler	_renderingContextHandler
private Repository	_repository
private AmetysObjectResolver	_resolver
private SiteManager	_siteManager
private SourceResolver	_sourceResolver
static String	ROLE	The Avalon role

Constructor Summary

Constructors

Constructor	Description
NewsletterDAO()

Method Summary

Modifier and Type	Method	Description
private String	_createDataHolderContent(Site site, WebContent realContent, String uid, RichText richText)
protected String	_getBodyAsHtml(DefaultWebContent content, String dataHolderId)	Get the newsletter HTML body
protected String	_getBodyAsText(DefaultWebContent content, String dataHolderId)	Get the newsletter text body
protected String	_getSubject(DefaultWebContent content)	Get the newsletter mail subject
private String	_useDataHolderContent(Site site, WebContent realContent, String uid)
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 Detail

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

_resolver

private AmetysObjectResolver _resolver

_currentUserProvider

private CurrentUserProvider _currentUserProvider

_renderingContextHandler

private RenderingContextHandler _renderingContextHandler

_sourceResolver

private SourceResolver _sourceResolver

_categoryProviderEP

private CategoryProviderExtensionPoint _categoryProviderEP

_context

private Context _context

_siteManager

private SiteManager _siteManager

_repository

private Repository _repository

Constructor Detail

NewsletterDAO

public NewsletterDAO()

Method Detail

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

_useDataHolderContent

private String _useDataHolderContent(Site site,
                                     WebContent realContent,
                                     String uid)

_createDataHolderContent

private String _createDataHolderContent(Site site,
                                        WebContent realContent,
                                        String uid,
                                        RichText richText)
                                 throws RepositoryException,
                                        IOException

Throws:

RepositoryException

IOException

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)

Get the newsletter mail subject

Parameters:

content - The content

Returns:

The subject

_getBodyAsHtml

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

Get the newsletter HTML body

Parameters:

content - The content

dataHolderId - The data holder content to use as proxy images

Returns:

The body

Throws:

IOException - if an I/O error occurred

_getBodyAsText

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

Get the newsletter text body

Parameters:

content - The content

dataHolderId - The data holder content to use as proxy images

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 RepositoryException

Remove the test newsletter if it exists in live workspace

Parameters:

content - The content

site - The site of the content

Throws:

RepositoryException - If an error occurred