org.opencms.scheduler.jobs
Class CmsPublishJob

java.lang.Object
  extended by org.opencms.scheduler.jobs.CmsPublishJob
All Implemented Interfaces:
I_CmsScheduledJob

public class CmsPublishJob
extends java.lang.Object
implements I_CmsScheduledJob

Scheduled job for time based publishing.

This class is called via the scheduled job backoffice to publish a project at a given time.

Per default, it publishes all new, edited and deleted resources in the project which are not locked. To unlock all resources in the project before publishing, add the parameter unlock=true in the scheduled job configuration. In addition you are able to perform a link validation before publishing the project by adding the parameter linkcheck=true. It is possible to send an email to a user in OpenCms in case somthing went wrong during this process. To do so specifiy a parametermail-to-user=username_in_opencms.

Since:
6.0.0
Version:
$Revision: 1.17 $
Author:
Michael Emmerich, Peter Bonrad

Field Summary
static java.lang.String PARAM_LINKCHECK
          Linkcheck parameter.
static java.lang.String PARAM_UNLOCK
          Unlock parameter.
static java.lang.String PARAM_USER
          Mail to user parameter.
 
Constructor Summary
CmsPublishJob()
           
 
Method Summary
 java.lang.String launch(CmsObject cms, java.util.Map parameters)
          This method will be called when this scheduled job is executed.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

PARAM_LINKCHECK

public static final java.lang.String PARAM_LINKCHECK
Linkcheck parameter.

See Also:
Constant Field Values

PARAM_UNLOCK

public static final java.lang.String PARAM_UNLOCK
Unlock parameter.

See Also:
Constant Field Values

PARAM_USER

public static final java.lang.String PARAM_USER
Mail to user parameter.

See Also:
Constant Field Values
Constructor Detail

CmsPublishJob

public CmsPublishJob()
Method Detail

launch

public java.lang.String launch(CmsObject cms,
                               java.util.Map parameters)
                        throws java.lang.Exception
Description copied from interface: I_CmsScheduledJob
This method will be called when this scheduled job is executed.

Depending on the configuration of this job, a new instance of the configured class will be instantiated every time the job is launched, or a new instance will be generated only the first time the job is launched, and re-used afterwards.

The result String will be written to the OpenCms logfile in the org.opencms.scheduler.CmsScheduleManager channel, on INFO log level.

Specified by:
launch in interface I_CmsScheduledJob
Parameters:
cms - will be initialized with the configured users cms context
parameters - the configured parameters
Returns:
a String that will be written to the OpenCms logfile
Throws:
java.lang.Exception - if something goes wrong
See Also:
I_CmsScheduledJob.launch(org.opencms.file.CmsObject, java.util.Map)