com.highqsoft.cron

Class CronService

java.lang.Object

com.highqsoft.jvmservice.JVMService

com.highqsoft.cron.CronService

public class CronService
extends JVMService

The CronService Service class. This class is used to simulate the UNIX cron daemon on windows systems.

It should be configured like a cron job via the normal text file that is specified via the property keyword CronService.CronTable.
The periodical time of execution is given by 5 fields separated by white spaces. The command is appended in the same tesxt line. Comment lines are leaded by one of these characters #;$&%

• minutes
  a value from 0 to 59 that assignes the minutes of a hour.
• hours
  a value from 0 to 23 that assignes the hours of a day.
• day of month
  a value from 1 to 31 that assignes the day of a month.
• months
  a value from 1 to 12 that assignes the month of a year.
• day of week
  a value from 0 to 6 that assignes the day of a week.

It is possible to assign more than one value per field, the values must be separated by a colon (,). A star (*) means all allowed values and a minus (-) defines a range.

A possible parameter string is:
0,30 17 * * 1-5 to your job
At every day from Monday to Friday (1-5) at 17:00 and 17:30 every week in the year.

59 23 * * 6 to your job
At every Saturday in the week at 23:59.

Property Keyword	Datatype	Default	Description
CronService.TableFile	File	$SYSTEM_ROOT/cron.tab	The name of the cron table file.
CronService.Debug	boolean	false	Set this to true to get verbose output.

Since:

$Date: 2017/04/06 13:28:54 $

Version:

$Revision: 1.9 $

Author:

Andreas Hofmann

See Also:

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	CronService.Job

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	COMMENT
protected boolean	debug
protected CronService.Job[]	jobs
protected javax.swing.event.EventListenerList	listeners
protected java.util.Properties	properties
protected static java.util.Map<java.lang.String,java.lang.String>	RESERVED
static java.lang.String	version

Fields inherited from class com.highqsoft.jvmservice.JVMService

appThread, CONTROLS_PARAMCHANGE, CONTROLS_PAUSABLE, CONTROLS_SHUTDOWN, CONTROLS_STOPPABLE, ERR_OUT, STD_OUT, WAIT_HINT

Constructor Summary

Constructors

Constructor and Description
CronService() The constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected int[]	analize(java.lang.String value, int min, int max)
protected CronService.Job	createJob(java.lang.String line, java.lang.String[] arr) Create a job from line.
java.lang.String	getVersion()
int	getWaitHint() Get the time in milliseconds in that is needed for application to stop.
void	init(java.lang.String[] param) Set the application parameters.
void	jobTerminated(CronService.Job job)
static void	main(java.lang.String[] args)
protected int[]	normalize(int[] values, int min, int max)
void	pause() Pause the FileServerService thread.
protected CronService.Job[]	readTableFile(java.io.File cronTabFile) Read the cron table.
void	restart() Restart the FileServerService thread.
void	resume() Resume the FileServerService thread.
void	setEnvironment(java.lang.String key, java.lang.String value) Set environment variables.
void	start() Start the application.
void	stop() Stop the FileServerService thread.

Methods inherited from class com.highqsoft.jvmservice.JVMService

errOut, errOut, getCallingClassName, getLogLevel, getLogType, requestStopService, sendServiceRunning, setControlsAccepted, stdOut, stdOut

Methods inherited from class java.lang.Object

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

Field Detail

COMMENT

public static final java.lang.String COMMENT

See Also:

Constant Field Values

RESERVED

protected static final java.util.Map<java.lang.String,java.lang.String> RESERVED

version

public static final java.lang.String version

See Also:

Constant Field Values

jobs

protected CronService.Job[] jobs

debug

protected boolean debug

properties

protected java.util.Properties properties

listeners

protected javax.swing.event.EventListenerList listeners

Constructor Detail

CronService

public CronService()

The constructor.

Method Detail

getVersion

public java.lang.String getVersion()

Overrides:

getVersion in class JVMService

setEnvironment

public void setEnvironment(java.lang.String key,
                  java.lang.String value)

Set environment variables.

Specified by:

setEnvironment in class JVMService

Parameters:

key - The name of the variable.

value - The value of the variable.

init

public void init(java.lang.String[] param)

Set the application parameters.

Overrides:

init in class JVMService

Parameters:

param - The array containig the parameter strings.

readTableFile

protected CronService.Job[] readTableFile(java.io.File cronTabFile)
                                   throws java.io.FileNotFoundException,
                                          java.io.IOException

Read the cron table.

Parameters:

cronTabFile - The table file.

Throws:

java.io.FileNotFoundException - If the file is not available.

java.io.IOException - If an read error occurs.

jobTerminated

public void jobTerminated(CronService.Job job)

createJob

protected CronService.Job createJob(java.lang.String line,
                        java.lang.String[] arr)

Create a job from line.

Parameters:

line - The text line.

arr - the line splitted at pattern \s*

Returns:

the found job definition.

analize

protected int[] analize(java.lang.String value,
            int min,
            int max)

normalize

protected int[] normalize(int[] values,
              int min,
              int max)

start

public void start()

Start the application.

Specified by:

start in class JVMService

stop

public void stop()

Stop the FileServerService thread.

Specified by:

stop in class JVMService

restart

public void restart()

Restart the FileServerService thread.

pause

public void pause()

Pause the FileServerService thread.

Specified by:

pause in class JVMService

resume

public void resume()

Resume the FileServerService thread.

Specified by:

resume in class JVMService

getWaitHint

public int getWaitHint()

Get the time in milliseconds in that is needed for application to stop.

Overrides:

getWaitHint in class JVMService

Returns:

the wait hint for the service control manager.

main

public static void main(java.lang.String[] args)