Top Description Fields Methods
org.osgi.service.useradmin

public Interface User

extends Role
Known Direct Subinterfaces
org.osgi.service.useradmin.Group
Imports
java.util.Dictionary
A User role 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.

In general, 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.

A User object may have credentials (and properties, inherited from the Role class) associated with it. Specific UserAdminPermission objects are required to read or change a User object's credentials.

Credentials are Dictionary objects and have semantics that are similar to the properties in the Role class.

Author
$Id: 107799c7cddf7a85ee3bb60d1fa5c7cec6d66b9e $

Field Summary

Inherited from org.osgi.service.useradmin.Role:
GROUPROLEUSERUSER_ANYONE

Method Summary

Modifier and TypeMethod and Description
public Dictionary<String, Object>

Returns:

Dictionary object containing the credentials of this User object.
getCredentials()

Returns a Dictionary of the credentials of this User object.

public boolean

Returns:

true if this user has the specified credential; false otherwise.
hasCredential(String
The credential key.
key, Object
The credential value.
value)

Checks to see if this User object has a credential with the specified key set to the specified value.

Inherited from org.osgi.service.useradmin.Role:
getNamegetPropertiesgetType

Method Detail

getCredentialsback to summary
public Dictionary<String, Object> getCredentials()

Returns a Dictionary of the credentials of this User object. Any changes to the returned Dictionary object will change the credentials of this User object. This will cause a UserAdminEvent object of type UserAdminEvent#ROLE_CHANGED to be broadcast to any UserAdminListeners objects.

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 Dictionary object, a UserAdminPermission 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 UserAdminPermission named after the credential name (or a prefix of it) with action changeCredential is required.

Returns:Dictionary<String, Object>

Dictionary object containing the credentials of this User object.

hasCredentialback to summary
public boolean hasCredential(String key, Object value)

Checks to see if this User object has a credential with the specified key set to the specified value.

If the specified credential value is not of type String or byte[], it is ignored, that is, false is returned (as opposed to an IllegalArgumentException being raised).

Parameters
key:String

The credential key.

value:Object

The credential value.

Returns:boolean

true if this user has the specified credential; false otherwise.

Exceptions
SecurityException:
If a security manager exists and the caller does not have the UserAdminPermission named after the credential key (or a prefix of it) with action getCredential.