javax.safetycritical

Class Mission

java.lang.Object

javax.safetycritical.Mission

Direct Known Subclasses:

CyclicExecutive

@SCJAllowed
public abstract class Mission
extends java.lang.Object

An SCJ application is comprised of one or more Mission objects. Each Mission object is implemented as a subclass of this abstract Mission class.

Version:

1.2; - December 2013

Author:

Anders P. Ravn, Aalborg University, apr@cs.aau.dk,
Hans Søndergaard, VIA University College, Denmark, hso@via.dk

Relative_to_SCJ_Draft_Version_0.94:

- SCJ issue: Omitted:

• public static Mission getCurrentMission();

This static function has a problematic semantics.Consider a Level 2 application with nested missions:

• What is getCurrentMission's value inside a mission constructor, and what is it during mission
• initialize: it can be replaced by specific parameters for handlers that need it.

The getCurrentMission function can be replaced by specific parameters for handlers that need it.

Constructor Summary

Constructors

Constructor and Description
Mission()

Method Summary

Methods

Modifier and Type	Method and Description
static Mission	getCurrentMission()
MissionSequencer	getSequencer()
abstract long	missionMemorySize() The application developer is required to implement this method.
void	requestTermination() This method provides a standard interface for requesting termination of a mission.
boolean	terminationPending() Checks if the current mission is trying to terminate.

Methods inherited from class java.lang.Object

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

Constructor Detail

Mission

@SCJAllowed
public Mission()

Method Detail

getCurrentMission

@SCJAllowed
public static Mission getCurrentMission()

getSequencer

@SCJAllowed
public MissionSequencer getSequencer()

missionMemorySize

@SCJAllowed(value=SUPPORT)
public abstract long missionMemorySize()

The application developer is required to implement this method.

Returns:

The desired size of this mission's MissionMemory, measured in bytes.

requestTermination

@SCJAllowed
public final void requestTermination()

This method provides a standard interface for requesting termination of a mission.

The infrastructure shall:

1. disable all periodic event handlers associated with this Mission,
2. remove handlers from AperiodicEvents,
3. clear the fire count for each of this Mission's event handlers
4. wait for all dispatched schedulables to terminate execution,
5. invoke the cleanup method for each of the ManagedSchedulables associated with this mission, and
6. invoke the cleanup method associated with this mission.

An application-specific subclass of Mission may override this method in order to insert application-specific code to communicate the intent to shutdown to specific ManagedSchedulables.

Control returns from requestTermination after it has arranged for the required activities to be performed. Note that those activities may not have completed.

terminationPending

public final boolean terminationPending()

Checks if the current mission is trying to terminate.

Returns:

True if and only if this Mission object's Mission.requestTermination method has been invoked.