javax.realtime

Class ImportanceParameters

java.lang.Object

javax.realtime.SchedulingParameters

javax.realtime.PriorityParameters

javax.realtime.ImportanceParameters

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, Subsumable<SchedulingParameters>

Deprecated.

since RTSJ 2.0

@Deprecated
public class ImportanceParameters
extends PriorityParameters

Importance is an additional scheduling metric that may be used by some priority-based scheduling algorithms during overload conditions to differentiate execution order among threads of the same priority.

In some realtime systems an external physical process determines the period of many threads. When rate-monotonic priority assignment is used to assign priorities, many of the threads in the system may have the same priority because their periods are the same. However, it is conceivable that some threads may be more important than others and in an overload situation importance can help the scheduler decide which threads to execute first. The base scheduling algorithm represented by PriorityScheduler must not consider importance.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ImportanceParameters(int priority, int importance) Deprecated. Creates an instance of ImportanceParameters.

Method Summary

Modifier and Type	Method and Description
int	getImportance() Deprecated. Gets the importance value.
void	setImportance(int importance) Deprecated. Sets the importance value.
java.lang.String	toString() Deprecated. Prints the value of the priority and importance values of the associated instance of Schedulable

Methods inherited from class javax.realtime.PriorityParameters

getPriority, isCompatible, setPriority, subsumes

Methods inherited from class javax.realtime.SchedulingParameters

clone, getAffinity

Methods inherited from class java.lang.Object

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

Constructor Detail

ImportanceParameters

public ImportanceParameters(int priority,
                            int importance)

Deprecated.

Creates an instance of ImportanceParameters.

Parameters:

priority - The priority value assigned to schedulables that use this parameter instance. This value is used in place of the value passed to Thread.setPriority.

importance - The importance value assigned to schedulable objects that use this parameter instance.

Method Detail

getImportance

public int getImportance()

Deprecated.

Gets the importance value.

Returns:

the value of importance for the associated instances of Schedulable.

setImportance

public void setImportance(int importance)

Deprecated.

Sets the importance value. When this parameter object is associated with any schedulable, either by being passed through the schedulable's constructor or set with a method such as RealtimeThread.setSchedulingParameters(SchedulingParameters), the importance of those schedulables is altered at a moment controlled by the schedulers for the respective schedulables.

Parameters:

importance - The value to which importance is set.

Throws:

StaticIllegalArgumentException - when the given importance value is incompatible with the scheduler for any of the schedulables which are presently using this parameter object.

toString

public java.lang.String toString()

Deprecated.

Prints the value of the priority and importance values of the associated instance of Schedulable

Overrides:

toString in class PriorityParameters

Returns:

a string representing the value of priority.