Package org.ametys.plugins.newsletter.auto

Class AutomaticNewslettersSchedulable

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.plugins.core.impl.schedule.AbstractStaticSchedulable

org.ametys.plugins.newsletter.auto.AutomaticNewslettersSchedulable

All Implemented Interfaces:

Schedulable, LogEnabled, PluginAware, Component, Configurable, Contextualizable, Serviceable

public class AutomaticNewslettersSchedulable
extends AbstractStaticSchedulable

Runnable engine that creates the automatic newsletter contents.

Nested Class Summary

Nested classes/interfaces inherited from class org.ametys.plugins.core.impl.schedule.AbstractStaticSchedulable

AbstractStaticSchedulable.SchedulableParameterParser

Field Summary

Fields

Modifier and Type	Field	Description
protected AutomaticNewsletterExtensionPoint	_autoNewsletterEP	The automatic newsletter extension point.
protected CategoryProviderExtensionPoint	_categoryEP	The newsletter category provider extension point.
protected ContentFilterExtensionPoint	_contentFilterEP	The content filter extension point.
protected ContentFilterHelper	_contentFilterHelper	The content filter helper.
protected Map<String,List<String>>	_filterContentIdCache	A map of the content IDs by filter, reset on each run.
protected I18nUtils	_i18nUtils	The i18n utils.
protected static final String	_NEWSLETTER_CONTENT_TYPE	The newsletter content type.
protected AmetysObjectResolver	_resolver	The ametys object resolver.
protected Date	_runDate	The instant the engine was started.
protected SiteManager	_siteManager	The site manager.
protected int	_wfInitialActionId	The workflow initial action ID.
protected List<Integer>	_wfValidateActionIds	A list of action IDs to validate a newsletter from initial step.
protected String	_workflowName	The newsletter workflow name.
protected WorkflowProvider	_workflowProvider	The workflow provider.

Fields inherited from class org.ametys.plugins.core.impl.schedule.AbstractStaticSchedulable

_acceptConcurrentExecution, _context, _description, _iconGlyph, _iconLarge, _iconMedium, _iconSmall, _id, _label, _parameters, _pluginName, _private, _schedulableParameterTypeExtensionPoint, _smanager, _startTime, _userManager, PROGRESSION_TRACKER

Constructor Summary

Constructors

Constructor	Description
AutomaticNewslettersSchedulable()

Method Summary

Modifier and Type	Method	Description
void	configure(Configuration configuration)	Configure the engine (to be called by the scheduler or the action).
protected void	createAndValidateAutomaticNewsletter(String siteName, String sitemapName, Category category, CategoryProvider provider, AutomaticNewsletter autoNewsletter)	Create an automatic newsletter content in a category.
protected void	createAutomaticNewsletters(String siteName, String sitemapName)	Test each category in a site and sitemap and launch the newsletter creation if needed.
protected WorkflowAwareContent	createNewsletterContent(String siteName, String language, Category category, AutomaticNewsletter autoNewsletter, long newsletterNumber, Map<String,AutomaticNewsletterFilterResult> filterResults)	Create the newsletter content.
protected boolean	createNow(AutomaticNewsletter autoNewsletter)	Test if an automatic newsletter content has to be created now.
void	execute(JobExecutionContext context, ContainerProgressionTracker progressionTracker)	The action to perform when a trigger is fired.
protected Map<String,AutomaticNewsletterFilterResult>	getFilterResults(String siteName, String sitemapName, AutomaticNewsletter autoNewsletter)	Get the list of contents for the automatic newsletter filters.
protected String	getNewsletterTitle(String language, Category category, AutomaticNewsletter autoNewsletter, long newsletterNumber)	Compute the newsletter title.
protected long	getNextNumber(Category category, CategoryProvider provider, String siteName, String language)	Compute the newsletter number.
protected boolean	hasResults(Collection<AutomaticNewsletterFilterResult> results)	Test if there is at least one content in a collection of filter results.
void	service(ServiceManager manager)
protected boolean	testMonth(Collection<Integer> dayNumbers, ZonedDateTime runDate)	Test if we are in the configured month creation period.
protected boolean	testWeek(Collection<Integer> dayNumbers, ZonedDateTime runDate)	Test if we are in the configured week creation period.
protected void	validateNewsletter(WorkflowAwareContent newsletterContent)	Validate the newly created newsletter.

Methods inherited from class org.ametys.plugins.core.impl.schedule.AbstractStaticSchedulable

acceptConcurrentExecution, contextualize, getDescription, getIconGlyph, getIconLarge, getIconMedium, getIconSmall, getId, getLabel, getParameters, getProgressionTracker, isPrivate, setPluginInfo

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

_NEWSLETTER_CONTENT_TYPE

protected static final String _NEWSLETTER_CONTENT_TYPE

The newsletter content type.

See Also:

• Constant Field Values

_runDate

protected Date _runDate

The instant the engine was started.

_workflowName

protected String _workflowName

The newsletter workflow name.

_wfInitialActionId

protected int _wfInitialActionId

The workflow initial action ID.

_wfValidateActionIds

protected List<Integer> _wfValidateActionIds

A list of action IDs to validate a newsletter from initial step.

_filterContentIdCache

protected Map<String,List<String>> _filterContentIdCache

A map of the content IDs by filter, reset on each run.

_resolver

protected AmetysObjectResolver _resolver

The ametys object resolver.

_siteManager

