org.squashtest.tm.domain.execution

Enum ExecutionStatus

java.lang.Object

java.lang.Enum<ExecutionStatus>

org.squashtest.tm.domain.execution.ExecutionStatus

All Implemented Interfaces:

Serializable, Comparable<ExecutionStatus>, org.squashtest.tm.core.foundation.i18n.Internationalizable, Level

public enum ExecutionStatus
extends Enum<ExecutionStatus>
implements org.squashtest.tm.core.foundation.i18n.Internationalizable, Level

This class declare the 7 execution statuses, 5 of them being canonical. Also, it declares and additional methods to update the new execution status of an execution, based on the former states of the execution, of the step, and the new status of the step. See their documentation for details.

Definitions :

• former execution status : former ExecutionStatus of the considered Execution
• former step status : former ExecutionStatus of the ExecutionStep (that belongs to the considered Execution) that just had been updated
• new step status : new ExecutionStatus of the ExecutionStep that just had been updated. From the object point of view, it's "this" : the public methods here will consider "this" as the new step status.
• new execution status : the new ExecutionStatus of the considered Execution. It is what is being computed there.

Rem : Level seems to be used for sorting purposes (which might not be so good a thing)

Author:

bsiri

Enum Constant Summary

Enum Constants

Enum Constant and Description
BLOCKED
ERROR
FAILURE
NOT_FOUND
NOT_RUN
READY
RUNNING
SETTLED
SUCCESS
UNTESTABLE
WARNING

Field Summary

Fields

Modifier and Type	Field and Description
static Set<ExecutionStatus>	DEFAULT_DISABLED_STATUSES
static Set<ExecutionStatus>	TA_STATUSES_ONLY
static Set<ExecutionStatus>	TERMINAL_STATUSES

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canBeDisabled()
static ExecutionStatus	computeNewStatus(ExecutionStatusReport report) will compute from scratch a status using a complete report.
protected boolean	couldHaveSetExecStatusAlone(ExecutionStatus formerExecutionStatus, ExecutionStatus formerStepStatus)
ExecutionStatus	deduceNewStatus(ExecutionStatus formerExecutionStatus, ExecutionStatus formerStepStatus) will deduce the new status of an execution based on the former execution status and former step status.
boolean	defaultEnabled() Deprecated.
protected ExecutionStatus	doDeduceNewStatus(ExecutionStatus formerExecutionStatus, ExecutionStatus formerStepStatus)
abstract ExecutionStatus	getCanonicalStatus()
static Set<ExecutionStatus>	getCanonicalStatusSet()
String	getI18nKey()
int	getLevel()
static Set<ExecutionStatus>	getNonTerminatedStatusSet()
static Set<ExecutionStatus>	getTerminatedStatusSet()
protected boolean	hasChanged(ExecutionStatus formerStepStatus)
protected ExecutionStatus	isAmbiguous()
protected boolean	isAmbiguous(ExecutionStatus status)
abstract boolean	isCanonical()
protected boolean	isNoneOf(ExecutionStatus... status)
protected boolean	isOneOf(ExecutionStatus... status)
protected boolean	isSetToExecutionStatus(ExecutionStatus formerExecutionStatus)
boolean	isTerminatedStatus() This methods checks if the status is RUNNING or READY
protected boolean	mayUnlockBloquedExecution(ExecutionStatus formerStepStatus)
protected ExecutionStatus	needsComputation()
protected boolean	needsComputation(ExecutionStatus status)
protected abstract ExecutionStatus	resolveStatus(ExecutionStatus formerExecutionStatus, ExecutionStatus formerStepStatus)
static org.squashtest.tm.domain.execution.ExecutionStatus.StringComparator	stringComparator()
static List<ExecutionStatus>	toCanonicalStatusList(List<ExecutionStatus> nonCanonical)
protected ExecutionStatus	trivialDeductions(ExecutionStatus formerExecutionStatus, ExecutionStatus formerStepStatus)
protected boolean	trivialNeedComputation(ExecutionStatus formerExecutionStatus, ExecutionStatus formerStepStatus)
static ExecutionStatus	valueOf(String name) Returns the enum constant of this type with the specified name.
static ExecutionStatus[]	values() Returns an array containing the constants of this enum type, in the order they are declared.
protected boolean	wontUnlockBloquedExecution(ExecutionStatus formerExecutionStatus, ExecutionStatus formerStepStatus)

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

SETTLED

public static final ExecutionStatus SETTLED

UNTESTABLE

public static final ExecutionStatus UNTESTABLE

BLOCKED

public static final ExecutionStatus BLOCKED

FAILURE

public static final ExecutionStatus FAILURE

SUCCESS

