javax.realtime

Class SchedulingPermission

java.lang.Object

java.security.Permission

javax.realtime.RealtimePermission

javax.realtime.SchedulingPermission

All Implemented Interfaces:

java.io.Serializable, java.security.Guard

public class SchedulingPermission
extends RealtimePermission

Scheduling has its own security permission that covers APIs in Scheduler, RealtimeThreadGroup, and ProcessingConstraint. The following table describes the actions to check. Either the permission is limited to the current ThreadGroup by specifying the target group or it can apply to all, either with no target or the target *.

Action Name	Description	Risks of grant
system	Changes system wide behavior, such as how scheduling is done.	Scheduling Risk
control	Changes another context's scheduling limits, including affinity, or raises your own limits.	Scheduling Risk
monitor	Adds handlers to someone else's group or changes the event used to monitor adding or removing a processor.	Load Risk, Lost Events Risk
tune	Changes task scheduling.	Scheduling Risk

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

Since:

RTSJ 2.0

See Also:

Serialized Form

Constructor Summary

Constructors

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

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

SchedulingPermission

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

Creates a new SchedulingPermission 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 * or null for no limit on the permission.

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

Throws:

java.lang.NullPointerException - when action is null.

StaticIllegalArgumentException - when target or action is empty.

SchedulingPermission

public SchedulingPermission(java.lang.ThreadGroup group,
                            java.lang.String actions)

Creates a new SchedulingPermission object for a given action, i.e., the symbolic name of an action. The group parameter specifies the thread group that will be compared to the current thread group when implies is called.

Parameters:

group - Specifies the thread group that will be compared to the current thread group when implies is called.

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

Throws:

java.lang.NullPointerException - when action is null.

StaticIllegalArgumentException - when group is null or action is empty.

SchedulingPermission

public SchedulingPermission(java.lang.String actions)

Creates a new SchedulingPermission 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.

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.

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.