uws.job.parameters

Class DestructionTimeController

java.lang.Object

uws.job.parameters.DestructionTimeController

All Implemented Interfaces:

java.io.Serializable, InputParamController

public class DestructionTimeController
extends java.lang.Object
implements InputParamController, java.io.Serializable

Let controlling the destruction time of all jobs managed by a UWS. Thus it is possible to set a default and a maximum value. Moreover you can indicate whether the destruction time of jobs can be modified by the user or not.

Notes:

• By default, the destruction time can be modified by anyone without any limitation. There is no default value (that means jobs may stay forever).
• You can specify a destruction time (default or maximum value) in two ways: by an exact date-time or by an interval of time from the initialization (expressed in the second, minutes, hours, days, months or years).

The logic of the destruction time is set in this class. Here it is:

• If no value is specified by the UWS client, the default value is returned.
• If no default value is provided, the maximum destruction date is returned.
• If no maximum value is provided, there is no destruction.

Version:

4.1 (11/2014)

Author:

Grégory Mantelet (CDS;ARI)

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DestructionTimeController.DateField Represents a date/time field.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	allowModification Indicates whether the destruction time of jobs can be modified.
protected int	defaultInterval The default interval from the initialization to the destruction of the concerned job.
protected DestructionTimeController.DateField	defaultIntervalField The date-time field on which the default interval applies.
protected java.util.Date	defaultTime The default destruction time.
protected int	maxInterval The maximum interval from the initialization to the destruction of the concerned job.
protected DestructionTimeController.DateField	maxIntervalField The date-time field on which the maximum interval applies.
protected java.util.Date	maxTime The maximum destruction time.
static int	NO_INTERVAL Default value of an interval: a null interval.

Constructor Summary

Constructors

Constructor and Description
DestructionTimeController()

Method Summary

Modifier and Type	Method and Description
boolean	allowModification() Tells whether the destruction time of any managed job can be modified.
void	allowModification(boolean allowModification) Lets indicating whether the destruction time of any managed job can be modified.
java.lang.Object	check(java.lang.Object value) Checks the value of the controlled parameter and builds a new object from this value.
java.lang.Object	getDefault() Returns the default value of the controlled parameter.
int	getDefaultDestructionInterval() Gets the default interval value.
java.util.Date	getDefaultDestructionTime() Gets the default destruction time: either computed with an interval of time or obtained directly by a default destruction time.
DestructionTimeController.DateField	getDefaultIntervalField() Gets the date-time field of the default interval.
int	getMaxDestructionInterval() Gets the maximum interval value.
java.util.Date	getMaxDestructionTime() Gets the maximum destruction time: either computed with an interval of time or obtained directly by a maximum destruction time.
DestructionTimeController.DateField	getMaxIntervalField() Gets the date-time field of the maximum interval.
void	setDefaultDestructionInterval(int defaultDestructionInterval) Sets the default interval in minutes from the initialization to the destruction of the concerned job.
void	setDefaultDestructionInterval(int defaultDestructionInterval, DestructionTimeController.DateField timeField) Sets the default interval (in the given unit) from the initialization to the destruction of the concerned job.
void	setDefaultDestructionTime(java.util.Date defaultDestructionTime) Sets the default destruction time.
void	setMaxDestructionInterval(int maxDestructionInterval) Sets the maximum interval in minutes from the initialization to the destruction of the concerned job.
void	setMaxDestructionInterval(int maxDestructionInterval, DestructionTimeController.DateField timeField) Sets the maximum interval (in the given unit) from the initialization to the destruction of the concerned job.
void	setMaxDestructionTime(java.util.Date maxDestructionTime) Sets the maximum destruction time.

Methods inherited from class java.lang.Object

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

Field Detail

NO_INTERVAL

public static final int NO_INTERVAL

Default value of an interval: a null interval.

See Also:

Constant Field Values

defaultTime

protected java.util.Date defaultTime

The default destruction time.

defaultIntervalField

protected DestructionTimeController.DateField defaultIntervalField

The date-time field on which the default interval applies.

defaultInterval

protected int defaultInterval

The default interval from the initialization to the destruction of the concerned job.

maxTime

protected java.util.Date maxTime

The maximum destruction time.

maxIntervalField

protected DestructionTimeController.DateField maxIntervalField

The date-time field on which the maximum interval applies.

maxInterval

protected int maxInterval

The maximum interval from the initialization to the destruction of the concerned job.

allowModification

protected boolean allowModification

Indicates whether the destruction time of jobs can be modified.

Constructor Detail

DestructionTimeController

public DestructionTimeController()

Method Detail

check

public java.lang.Object check(java.lang.Object value)
                       throws UWSException

Description copied from interface: InputParamController

Checks the value of the controlled parameter and builds a new object from this value.

