public class UARTPermission extends DevicePermission
UARTPermission
class defines permissions for UART channel access.
A UARTPermission
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}
{channel-desc}
string (described in DevicePermission
) is
the decimal string representation of a UART channel number as may be returned by a call to
UARTConfig.getChannelNumber
. The characters in the string must all be decimal digits.
open
and powermanage
. Their meaning is defined as follows:
open
DeviceManager.open
)powermanage
PowerManaged
)DeviceManager.open
,
PowerManaged
,
Serialized FormOPEN, POWER_MANAGE
Constructor and Description |
---|
UARTPermission(java.lang.String name)
Constructs a new
UARTPermission with the specified target name and the implicit open action. |
UARTPermission(java.lang.String name,
java.lang.String actions)
Constructs a new
UARTPermission instance with the specified target name and action list. |
Modifier and Type | Method and Description |
---|---|
boolean |
equals(java.lang.Object obj)
Checks two
UARTPermission objects for equality. |
java.lang.String |
getActions()
Returns the list of possible actions in the following order:
open or powermanage . |
int |
hashCode()
Returns the hash code value for this object.
|
boolean |
implies(java.security.Permission permission)
Checks if this
UARTPermission object "implies" the specified permission. |
java.security.PermissionCollection |
newPermissionCollection()
Returns a new
PermissionCollection for storing UARTPermission objects. |
public UARTPermission(java.lang.String name)
UARTPermission
with the specified target name and the implicit open
action.name
- the target name (as defined above).java.lang.NullPointerException
- if name
is null
.getName
public UARTPermission(java.lang.String name, java.lang.String actions)
UARTPermission
instance with the specified target name and action list.name
- the target name (as defined above).actions
- comma-separated list of device operations: open
or powermanage
.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.getName
public boolean equals(java.lang.Object obj)
UARTPermission
objects for equality.equals
in class DevicePermission
obj
- the object to test for equality with this object.true
if obj
is a UARTPermission
and has the same target name and actions as
this UARTPermission
object.public java.lang.String getActions()
open
or powermanage
. getActions
in class DevicePermission
public int hashCode()
hashCode
in class DevicePermission
public boolean implies(java.security.Permission permission)
UARTPermission
object "implies" the specified permission.
More specifically, this method returns true
if:
permission
is an instance of UARTPermission
, and
permission
's actions are a proper subset of this object's action list, and
permission
's hardware addressing information or range thereof
is included in this UARTPermission
's hardware addressing information range.
implies
in class DevicePermission
permission
- the permission to check against.true
if the specified permission is not null
and is implied by this object, false
otherwise.public java.security.PermissionCollection newPermissionCollection()
PermissionCollection
for storing UARTPermission
objects.
UARTPermission
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).
newPermissionCollection
in class DevicePermission
PermissionCollection
suitable for storing UARTPermission
objects, or null
if
one is not defined.Copyright © 2012, 2014, Oracle and/or its affiliates. All rights reserved.
Legal Notices