public static final ExecutionStatus SUCCESS

RUNNING

public static final ExecutionStatus RUNNING

READY

public static final ExecutionStatus READY

WARNING

public static final ExecutionStatus WARNING

ERROR

public static final ExecutionStatus ERROR

NOT_RUN

public static final ExecutionStatus NOT_RUN

NOT_FOUND

public static final ExecutionStatus NOT_FOUND

Field Detail

TERMINAL_STATUSES

public static final Set<ExecutionStatus> TERMINAL_STATUSES

TA_STATUSES_ONLY

public static final Set<ExecutionStatus> TA_STATUSES_ONLY

DEFAULT_DISABLED_STATUSES

public static final Set<ExecutionStatus> DEFAULT_DISABLED_STATUSES

Method Detail

values

public static ExecutionStatus[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ExecutionStatus c : ExecutionStatus.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ExecutionStatus valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

defaultEnabled

@Deprecated
public boolean defaultEnabled()

Deprecated.

canBeDisabled

public boolean canBeDisabled()

isAmbiguous

protected ExecutionStatus isAmbiguous()

isAmbiguous

protected boolean isAmbiguous(ExecutionStatus status)

needsComputation

protected ExecutionStatus needsComputation()

needsComputation

protected boolean needsComputation(ExecutionStatus status)

resolveStatus

protected abstract ExecutionStatus resolveStatus(ExecutionStatus formerExecutionStatus,
                            ExecutionStatus formerStepStatus)

isCanonical

public abstract boolean isCanonical()

getCanonicalStatus

public abstract ExecutionStatus getCanonicalStatus()

toCanonicalStatusList

public static List<ExecutionStatus> toCanonicalStatusList(List<ExecutionStatus> nonCanonical)

getCanonicalStatusSet

public static Set<ExecutionStatus> getCanonicalStatusSet()

getTerminatedStatusSet

public static Set<ExecutionStatus> getTerminatedStatusSet()

getNonTerminatedStatusSet

public static Set<ExecutionStatus> getNonTerminatedStatusSet()

getLevel

public int getLevel()

Specified by:

getLevel in interface Level

isTerminatedStatus

public boolean isTerminatedStatus()

This methods checks if the status is RUNNING or READY

Returns:

true if the status is neither RUNNING nor READY

getI18nKey

public String getI18nKey()

Specified by:

getI18nKey in interface org.squashtest.tm.core.foundation.i18n.Internationalizable

deduceNewStatus

public ExecutionStatus deduceNewStatus(ExecutionStatus formerExecutionStatus,
                              ExecutionStatus formerStepStatus)

will deduce the new status of an execution based on the former execution status and former step status. "this" is here the new step status. In some case the deduction is impossible and a further computation will be necessary. The method will first convert the argument to their canonical form before performing the comparison.

Parameters:

formerExecutionStatus - : the former execution status

formerStepStatus - : the former step status

Returns:

: the new execution status when possible, or null if it wasn't. The later usually means that a call to the database is needed.

isNoneOf

protected boolean isNoneOf(ExecutionStatus... status)

isOneOf

protected boolean isOneOf(ExecutionStatus... status)

doDeduceNewStatus

protected ExecutionStatus doDeduceNewStatus(ExecutionStatus formerExecutionStatus,
                                ExecutionStatus formerStepStatus)

computeNewStatus

public static ExecutionStatus computeNewStatus(ExecutionStatusReport report)

will compute from scratch a status using a complete report.

Parameters:

report - : ExecutionStatusReport.

Returns:

: ExecutionStatus.

trivialDeductions

protected ExecutionStatus trivialDeductions(ExecutionStatus formerExecutionStatus,
                                ExecutionStatus formerStepStatus)

trivialNeedComputation

protected boolean trivialNeedComputation(ExecutionStatus formerExecutionStatus,
                             ExecutionStatus formerStepStatus)

hasChanged

protected boolean hasChanged(ExecutionStatus formerStepStatus)

isSetToExecutionStatus

protected boolean isSetToExecutionStatus(ExecutionStatus formerExecutionStatus)

wontUnlockBloquedExecution

protected boolean wontUnlockBloquedExecution(ExecutionStatus formerExecutionStatus,
                                 ExecutionStatus formerStepStatus)

mayUnlockBloquedExecution

protected boolean mayUnlockBloquedExecution(ExecutionStatus formerStepStatus)

couldHaveSetExecStatusAlone

protected boolean couldHaveSetExecStatusAlone(ExecutionStatus formerExecutionStatus,
                                  ExecutionStatus formerStepStatus)

stringComparator

public static org.squashtest.tm.domain.execution.ExecutionStatus.StringComparator stringComparator()