* Copyright (c) OSGi Alliance (2001, 2013). 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.
Userrole managed by a User Admin service.
In this context, the term "user" is not limited to just human beings. Instead, it refers to any entity that may have any number of credentials associated with it that it may use to authenticate itself.
User objects are associated with a specific User Admin
service (namely the one that created them), and cannot be used with other
User Admin services.
Dictionary objects and have semantics that are
similar to the properties in the
Dictionaryof the credentials of this
Userobject. Any changes to the returned
Dictionaryobject will change the credentials of this
Userobject. This will cause a
UserAdminEventobject of type
to be broadcast to any
Only objects of type
String may be used as credential keys, and
only objects of type
String or of type
byte may be used
as credential values. Any other types will cause an exception of type
IllegalArgumentException to be raised.
In order to retrieve a credential from the returned
named after the credential name (or
a prefix of it) with action
getCredential is required.
In order to add or remove a credential from the returned
Dictionary object, a
named after the
credential name (or a prefix of it) with action
Dictionaryobject containing the credentials of this
Userobject has a credential with the specified
keyset to the specified
If the specified credential
value is not of type
byte, it is ignored, that is,
false is returned (as
opposed to an
IllegalArgumentException being raised).
trueif this user has the specified credential;
java.lang.SecurityExceptionIf a security manager exists and the caller does not have the
UserAdminPermissionnamed after the credential key (or a prefix of it) with action