javax.realtime

Class RealtimePermission

java.lang.Object

java.security.Permission

javax.realtime.RealtimePermission

All Implemented Interfaces:

Serializable, Guard

Direct Known Subclasses:

POSIXPermission, TaskPermission

public abstract class RealtimePermission
extends Permission

All permission classes in the RTSJ inherit from this class. The following table lists common risk classes that correspond to granting specific permissions.

Risk Class	Description
CPU Assignment Risk	Interferes with critical tasks by assigning too many other tasks to the same CPU.
Encapsulation Risk	Could break out of encapsulation.
External Risk	Could adversely effect other processes on the system.
Interference Risk	Could interfere with the function of other parts of the system.
Load Risk	Could increase the load on the system.
Lost Events Risk	Another task could no longer receive the expected events.
Memory Leak Risk	Could cause memory to be lost to the system.
Scheduling Risk	Interferes with the timeliness of other parts of the system.
Device Range Risk	Could specify memory outside the desired Device range.
Device Map Risk	Could map too much or too little Device memory.
DMA Range Risk	Could specify memory outside the desired DMA range.
DMA Map Risk	Could map too much or too little DMA memory for DMA.
Physical Range Risk	Could specify memory outside the desired Physical range.
Pysical Map Risk	Could take too much memory.

Since:

RTSJ 2.0

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RealtimePermission(String actions) Creates a new RealtimePermission object for a given action, i.e., the symbolic name of an action.
protected	RealtimePermission(String target, String actions) Creates a new RealtimePermission object for a given action, i.e., the symbolic name of an action.

Method Summary

Modifier and Type	Method and Description
abstract boolean	equals(Object other) Compare two Permission objects for equality.
abstract String	getActions() Obtain the actions as a String in canonical form.
abstract int	hashCode() Obtain the hash code value for this object.
abstract boolean	implies(Permission permission) Checks if the given permission's actions are "implied by" this object's actions.

Methods inherited from class java.security.Permission

checkGuard, getName, newPermissionCollection, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

RealtimePermission

protected RealtimePermission(String actions)

Creates a new RealtimePermission object for a given action, i.e., the symbolic name of an action.

Throws:

NullPointerException - when actions is null.

StaticIllegalArgumentException - when actions is empty.

UnsupportedOperationException - when called on non-supported subclass.

Parameters:

actions - The names of the actions to allow, or * for all actions.

RealtimePermission

protected RealtimePermission(String target,
                             String actions)

Creates a new RealtimePermission object for a given action, i.e., the symbolic name of an action. The target string specifies additional limitations on the action.

Throws:

NullPointerException - when actions is null.

StaticIllegalArgumentException - when target or actions is empty.

Parameters:

target - Specifies the domain for the action, or * for no limit on the permission.

actions - The names of the actions to allow, or * for all actions.

Method Detail

equals

public abstract boolean equals(Object other)

Compare two Permission objects for equality.

Specified by:

equals in class Permission

Parameters:

other - is the object with which to compare.

Returns:

true when yes and false otherwise.

See Also:

Object.hashCode(), HashMap

getActions

public abstract String getActions()

Obtain the actions as a String in canonical form.

Specified by:

getActions in class Permission

Returns:

the actions represented as a string.

hashCode

public abstract int hashCode()

Obtain the hash code value for this object.

Specified by:

hashCode in class Permission

Returns:

the has code value.

See Also:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

implies

public abstract boolean implies(Permission permission)

Checks if the given permission's actions are "implied by" this object's actions. This method is used by the AccessController to determine whether or not a requested permission is implied by another permission that is known to be valid in the current execution context.

Specified by:

implies in class Permission

Parameters:

permission - is the permission to check.

Returns:

true when yes and false otherwise.