* Copyright (c) OSGi Alliance (2001, 2010). All Rights Reserved.
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
Roleobjects managed by the User Admin service.
This interface exposes the characteristics shared by all
classes: a name, a type, and a set of properties.
Properties represent public information about the
Role object that
can be read by anyone. Specific
required to change a
Role object's properties.
Role object properties are
Dictionary objects. Changes
to these objects are propagated to the User Admin service and made
Every User Admin service contains a set of predefined
that are always present and cannot be removed. All predefined
objects are of type
ROLE. This version of the
org.osgi.service.useradmin package defines a single predefined
role named "user.anyone", which is inherited by any other role.
Other predefined roles may be added in the future. Since
"user.anyone" is a
Role object that has properties
associated with it that can be read and modified. Access to these properties
and their use is application specific and is controlled using
UserAdminPermission in the same way that properties for other
Role objects are.
The value of
USER is 1.
The value of
GROUP is 2.
Dictionaryof the (public) properties of this
Roleobject. Any changes to the returned
Dictionarywill change the properties of this
Roleobject. This will cause a
UserAdminEventobject of type
to be broadcast to any
Only objects of type
String may be used as property keys, and
only objects of type
byte may be used
as property values. Any other types will cause an exception of type
IllegalArgumentException to be raised.
In order to add, change, or remove a property in the returned
named after the
property name (or a prefix of it) with action
Dictionarycontaining the properties of this