public interface UserDatabase
Abstract representation of a database of User
s and
Group
s that can be maintained by an application,
along with definitions of corresponding Role
s, and
referenced by a Realm
for authentication and access control.
Modifier and Type | Method and Description |
---|---|
void |
close()
Finalize access to this user database.
|
Group |
createGroup(java.lang.String groupname,
java.lang.String description)
Create and return a new
Group defined in this user database. |
Role |
createRole(java.lang.String rolename,
java.lang.String description)
Create and return a new
Role defined in this user database. |
User |
createUser(java.lang.String username,
java.lang.String password,
java.lang.String fullName)
Create and return a new
User defined in this user database. |
Group |
findGroup(java.lang.String groupname)
Return the
Group with the specified group name, if any;
otherwise return null . |
Role |
findRole(java.lang.String rolename)
Return the
Role with the specified role name, if any;
otherwise return null . |
User |
findUser(java.lang.String username)
Return the
User with the specified user name, if any;
otherwise return null . |
java.util.Iterator<Group> |
getGroups()
Return the set of
Group s defined in this user database. |
java.lang.String |
getId()
Return the unique global identifier of this user database.
|
java.util.Iterator<Role> |
getRoles()
Return the set of
Role s defined in this user database. |
java.util.Iterator<User> |
getUsers()
Return the set of
User s defined in this user database. |
void |
open()
Initialize access to this user database.
|
void |
removeGroup(Group group)
Remove the specified
Group from this user database. |
void |
removeRole(Role role)
Remove the specified
Role from this user database. |
void |
removeUser(User user)
Remove the specified
User from this user database. |
void |
save()
Save any updated information to the persistent storage location for
this user database.
|
java.util.Iterator<Group> getGroups()
Group
s defined in this user database.java.lang.String getId()
void close() throws java.lang.Exception
java.lang.Exception
- if any exception is thrown during closingGroup createGroup(java.lang.String groupname, java.lang.String description)
Group
defined in this user database.groupname
- The group name of the new group (must be unique)description
- The description of this groupRole createRole(java.lang.String rolename, java.lang.String description)
Role
defined in this user database.rolename
- The role name of the new role (must be unique)description
- The description of this roleUser createUser(java.lang.String username, java.lang.String password, java.lang.String fullName)
User
defined in this user database.username
- The logon username of the new user (must be unique)password
- The logon password of the new userfullName
- The full name of the new userGroup findGroup(java.lang.String groupname)
Group
with the specified group name, if any;
otherwise return null
.groupname
- Name of the group to returnRole findRole(java.lang.String rolename)
Role
with the specified role name, if any;
otherwise return null
.rolename
- Name of the role to returnUser findUser(java.lang.String username)
User
with the specified user name, if any;
otherwise return null
.username
- Name of the user to returnvoid open() throws java.lang.Exception
java.lang.Exception
- if any exception is thrown during openingvoid removeGroup(Group group)
Group
from this user database.group
- The group to be removedvoid removeRole(Role role)
Role
from this user database.role
- The role to be removedvoid removeUser(User user)
User
from this user database.user
- The user to be removedvoid save() throws java.lang.Exception
java.lang.Exception
- if any exception is thrown during savingCopyright © 2000-2018 Apache Software Foundation. All Rights Reserved.