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:

ConstraintPermission, HappeningPermission, ImmortalMemoryPermission, POSIXPermission, RawMemoryPermission, SchedulingPermission, ScopedMemoryPermission, TaskPermission, TimePermission

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.
Physical 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 name, 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
boolean	equals(java.lang.Object other) Compare two Permission objects for equality.
java.lang.String	getActions() Obtain the actions as a String in canonical form.
int	hashCode() Obtain the hash code value for this object.
boolean	implies(java.security.Permission permission) Checks if the given permission's actions are "implied by" this object's actions.
protected void	setHashCode(int code) Set the hash code value for this object.

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 name,
                             java.lang.String actions)

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

Parameters:

name - 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 name or actions is empty.

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.

Method Detail

equals

public 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 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 int hashCode()

Obtain the hash code value for this object.

Specified by:

hashCode in class java.security.Permission

Returns:

the hash code value.

setHashCode

protected void setHashCode(int code)

Set the hash code value for this object.

Parameters:

code - the hash code value.

implies

public 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.