javax.realtime

Class ImmortalMemoryPermission

java.lang.Object

java.security.Permission

javax.realtime.RealtimePermission

javax.realtime.ImmortalMemoryPermission

All Implemented Interfaces:

java.io.Serializable, java.security.Guard

public class ImmortalMemoryPermission
extends RealtimePermission

Memory permission are divided into those for the core module and those for the memory module. The following table describes the actions to check for the core module. The name of a primordial memory area type can be given.

Action Name	Description	Risks of grant
allocate	Allows the creation of an object in Immortal without entering it.	Can cause a Memory Leak Risk

The wildcard *, or no target, allows access to primordial memory area. The risk classes are defined in RealtimePermission.

Since:

RTSJ 2.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ImmortalMemoryPermission(java.lang.String actions) Creates a new ImmortalMemoryPermission object for a given action, i.e., the symbolic name of an action.
ImmortalMemoryPermission(java.lang.String target, java.lang.String actions) Creates a new ImmortalMemoryPermission 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.

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

ImmortalMemoryPermission

public ImmortalMemoryPermission(java.lang.String actions)

Creates a new ImmortalMemoryPermission 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 action is null.

StaticIllegalArgumentException - when action is empty.

ImmortalMemoryPermission

public ImmortalMemoryPermission(java.lang.String target,
                                java.lang.String actions)

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

Parameters:

target - The names of the memory area class for the action, or * for all memory areas.

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

Throws:

java.lang.NullPointerException - when action is null.

StaticIllegalArgumentException - when action is empty.

Method Detail

equals

public boolean equals(java.lang.Object other)

Description copied from class: RealtimePermission

Compare two Permission objects for equality.

Overrides:

equals in class RealtimePermission

Parameters:

other - is the object with which to compare.

Returns:

true when yes and false otherwise.

getActions

public java.lang.String getActions()

Description copied from class: RealtimePermission

Obtain the actions as a String in canonical form.

Overrides:

getActions in class RealtimePermission

Returns:

the actions represented as a string.

hashCode

public int hashCode()

Description copied from class: RealtimePermission

Obtain the hash code value for this object.

Overrides:

hashCode in class RealtimePermission

Returns:

the hash code value.

implies

public boolean implies(java.security.Permission permission)

Description copied from class: RealtimePermission

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.

Overrides:

implies in class RealtimePermission

Parameters:

permission - is the permission to check.

Returns:

true when yes and false otherwise.