protected SiteManager _siteManager

The site manager.

_workflowProvider

protected WorkflowProvider _workflowProvider

The workflow provider.

_autoNewsletterEP

protected AutomaticNewsletterExtensionPoint _autoNewsletterEP

The automatic newsletter extension point.

_categoryEP

protected CategoryProviderExtensionPoint _categoryEP

The newsletter category provider extension point.

_contentFilterEP

protected ContentFilterExtensionPoint _contentFilterEP

The content filter extension point.

_contentFilterHelper

protected ContentFilterHelper _contentFilterHelper

The content filter helper.

_i18nUtils

protected I18nUtils _i18nUtils

The i18n utils.

Constructor Details

AutomaticNewslettersSchedulable

public AutomaticNewslettersSchedulable()

Method Details

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Overrides:

service in class AbstractStaticSchedulable

Throws:

ServiceException

configure

public void configure(Configuration configuration)
               throws ConfigurationException

Configure the engine (to be called by the scheduler or the action).

Specified by:

configure in interface Configurable

Overrides:

configure in class AbstractStaticSchedulable

Parameters:

configuration - the component configuration.

Throws:

ConfigurationException - if an error occurs in the configuration.

execute

public void execute(JobExecutionContext context,
 ContainerProgressionTracker progressionTracker)
             throws Exception

Description copied from interface: Schedulable

The action to perform when a trigger is fired. Do not manually call this method.

Parameters:

context - the context

progressionTracker - The progression tracker

Throws:

Exception - if an error occurred

createAutomaticNewsletters

protected void createAutomaticNewsletters(String siteName,
 String sitemapName)

Test each category in a site and sitemap and launch the newsletter creation if needed.

Parameters:

siteName - the site name.

sitemapName - the sitemap name.

createAndValidateAutomaticNewsletter

protected void createAndValidateAutomaticNewsletter(String siteName,
 String sitemapName,
 Category category,
 CategoryProvider provider,
 AutomaticNewsletter autoNewsletter)

Create an automatic newsletter content in a category.

Parameters:

sitemapName - the sitemap name.

siteName - the site name.

category - the newsletter category.

provider - the category provider.

autoNewsletter - the associated automatic newsletter.

getFilterResults

protected Map<String,AutomaticNewsletterFilterResult> getFilterResults(String siteName,
 String sitemapName,
 AutomaticNewsletter autoNewsletter)

Get the list of contents for the automatic newsletter filters.

Parameters:

siteName - the site name.

sitemapName - the sitemap name.

autoNewsletter - the automatic newsletter.

Returns:

the results, indexed by filter name (in the auto newsletter).

createNewsletterContent

protected WorkflowAwareContent createNewsletterContent(String siteName,
 String language,
 Category category,
 AutomaticNewsletter autoNewsletter,
 long newsletterNumber,
 Map<String,AutomaticNewsletterFilterResult> filterResults)
                                                throws com.opensymphony.workflow.WorkflowException

Create the newsletter content.

Parameters:

siteName - the site name.

language - the language.

category - the category.

autoNewsletter - the automatic newsletter.

newsletterNumber - the newsletter number.

filterResults - the filter results (content IDs for each filter).

Returns:

The newly created newsletter content.

Throws:

com.opensymphony.workflow.WorkflowException - if a workflow error occurs.

validateNewsletter

protected void validateNewsletter(WorkflowAwareContent newsletterContent)
                           throws com.opensymphony.workflow.WorkflowException

Validate the newly created newsletter.

Parameters:

newsletterContent - the newsletter content, must be in draft state.

Throws:

com.opensymphony.workflow.WorkflowException - if a workflow error occurs.

getNewsletterTitle

protected String getNewsletterTitle(String language,
 Category category,
 AutomaticNewsletter autoNewsletter,
 long newsletterNumber)

Compute the newsletter title.

Parameters:

language - the language.

category - the newsletter category.

autoNewsletter - the automatic newsletter.

newsletterNumber - the newsletter number.

Returns:

the newsletter title.

getNextNumber

protected long getNextNumber(Category category,
 CategoryProvider provider,
 String siteName,
 String language)

Compute the newsletter number.

Parameters:

category - the newsletter category.

provider - the category provider.

siteName - the site name.

language - the language.

Returns:

the newsletter number.

hasResults

protected boolean hasResults(Collection<AutomaticNewsletterFilterResult> results)

Test if there is at least one content in a collection of filter results.

Parameters:

results - a collection of filter results.

Returns:

true if at least one filter yielded a result, false otherwise.

createNow

protected boolean createNow(AutomaticNewsletter autoNewsletter)

Test if an automatic newsletter content has to be created now.

Parameters:

autoNewsletter - the automatic newsletter.

Returns:

true if an automatic newsletter content has to be created now, false otherwise.

testMonth

protected boolean testMonth(Collection<Integer> dayNumbers,
 ZonedDateTime runDate)

Test if we are in the configured month creation period.

Parameters:

dayNumbers - the days in the month on which a newsletter is to be created.

runDate - the instant the engine was launched.

Returns:

true if we are in the configured month creation period, false otherwise.

testWeek

protected boolean testWeek(Collection<Integer> dayNumbers,
 ZonedDateTime runDate)

Test if we are in the configured week creation period.

Parameters:

dayNumbers - the days in the month on which a newsletter is to be created.

runDate - the instant the engine was launched.

Returns:

true if we are in the configured week creation period, false otherwise.