Package org.ametys.cms.workflow.archive

Class ArchiveContentsSchedulable

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

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

org.ametys.cms.workflow.archive.ArchiveContentsSchedulable

All Implemented Interfaces:

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

Direct Known Subclasses:

ArchiveContentsSchedulable

public class ArchiveContentsSchedulable
extends AbstractStaticSchedulable

Runnable engine that archive the contents that have an scheduled archiving date set before the current date.

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 AmetysObjectResolver	_ametysResolver	The ametys object resolver.
protected Set<String>	_archiveRights	The user e-mail notification will be sent to users that have this at least one of this rights.
protected String	_baseUrl	The server base URL.
protected ContentHelper	_contentHelper	The content helper
protected Context	_environmentContext	The cocoon environment context.
protected I18nUtils	_i18nUtils	The i18n utils.
protected org.slf4j.Logger	_logger	The logger.
protected String	_mailFrom	The content of "from" field in emails.
protected ServiceManager	_manager	The service manager.
protected RightManager	_rightManager	The rights manager
protected SourceResolver	_sourceResolver	The avalon source resolver.
protected String	_sysadminMail	The sysadmin mail address, to which will be sent the report e-mail.
protected String	_userErrorMailBody	The user notification error mail body i18n key.
protected String	_userErrorMailSubject	The user notification error mail subject i18n key.
protected String	_userMailBody	The user notification mail body i18n key.
protected String	_userMailSubject	The user notification mail subject i18n key.

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, _userLanguagesManager, _userManager, PROGRESSION_TRACKER

Constructor Summary

Constructors

Constructor	Description
ArchiveContentsSchedulable()

Method Summary

Modifier and Type	Method	Description
protected Map<String,Set<User>>	_getAuthorizedContributorsByLanguage(Content content)	Get the authorized contributors to receive mail notification
protected String	_getContentsListAsString(List<Content> contents, Locale locale)	Get the contents list as String
protected String	_getContentTitle(Content content, Locale locale)	Get content title for mail
protected String	_getRequestURI(Content content)	Get the request URI to set in mail
protected void	_sendMailsToUsers(String subject, String htmlBody, Set<User> users, String from)	Send the emails to users (contributors)
void	configure(Configuration configuration)	Configure the engine (called by the scheduler).
void	contextualize(Context context)
void	execute(JobExecutionContext context, ContainerProgressionTracker progressionTracker)	The action to perform when a trigger is fired.
protected List<String>	getAdminEmailParams(List<Content> archivedContents, List<Content> contentsWithError, Locale locale)	Get the report e-mail parameters.
protected String	getArchiveActionUri(String contentId)	Get the pipeline uri for the archive action
protected List<String>	getBodyParamsForContributors(Content content, boolean archived, Locale locale)	Get email body parameters
protected String	getContentUri(Content content, boolean archived)	Get the content uri
protected void	sendErrorMailToContributors(Content content, Map<String,Set<User>> usersByLanguage)	Send the mail to alert users that an error has occurred while trying to archive the content.
protected void	sendMailToAdministrator(List<Content> archivedContents, List<Content> contentsWithError)	Send the archive report e-mail.
protected void	sendMailToContributors(Content content, Map<String,Set<User>> usersByLanguage)	Send the mail to alert users that the content has been archived.
void	service(ServiceManager manager)
protected void	setRequestAttributes(Request request, Content content)	Set the necessary request attributes

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

acceptConcurrentExecution, 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

_logger

protected org.slf4j.Logger _logger

The logger.

_manager

protected ServiceManager _manager

The service manager.

_baseUrl

protected String _baseUrl

The server base URL.

_environmentContext

protected Context _environmentContext

The cocoon environment context.

_ametysResolver

protected AmetysObjectResolver _ametysResolver

The ametys object resolver.

_sourceResolver

protected SourceResolver _sourceResolver

The avalon source resolver.

_rightManager

protected RightManager _rightManager

The rights manager

_i18nUtils

protected I18nUtils _i18nUtils

The i18n utils.

_contentHelper

protected ContentHelper _contentHelper

The content helper

_mailFrom

protected String _mailFrom

The content of "from" field in emails.

