javax.realtime

Class RealtimePermission

java.lang.Object

java.security.Permission

javax.realtime.RealtimePermission

All Implemented Interfaces:

java.io.Serializable, java.security.Guard

Direct Known Subclasses:

POSIXPermission, TaskPermission

public abstract class RealtimePermission
extends java.security.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(java.lang.String actions) Creates a new RealtimePermission object for a given action, i.e., the symbolic name of an action.
protected	RealtimePermission(java.lang.String target, java.lang.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(java.lang.Object other) Compare two Permission objects for equality.
abstract java.lang.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(java.security.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(java.lang.String actions)

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

Parameters:

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

Throws:

java.lang.NullPointerException - when actions is null.

StaticIllegalArgumentException - when actions is empty.

java.lang.UnsupportedOperationException - when called on non-supported subclass.

RealtimePermission

protected RealtimePermission(java.lang.String target,
                             java.lang.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.

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.

Throws:

java.lang.NullPointerException - when actions is null.

StaticIllegalArgumentException - when target or actions is empty.

Method Detail

equals

public abstract boolean equals(java.lang.Object other)

Compare two Permission objects for equality.

Specified by:

equals in class java.security.Permission

Parameters:

other - is the object with which to compare.

Returns:

true when yes and false otherwise.

getActions

public abstract java.lang.String getActions()

Obtain the actions as a String in canonical form.

Specified by:

getActions in class java.security.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 java.security.Permission

Returns:

the has code value.

implies

public abstract boolean implies(java.security.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 java.security.Permission

Parameters:

permission - is the permission to check.

Returns:

true when yes and false otherwise.