javax.realtime

Class TimePermission

java.lang.Object

java.security.Permission

javax.realtime.RealtimePermission

javax.realtime.TimePermission

All Implemented Interfaces:

java.io.Serializable, java.security.Guard

public class TimePermission
extends RealtimePermission

Time permissions are for controlling clocks and timers. The following table describes the actions to check. For all but create, which takes no target, either the permission is limited to the current ThreadGroup by specifying the target group, or it can apply to all with no target or the target *.

Action Name	Description	Risks of grant
control	Enables controlling the activity of a timer.	Scheduling Risk
create	Enables new timers to be created	Scheduling Risk
handle	Adds a handler to the a timer.	Load Risk
override	Change existing handlers.	Interference Risk
system	Changes system wide timer and clock behavior.	Scheduling and Load Risk

The wildcard * is allowed for both clock and action. The risk classes are defined in RealtimePermission.

Since:

RTSJ 2.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
TimePermission(java.lang.String actions) Creates a new TimePermission object for a given action, i.e., the symbolic name of an action.
TimePermission(java.lang.String name, java.lang.String actions) Creates a new TimePermission object for a given action, i.e., the symbolic name of an action.

Method Summary

Modifier and Type	Method and Description
boolean	implies(java.security.Permission permission) Checks if the given permission's actions are "implied by" this object's actions.

Methods inherited from class javax.realtime.RealtimePermission

equals, getActions, hashCode, setHashCode

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

TimePermission

public TimePermission(java.lang.String name,
                      java.lang.String actions)

Creates a new TimePermission object for a given action, i.e., the symbolic name of an action. The name string specifies for which clock the action applies.

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 action is empty.

TimePermission

public TimePermission(java.lang.String actions)

Creates a new TimePermission 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

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.