Package arez

Class ComputableValue.Flags

java.lang.Object

arez.ComputableValue.Flags

Enclosing class:

ComputableValue<T>

public static final class ComputableValue.Flags
extends Object

Flags that can configure ComputableValue instances during creation.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	AREZ_DEPENDENCIES	Indicates that application code cannot invoke ComputableValue.reportPossiblyChanged() and the ComputableValue is only recalculated if a dependency is updated.
static final int	AREZ_OR_EXTERNAL_DEPENDENCIES	Indicates that application code can invoke ComputableValue.reportPossiblyChanged() to indicate some dependency has changed and that the ComputableValue should recompute.
static final int	AREZ_OR_NO_DEPENDENCIES	Flag set if the application code cannot invoke ComputableValue.reportPossiblyChanged() to indicate that a dependency has changed.
static final int	KEEPALIVE	The runtime will keep the ComputableValue reacting to dependencies until disposed.
static final int	NO_REPORT_RESULT	If passed, then the computable value should not report result to the spy infrastructure.
static final int	OBSERVE_LOWER_PRIORITY_DEPENDENCIES	Flag indicating that the ComputableValue is allowed to observe ComputableValue instances with a lower priority.
static final int	PRIORITY_HIGH	High priority.
static final int	PRIORITY_HIGHEST	Highest priority.
static final int	PRIORITY_LOW	Low priority.
static final int	PRIORITY_LOWEST	Lowest priority.
static final int	PRIORITY_MASK	Mask used to extract priority bits.
static final int	PRIORITY_NORMAL	Normal priority if no other priority otherwise specified.
static final int	READ_OUTSIDE_TRANSACTION	Flag indicating that the ComputableValue be accessed outside a transaction.
static final int	RUN_LATER	The scheduler will not be triggered when the ComputableValue is created.
static final int	RUN_NOW	The scheduler will be triggered when the ComputableValue is created to immediately invoke the compute function.

Constructor Summary

Constructors

Constructor	Description
Flags()

Method Summary

Methods inherited from class java.lang.Object

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

Field Details

RUN_NOW

public static final int RUN_NOW

The scheduler will be triggered when the ComputableValue is created to immediately invoke the compute function. This should not be specified if RUN_LATER is specified.

See Also:

• Task.Flags.RUN_NOW
• Constant Field Values

RUN_LATER

public static final int RUN_LATER

The scheduler will not be triggered when the ComputableValue is created. The ComputableValue is responsible for ensuring that ArezContext.triggerScheduler() is invoked at a later time. This should not be specified if RUN_NOW is specified.

See Also:

• Task.Flags.RUN_LATER
• Constant Field Values

NO_REPORT_RESULT

public static final int NO_REPORT_RESULT

If passed, then the computable value should not report result to the spy infrastructure.

See Also:

• Observer.Flags.NO_REPORT_RESULT
• Constant Field Values

AREZ_DEPENDENCIES

public static final int AREZ_DEPENDENCIES

Indicates that application code cannot invoke ComputableValue.reportPossiblyChanged() and the ComputableValue is only recalculated if a dependency is updated.

See Also:

• DepType.AREZ
• Observer.Flags.AREZ_DEPENDENCIES
• Constant Field Values

AREZ_OR_NO_DEPENDENCIES

public static final int AREZ_OR_NO_DEPENDENCIES

Flag set if the application code cannot invoke ComputableValue.reportPossiblyChanged() to indicate that a dependency has changed.

See Also:

• DepType.AREZ_OR_NONE
• Observer.Flags.AREZ_OR_NO_DEPENDENCIES
• Constant Field Values

AREZ_OR_EXTERNAL_DEPENDENCIES

public static final int AREZ_OR_EXTERNAL_DEPENDENCIES

Indicates that application code can invoke ComputableValue.reportPossiblyChanged() to indicate some dependency has changed and that the ComputableValue should recompute.

See Also:

• DepType.AREZ_OR_EXTERNAL
• Observer.Flags.AREZ_OR_EXTERNAL_DEPENDENCIES
• Constant Field Values

OBSERVE_LOWER_PRIORITY_DEPENDENCIES

public static final int OBSERVE_LOWER_PRIORITY_DEPENDENCIES

Flag indicating that the ComputableValue is allowed to observe ComputableValue instances with a lower priority.

See Also:

• Observer.Flags.AREZ_OR_EXTERNAL_DEPENDENCIES
• Constant Field Values

KEEPALIVE

public static final int KEEPALIVE

The runtime will keep the ComputableValue reacting to dependencies until disposed.

See Also:

• Observer.Flags.KEEPALIVE
• Constant Field Values

PRIORITY_HIGHEST

public static final int PRIORITY_HIGHEST

Highest priority. This priority should be used when the ComputableValue will dispose or release other reactive elements (and thus remove elements from being scheduled).

Only one of the PRIORITY_* flags should be applied to ComputableValue.

See Also:

• Priority.HIGHEST
• Priority.HIGHEST
• Task.Flags.PRIORITY_HIGHEST
• Constant Field Values

PRIORITY_HIGH

public static final int PRIORITY_HIGH

High priority. To reduce the chance that downstream elements will react multiple times within a single reaction round, this priority should be used when the ComputableValue may trigger many downstream tasks.

Only one of the PRIORITY_* flags should be applied to ComputableValue.

See Also:

• Priority.HIGH
• Priority.HIGH
• Task.Flags.PRIORITY_HIGH
• Constant Field Values

PRIORITY_NORMAL

public static final int PRIORITY_NORMAL

Normal priority if no other priority otherwise specified.

Only one of the PRIORITY_* flags should be applied to ComputableValue.

See Also:

• Priority.NORMAL
• Priority.NORMAL
• Task.Flags.PRIORITY_NORMAL
• Constant Field Values

PRIORITY_LOW

public static final int PRIORITY_LOW

Low priority. Usually used to schedule ComputableValues that support reflecting state onto non-reactive application components. i.e., ComputableValue that are used to build html views, perform network operations, etc. These ComputableValues are often at low priority to avoid recalculation of dependencies (i.e. ComputableValues) triggering this ComputableValue multiple times within a single reaction round.

Only one of the PRIORITY_* flags should be applied to ComputableValue.

See Also:

• Priority.LOW
• Priority.LOW
• Task.Flags.PRIORITY_LOW
• Constant Field Values

PRIORITY_LOWEST

public static final int PRIORITY_LOWEST

Lowest priority. Use this priority if the ComputableValue may be unobserved when a PRIORITY_LOW element reacts. This is used to avoid recomputing state, that is likely to either be unobserved or recomputed as part of another element's reaction.

Only one of the PRIORITY_* flags should be applied to ComputableValue.

See Also:

• Priority.LOWEST
• Priority.LOWEST
• Task.Flags.PRIORITY_LOWEST
• Constant Field Values

PRIORITY_MASK

public static final int PRIORITY_MASK

Mask used to extract priority bits.

See Also:

• Constant Field Values

READ_OUTSIDE_TRANSACTION

public static final int READ_OUTSIDE_TRANSACTION

Flag indicating that the ComputableValue be accessed outside a transaction.

See Also:

• Constant Field Values

Constructor Details

Flags

public Flags()