public final class PowerStatePermission
extends java.security.BasicPermission
PowerManager.setPowerState
method. If the name is "set", calls to setPowerState(..., false)
are allowed. In order to grant any call to setPowerState
method, including setPowerState(..., true)
, the permission
"setUrgent" is required. Implementations are recommended to grant
it only to system applications. Possible names: "set",
"setUrgent".Constructor and Description |
---|
PowerStatePermission(java.lang.String name)
Creates a new PowerStatePermission object.
|
Modifier and Type | Method and Description |
---|---|
boolean |
implies(java.security.Permission p)
Checks if the specified permission is "implied" by this object.
|
java.security.PermissionCollection |
newPermissionCollection()
Returns a new
PermissionCollection object for storing
PowerStatePermission objects. |
public PowerStatePermission(java.lang.String name)
name
- Permission name. Must be "set" or "setUrgent".java.lang.NullPointerException
- if name is nulljava.lang.IllegalArgumentException
- if name is not validpublic boolean implies(java.security.Permission p)
More specifically, this method returns true
if:
p
's class is the same as this object's class, andp
's name equals or (in the case of wildcards) is
implied by this object's name.
As setUrgent
implies set
for
PowerStatePermission
, the version of this method from
BasicPermission
won't work and has to be overridden.
implies
in class java.security.BasicPermission
p
- the permission to check against.true
if the passed permission is equal to or implied
by this permission, false
otherwise.public java.security.PermissionCollection newPermissionCollection()
PermissionCollection
object for storing
PowerStatePermission
objects.
PowerStatePermission
objects must be stored in a manner that
allows them to be inserted in any order, but that also enables the
PermissionCollection
implies
method to be
implemented in an efficient (and consistent) manner.
As setUrgent
implies set
for
PowerStatePermission
, the version of this method from
BasicPermission
won't work and has to be overridden.
newPermissionCollection
in class java.security.BasicPermission
PermissionCollection
object suitable for
storing PowerStatePermissions
.Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved. Use of this specification is subject to license terms.