org.osgi.service.permissionadmin
public class PermissionInfo extends Object
This class encapsulates three pieces of information: a Permission type
(class name), which must be a subclass of
java.security.Permission
, and the name and actions
arguments passed to its constructor.
In order for a permission represented by a PermissionInfo
to be
instantiated and considered during a permission check, its Permission class
must be available from the system classpath or an exported package. This
means that the instantiation of a permission represented by a
PermissionInfo
may be delayed until the package containing its
Permission class has been exported by a bundle.
Version: $Revision: 1.16 $
Constructor Summary | |
---|---|
PermissionInfo(String type, String name, String actions)
Constructs a PermissionInfo from the specified type, name, and
actions.
| |
PermissionInfo(String encodedPermission)
Constructs a PermissionInfo object from the specified encoded
PermissionInfo string. |
Method Summary | |
---|---|
boolean | equals(Object obj)
Determines the equality of two PermissionInfo objects.
|
String | getActions()
Returns the actions of the permission represented by this
PermissionInfo .
|
String | getEncoded()
Returns the string encoding of this PermissionInfo in a form
suitable for restoring this PermissionInfo .
|
String | getName()
Returns the name of the permission represented by this
PermissionInfo .
|
String | getType()
Returns the fully qualified class name of the permission represented by
this PermissionInfo .
|
int | hashCode()
Returns the hash code value for this object.
|
String | toString()
Returns the string representation of this PermissionInfo . |
PermissionInfo
from the specified type, name, and
actions.
Parameters: type The fully qualified class name of the permission represented
by this PermissionInfo
. The class must be a subclass
of java.security.Permission
and must define a
2-argument constructor that takes a name string and an
actions string.
name The permission name that will be passed as the first argument
to the constructor of the Permission
class identified
by type
.
actions The permission actions that will be passed as the second
argument to the constructor of the Permission
class
identified by type
.
Throws: java.lang.NullPointerException if type
is
null
. java.lang.IllegalArgumentException if action
is not
null
and name
is null
.
PermissionInfo
object from the specified encoded
PermissionInfo
string. White space in the encoded
PermissionInfo
string is ignored.
Parameters: encodedPermission The encoded PermissionInfo
.
Throws: java.lang.IllegalArgumentException If the
encodedPermission
is not properly formatted.
See Also: PermissionInfo
PermissionInfo
objects.
This method checks that specified object has the same type, name and
actions as this PermissionInfo
object.
Parameters: obj The object to test for equality with this
PermissionInfo
object.
Returns: true
if obj
is a PermissionInfo
,
and has the same type, name and actions as this
PermissionInfo
object; false
otherwise.
PermissionInfo
.
Returns: The actions of the permission represented by this
PermissionInfo
, or null
if the permission
does not have any actions associated with it.
PermissionInfo
in a form
suitable for restoring this PermissionInfo
.
The encoded format is:
(type)or
(type "name")or
(type "name" "actions")where name and actions are strings that are encoded for proper parsing. Specifically, the
"
,\
, carriage
return, and linefeed characters are escaped using \"
,
\\
,\r
, and \n
, respectively.
The encoded string contains no leading or trailing whitespace characters. A single space character is used between type and "name" and between "name" and "actions".
Returns: The string encoding of this PermissionInfo
.
PermissionInfo
.
Returns: The name of the permission represented by this
PermissionInfo
, or null
if the permission
does not have a name.
PermissionInfo
.
Returns: The fully qualified class name of the permission represented by
this PermissionInfo
.
Returns: A hash code value for this object.
PermissionInfo
. The
string is created by calling the getEncoded
method on this
PermissionInfo
.
Returns: The string representation of this PermissionInfo
.