_sysadminMail

protected String _sysadminMail

The sysadmin mail address, to which will be sent the report e-mail.

_archiveRights

protected Set<String> _archiveRights

The user e-mail notification will be sent to users that have this at least one of this rights.

_userMailBody

protected String _userMailBody

The user notification mail body i18n key.

_userMailSubject

protected String _userMailSubject

The user notification mail subject i18n key.

_userErrorMailBody

protected String _userErrorMailBody

The user notification error mail body i18n key.

_userErrorMailSubject

protected String _userErrorMailSubject

The user notification error mail subject i18n key.

Constructor Details

ArchiveContentsSchedulable

public ArchiveContentsSchedulable()

Method Details

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Overrides:

service in class AbstractStaticSchedulable

Throws:

ServiceException

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Overrides:

contextualize in class AbstractStaticSchedulable

Throws:

ContextException

configure

public void configure(Configuration configuration)
               throws ConfigurationException

Configure the engine (called by the scheduler).

Specified by:

configure in interface Configurable

Overrides:

configure in class AbstractStaticSchedulable

Parameters:

configuration - the component configuration.

Throws:

ConfigurationException - If an error occurred

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

setRequestAttributes

protected void setRequestAttributes(Request request,
 Content content)

Set the necessary request attributes

Parameters:

request - The request

content - The content

getArchiveActionUri

protected String getArchiveActionUri(String contentId)

Get the pipeline uri for the archive action

Parameters:

contentId - the current contend id

Returns:

a pipeline uri

sendMailToAdministrator

protected void sendMailToAdministrator(List<Content> archivedContents,
 List<Content> contentsWithError)

Send the archive report e-mail.

Parameters:

archivedContents - The list of archived contents

contentsWithError - The list of contents with error

getAdminEmailParams

protected List<String> getAdminEmailParams(List<Content> archivedContents,
 List<Content> contentsWithError,
 Locale locale)

Get the report e-mail parameters.

Parameters:

archivedContents - The list of archived contents

contentsWithError - The list of contents with error

locale - The locale

Returns:

the e-mail parameters.

_getContentsListAsString

protected String _getContentsListAsString(List<Content> contents,
 Locale locale)

Get the contents list as String

Parameters:

contents - The contents

locale - The locale in which to get the contents

Returns:

the list of contents as String

_getContentTitle

protected String _getContentTitle(Content content,
 Locale locale)

Get content title for mail

Parameters:

content - the content

locale - The locale in which to get the content title

Returns:

the content title

_getAuthorizedContributorsByLanguage

protected Map<String,Set<User>> _getAuthorizedContributorsByLanguage(Content content)

Get the authorized contributors to receive mail notification

Parameters:

content - The content to be archived

Returns:

The user logins

sendMailToContributors

protected void sendMailToContributors(Content content,
 Map<String,Set<User>> usersByLanguage)

Send the mail to alert users that the content has been archived.

Parameters:

content - The archived content

usersByLanguage - The users by language

getBodyParamsForContributors

protected List<String> getBodyParamsForContributors(Content content,
 boolean archived,
 Locale locale)

Get email body parameters

Parameters:

content - the archived content

archived - true if the content has archived

locale - The locale of the mail. Cannot be null.

Returns:

The mail parameters

getContentUri

protected String getContentUri(Content content,
 boolean archived)

Get the content uri

Parameters:

content - the archived content

archived - true if the content has archived

Returns:

the content uri

sendErrorMailToContributors

protected void sendErrorMailToContributors(Content content,
 Map<String,Set<User>> usersByLanguage)

Send the mail to alert users that an error has occurred while trying to archive the content.

Parameters:

content - The content

usersByLanguage - The users by language

_getRequestURI

protected String _getRequestURI(Content content)

Get the request URI to set in mail

Parameters:

content - The content. Can be null

Returns:

the request URI

_sendMailsToUsers

protected void _sendMailsToUsers(String subject,
 String htmlBody,
 Set<User> users,
 String from)

Send the emails to users (contributors)

Parameters:

subject - the e-mail subject.

htmlBody - the e-mail body.

users - users to send the mail to.

from - the address sending the e-mail.