javax.realtime
Class PriorityScheduler

java.lang.Object
  javax.realtime.Scheduler
      javax.realtime.PriorityScheduler

public class PriorityScheduler

extends Scheduler

Field Summary

static int	MAX_PRIORITY
static int	MIN_PRIORITY
static int	NORM_PRIORITY
protected static PriorityScheduler	theInstance

Fields inherited from class javax.realtime.Scheduler

defaultScheduler

Constructor Summary

protected

PriorityScheduler()

Method Summary

protected boolean	addToFeasibility(Schedulable schedulable) Inform the scheduler and cooperating facilities that the resource demands, as expressed in the associated instances of SchedulingParameters , ReleaseParameters, MemoryParameters ,and ProcessingGroupParameters, of this instance of Schedulable will be considered in the feasibility analysis of the associated Scheduler until further notice.
int	computeExecutionEligibility(Schedulable schedulable) Computes the exectuion eligibility that is currently associated to a schedulable object.
void	fireSchedulable(Schedulable schedulable) Trigger the execution of a schedulable object (like an instance of AsyncEventHandler).
int	getMaxPriority() Get the maximum priority available for a thread managed by this scheduler.
int	getMaxPriority(Thread thread) If the given thread is scheduled by the required PriorityScheduler the maximum priority of the PriorityScheduler is returned otherwise Thread.MAX_PRIORITY is returned.
int	getMinPriority() Get the minimum priority available for a thread managed by this scheduler.
int	getMinPriority(Thread thread) If the given thread is scheduled by the required PriorityScheduler the minimum priority of the PriorityScheduler is returned otherwise Thread.MIN_PRIORITY is returned.
int	getNormPriority() Returns the normal priority available for a thread managed by this scheduler.
int	getNormPriority(Thread thread) If the given thread is scheduled by the required PriorityScheduler the normal priority of the PriorityScheduler is returned otherwise Thread.NORM_PRIORITY is returned.
String	getPolicyName() Used to determine the policy of the Scheduler
static PriorityScheduler	instance() Get the PriorityScheduler singleton instance.
boolean	isFeasible() Returns true if and only if the system is able to satisfy the constraints expressed in the release parameters of the existing schedulable objects.
void	notifyThreadStart(RealtimeThread thread)
protected boolean	removeFromFeasibility(Schedulable schedulable) Inform the scheduler and cooperating facilities that the resource demands, as expressed in the associated instances of SchedulingParameters , ReleaseParameters, MemoryParameters ,and ProcessingGroupParameters, of this instance of Schedulable should no longer be considered in the feasibility analysis of the associated Scheduler .
boolean	setIfFeasible(Schedulable schedulable, ReleaseParameters releaseParam, MemoryParameters memParam) Returns true if, after considering the values of the parameters, the task set would still be feasible.
boolean	setIfFeasible(Schedulable schedulable, ReleaseParameters releaseParam, MemoryParameters memoryParam, ProcessingGroupParameters groupParam) Returns true if, after considering the values of the parameters, the task set would still be feasible.
boolean	validateSchedulingParameters(Schedulable schedulable) Makes sure that the thread has the right set of scheduling parameters for this scheduler.

Methods inherited from class javax.realtime.Scheduler

getDefaultScheduler, setDefaultScheduler

Methods inherited from class java.lang.Object

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

Field Detail

MAX_PRIORITY

public static final int MAX_PRIORITY

MIN_PRIORITY

public static final int MIN_PRIORITY

NORM_PRIORITY

public static final int NORM_PRIORITY

theInstance

protected static PriorityScheduler theInstance

Constructor Detail

PriorityScheduler

protected PriorityScheduler()

Method Detail

addToFeasibility

protected boolean addToFeasibility(Schedulable schedulable)

Inform the scheduler and cooperating facilities that the resource demands, as expressed in the associated instances of SchedulingParameters , ReleaseParameters, MemoryParameters ,and ProcessingGroupParameters, of this instance of Schedulable will be considered in the feasibility analysis of the associated Scheduler until further notice. Whether the resulting system is feasible or not, the addition is completed.

Specified by:

addToFeasibility in class Scheduler

Parameters:

schedulable - the Schedulable entity that has to be considered hereon in the feasibility analysis.

Returns:

true if the system is feasible, false otherwise.

fireSchedulable

public void fireSchedulable(Schedulable schedulable)

Trigger the execution of a schedulable object (like an instance of AsyncEventHandler).

Specified by:

fireSchedulable in class Scheduler

Parameters:

schedulable - the Schedulable object to make active.

getMaxPriority

public int getMaxPriority()

Get the maximum priority available for a thread managed by this scheduler.

Returns:

an int value representing the maximum priority available.

getMaxPriority

public int getMaxPriority(Thread thread)