Specified by:

check in interface InputParamController

Parameters:

value - Parameter value to check.

Returns:

The same value or a new object built from the given value.

Throws:

UWSException - If the given value is strongly incorrect.

getDefault

public java.lang.Object getDefault()

Description copied from interface: InputParamController

Returns the default value of the controlled parameter.

Specified by:

getDefault in interface InputParamController

Returns:

Default value (null is allowed).

getDefaultDestructionTime

public final java.util.Date getDefaultDestructionTime()

Gets the default destruction time: either computed with an interval of time or obtained directly by a default destruction time.

Returns:

The default destruction time (null means that jobs may stay forever).

setDefaultDestructionTime

public final void setDefaultDestructionTime(java.util.Date defaultDestructionTime)

Sets the default destruction time.

Note: If there was a default interval, it is reset and so the given destruction time will be used by getDefaultDestructionTime().

Parameters:

defaultDestructionTime - The default destruction time to set (null means jobs may stay forever).

getDefaultDestructionInterval

public final int getDefaultDestructionInterval()

Gets the default interval value.

Note: To get the corresponding unit, use getDefaultIntervalField() and Enum.name().

Returns:

The default destruction interval.

getDefaultIntervalField

public final DestructionTimeController.DateField getDefaultIntervalField()

Gets the date-time field of the default interval.

Returns:

The default interval field.

setDefaultDestructionInterval

public final void setDefaultDestructionInterval(int defaultDestructionInterval)

Sets the default interval in minutes from the initialization to the destruction of the concerned job.

Note: If there was a default destruction time, it is reset and so the given interval will be used by getDefaultDestructionTime().

Parameters:

defaultDestructionInterval - The default destruction interval (NO_INTERVAL, 0 or a negative value mean the job may stay forever).

See Also:

setDefaultDestructionInterval(int, DateField)

setDefaultDestructionInterval

public final void setDefaultDestructionInterval(int defaultDestructionInterval,
                                                DestructionTimeController.DateField timeField)

Sets the default interval (in the given unit) from the initialization to the destruction of the concerned job.

Note: If there was a default destruction time, it is reset and so the given interval will be used by getDefaultDestructionTime().

Parameters:

defaultDestructionInterval - The default destruction interval (NO_INTERVAL, 0 or a negative value mean the job may stay forever).

timeField - The unit of the interval (null means the job may stay forever).

getMaxDestructionTime

public final java.util.Date getMaxDestructionTime()

Gets the maximum destruction time: either computed with an interval of time or obtained directly by a maximum destruction time.

Returns:

The maximum destruction time (null means that jobs may stay forever).

setMaxDestructionTime

public final void setMaxDestructionTime(java.util.Date maxDestructionTime)

Sets the maximum destruction time.

Note: If there was a maximum interval, it is reset and so the given destruction time will be used by getMaxDestructionTime().

Parameters:

maxDestructionTime - The maximum destruction time to set (null means jobs may stay forever).

getMaxDestructionInterval

public final int getMaxDestructionInterval()

Gets the maximum interval value.

Note: To get the corresponding unit, use getMaxIntervalField() and Enum.name().

Returns:

The maximum destruction interval.

getMaxIntervalField

public final DestructionTimeController.DateField getMaxIntervalField()

Gets the date-time field of the maximum interval.

Returns:

The maximum interval field.

setMaxDestructionInterval

public final void setMaxDestructionInterval(int maxDestructionInterval)

Sets the maximum interval in minutes from the initialization to the destruction of the concerned job.

Note: If there was a maximum destruction time, it is reset and so the given interval will be used by getMaxDestructionTime().

Parameters:

maxDestructionInterval - The maximum destruction interval (NO_INTERVAL, 0 or a negative value mean the job may stay forever).

See Also:

setMaxDestructionInterval(int, DateField)

setMaxDestructionInterval

public final void setMaxDestructionInterval(int maxDestructionInterval,
                                            DestructionTimeController.DateField timeField)

Sets the maximum interval (in the given unit) from the initialization to the destruction of the concerned job.

Note: If there was a maximum destruction time, it is reset and so the given interval will be used by getMaxDestructionTime().

Parameters:

maxDestructionInterval - The maximum destruction interval (NO_INTERVAL, 0 or a negative value mean the job may stay forever).

timeField - The unit of the interval (null means the job may stay forever).

allowModification

public final boolean allowModification()

Tells whether the destruction time of any managed job can be modified.

Specified by:

allowModification in interface InputParamController

Returns:

true if the destruction time can be modified, false otherwise.

allowModification

public final void allowModification(boolean allowModification)

Lets indicating whether the destruction time of any managed job can be modified.

Parameters:

allowModification - true if the destruction time can be modified, false otherwise.