jdk.dio.atcmd

Class ATPermission

java.lang.Object

java.security.Permission

jdk.dio.DevicePermission

jdk.dio.atcmd.ATPermission

All Implemented Interfaces:

java.io.Serializable, java.security.Guard

public class ATPermission
extends DevicePermission

The ATPermission class defines permissions for AT device access.

A ATPermission permission has a target name and a list of actions.

The target name contains hardware addressing information. The format is the one defined for the base DevicePermission class with the following addition:

{channel-desc}

The {channel-desc} string (described in DevicePermission) is the decimal string representation of a channel number as may be returned by a call to ATDeviceConfig.getChannelNumber. The characters in the string must all be decimal digits.

The actions to be granted are passed to the constructor in a string containing a list of one or more comma-separated keywords. The supported keywords are open, data and powermanage. Their meaning is defined as follows:

open

open and access an AT device functions (see DeviceManager.open(java.lang.Class<P>, jdk.dio.DeviceConfig<? super P>))

data

open data connections (see ATDevice.openDataConnection(java.lang.String, jdk.dio.atcmd.CommandResponseHandler, jdk.dio.atcmd.DataConnectionHandler))

powermanage

manage the power saving mode of a device (see PowerManaged)

See Also:

DeviceManager.open, PowerManaged, ATDevice.openDataConnection, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DATA The data action.

Fields inherited from class jdk.dio.DevicePermission

OPEN, POWER_MANAGE

Constructor Summary

Constructors

Constructor and Description
ATPermission(java.lang.String name) Constructs a new ATPermission with the specified target name and implicit open action.
ATPermission(java.lang.String name, java.lang.String actions) Constructs a new ATPermission instance with the specified target name and action list.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Checks two ATPermission objects for equality.
java.lang.String	getActions() Returns the list of possible actions in the following order: open, data and powermanage.
int	hashCode() Returns the hash code value for this object.
boolean	implies(java.security.Permission permission) Checks if this ATPermission object "implies" the specified permission.
java.security.PermissionCollection	newPermissionCollection() Returns a new PermissionCollection for storing ATPermission objects.

Methods inherited from class java.security.Permission

checkGuard, getName, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

DATA

public static final java.lang.String DATA

The data action.

See Also:

Constant Field Values

Constructor Detail

ATPermission

public ATPermission(java.lang.String name)

Constructs a new ATPermission with the specified target name and implicit open action.

Parameters:

name - the target name (as defined above).

Throws:

java.lang.NullPointerException - if name is null.

See Also:

getName

ATPermission

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

Constructs a new ATPermission instance with the specified target name and action list.

Parameters:

name - the target name (as defined above).

actions - comma-separated list of AT device operations: open, data or powermanage.

Throws:

java.lang.NullPointerException - if name is null.

java.lang.IllegalArgumentException - if actions is null, empty or contains an action other than the specified possible actions.

Method Detail

equals

public boolean equals(java.lang.Object obj)

Checks two ATPermission objects for equality.

Overrides:

equals in class DevicePermission

Parameters:

obj - the object to test for equality with this object.

Returns:

true if obj is a ATPermission and has the same target name and actions as this ATPermission object.

getActions

public java.lang.String getActions()

Returns the list of possible actions in the following order: open, data and powermanage.

Overrides:

getActions in class DevicePermission

Returns:

comma-separated list of possible actions.

hashCode

public int hashCode()

Returns the hash code value for this object.

Overrides:

hashCode in class DevicePermission

Returns:

a hash code value for this object.

implies

public boolean implies(java.security.Permission permission)

Checks if this ATPermission object "implies" the specified permission.

More specifically, this method returns true if:

• permission is an instance of ATPermission, and
• permission's actions are a proper subset of this action list, and
• permission's hardware addressing information or range thereof is included in this ATPermission's hardware addressing information range.

Overrides:

implies in class DevicePermission

Parameters:

permission - the permission to check against.

Returns:

true if the specified permission is not null and is implied by this object, false otherwise.

newPermissionCollection

public java.security.PermissionCollection newPermissionCollection()

Returns a new PermissionCollection for storing ATPermission objects.

ATPermission objects must be stored in a manner that allows them to be inserted into the collection in any order, but that also enables the PermissionCollection implies method to be implemented in an efficient (and consistent) manner.

If null is returned, then the caller of this method is free to store permissions of this type in any PermissionCollection they choose (one that uses a Hashtable, one that uses a Vector, etc).

Overrides:

newPermissionCollection in class DevicePermission

Returns:

a new PermissionCollection suitable for storing ATPermission objects, or null if one is not defined.