javax.realtime

Class TaskPermission

java.lang.Object

java.security.Permission

javax.realtime.RealtimePermission

javax.realtime.TaskPermission

All Implemented Interfaces:

Serializable, Guard

public class TaskPermission
extends RealtimePermission

Task permissions are for controlling threads and handlers, as well as creating clocks. 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 task.	Scheduling Risk
create	Enables new thread, timers, and tasks to be created.	Scheduling Risk
handle	Adds handler to an asynchronous event.	Load Risk
override	Interference Risk.
system	Changes system wide tasking behavior.	Load and Scheduling Risk

The risk classes are defined in RealtimePermission.

Since:

RTSJ 2.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
TaskPermission(String actions) Creates a new TaskPermission object for a given action, i.e., the symbolic name of an action.
TaskPermission(String target, String actions) Creates a new TaskPermission object for a given action, i.e., the symbolic name of an action.
TaskPermission(ThreadGroup group, String actions) Creates a new TaskPermission object for a given action, i.e., the symbolic name of an action.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object other) Compare two Permission objects for equality.
String	getActions() Obtain the actions as a String in canonical form.
int	hashCode() Obtain the hash code value for this object.
boolean	implies(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

TaskPermission

public TaskPermission(String target,
                      String actions)

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

Throws:

NullPointerException - when action is null.

StaticIllegalArgumentException - when target or action is empty.

Parameters:

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

TaskPermission

public TaskPermission(ThreadGroup group,
                      String actions)

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

Throws:

NullPointerException - when action is null.

StaticIllegalArgumentException - when group is null or action is empty.

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.

TaskPermission

public TaskPermission(String actions)

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

Throws:

NullPointerException - when action is null.

StaticIllegalArgumentException - when action is empty.

Parameters:

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

Method Detail

equals

public boolean equals(Object other)

Description copied from class: RealtimePermission

Compare two Permission objects for equality.

Specified by:

equals in class RealtimePermission

Parameters:

other - is the object with which to compare.

Returns:

true when yes and false otherwise.

See Also:

Object.hashCode(), HashMap

getActions

public String getActions()

Description copied from class: RealtimePermission

Obtain the actions as a String in canonical form.

Specified by:

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.

Specified by:

hashCode in class RealtimePermission

Returns:

the has code value.

See Also:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

implies

public boolean implies(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.

Specified by:

implies in class RealtimePermission

Parameters:

permission - is the permission to check.

Returns:

true when yes and false otherwise.