If the given thread is scheduled by the required PriorityScheduler the maximum priority of the PriorityScheduler is returned otherwise Thread.MAX_PRIORITY is returned.

Parameters:

thread - An instance of Thread. If null the maximum priority of the required PriorityScheduler is returned.

Returns:

paraman int value representing the maximum priority.

getMinPriority

public int getMinPriority()

Get the minimum priority available for a thread managed by this scheduler.

Returns:

an int value representing the minumum priority level available.

getMinPriority

public int getMinPriority(Thread thread)

If the given thread is scheduled by the required PriorityScheduler the minimum priority of the PriorityScheduler is returned otherwise Thread.MIN_PRIORITY is returned.

Parameters:

thread - An instance of Thread. If null the minimum priority of the required PriorityScheduler is returned.

Returns:

an int value representing the minimum priority.

getNormPriority

public int getNormPriority()

Returns the normal priority available for a thread managed by this scheduler.

Returns:

an int value representing the normal priority.

getNormPriority

public int getNormPriority(Thread thread)

If the given thread is scheduled by the required PriorityScheduler the normal priority of the PriorityScheduler is returned otherwise Thread.NORM_PRIORITY is returned.

Parameters:

thread - An instance of Thread. If null the normal priority of the required PriorityScheduler is returned.

Returns:

an int value representing the normal priority.

getPolicyName

public String getPolicyName()

Used to determine the policy of the Scheduler

Specified by:

getPolicyName in class Scheduler

Returns:

A String object which is the name of the scheduling policy used by this.

instance

public static PriorityScheduler instance()

Get the PriorityScheduler singleton instance.

Returns:

returns a reference to the PriorityScheduler singleton.

isFeasible

public boolean isFeasible()

Returns true if and only if the system is able to satisfy the constraints expressed in the release parameters of the existing schedulable objects.

Specified by:

isFeasible in class Scheduler

Returns:

true if the system is feasible.

removeFromFeasibility

protected boolean removeFromFeasibility(Schedulable schedulable)

Inform the scheduler and cooperating facilities that the resource demands, as expressed in the associated instances of SchedulingParameters , ReleaseParameters, MemoryParameters ,and ProcessingGroupParameters, of this instance of Schedulable should no longer be considered in the feasibility analysis of the associated Scheduler . Whether the resulting system is feasible or not, the subtrac-tion is completed.

Specified by:

removeFromFeasibility in class Scheduler

Parameters:

schedulable - the Schedulable entity that has to be removed from the set of task considered for schedulability analysis.

Returns:

true If the resulting system is feasible.

setIfFeasible

public boolean setIfFeasible(Schedulable schedulable,
                             ReleaseParameters releaseParam,
                             MemoryParameters memParam)

Returns true if, after considering the values of the parameters, the task set would still be feasible. In this case the values of the parameters are changed. Returns false if, after considering the values of the parameters, the task set would not be feasible. In this case the values of the parameters are not changed.

Overrides:

setIfFeasible in class Scheduler

Parameters:

schedulable - a Schedulable value

releaseParam - a ReleaseParameters value

memParam - a MemoryParameters value

Returns:

a boolean value

setIfFeasible

public boolean setIfFeasible(Schedulable schedulable,
                             ReleaseParameters releaseParam,
                             MemoryParameters memoryParam,
                             ProcessingGroupParameters groupParam)

Returns true if, after considering the values of the parameters, the task set would still be feasible. In this case the values of the parameters are changed. Returns false if, after considering the values of the parameters, the task set would not be feasible. In this case the values of the parameters are not changed.

Overrides:

setIfFeasible in class Scheduler

Parameters:

schedulable - a Schedulable value

releaseParam - a ReleaseParameters value

memoryParam - a MemoryParameters value

groupParam - a ProcessingGroupParameters value

Returns:

true if the resulting system is feasible, false otherwise.

validateSchedulingParameters

public boolean validateSchedulingParameters(Schedulable schedulable)

Makes sure that the thread has the right set of scheduling parameters for this scheduler.

Specified by:

validateSchedulingParameters in class Scheduler

Parameters:

schedulable - a schedulable entity

Returns:

true if the given thread has all the scheduling parameters needed by the given scheduler.

notifyThreadStart

public void notifyThreadStart(RealtimeThread thread)

computeExecutionEligibility

public int computeExecutionEligibility(Schedulable schedulable)

Description copied from class: Scheduler

Computes the exectuion eligibility that is currently associated to a schedulable object. The execution eligibility provide a total ordering for the schedulable entities present in the system.

Specified by:

computeExecutionEligibility in class Scheduler

Parameters:

schedulable - a Schedulable for which the execution eligibility has to be computed.

Returns:

an int value representing the eligibility.