UserDatabase (Apache Tomcat 7.0.67 API Documentation)

All Known Implementing Classes:

MemoryUserDatabase
```
public interface UserDatabase
```
Abstract representation of a database of Users and Groups that can be maintained by an application, along with definitions of corresponding Roles, and referenced by a Realm for authentication and access control.

Since:

4.1

Author:

Craig R. McClanahan

Method Summary

Methods
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.

- Method Detail
  - getGroups
```
java.util.Iterator<Group> getGroups()
```
    Return the set of Groups defined in this user database.
  - getId
```
java.lang.String getId()
```
    Return the unique global identifier of this user database.
  - getRoles
```
java.util.Iterator<Role> getRoles()
```
    Return the set of Roles defined in this user database.
  - getUsers
```
java.util.Iterator<User> getUsers()
```
    Return the set of Users defined in this user database.
  - close
```
void close()
           throws java.lang.Exception
```
    Finalize access to this user database.
    
    Throws:
    
    java.lang.Exception - if any exception is thrown during closing
  - createGroup
```
Group createGroup(java.lang.String groupname,
                java.lang.String description)
```
    Create and return a new Group defined in this user database.
    
    Parameters:
    groupname - The group name of the new group (must be unique)
    description - The description of this group
  - createRole
```
Role createRole(java.lang.String rolename,
              java.lang.String description)
```
    Create and return a new Role defined in this user database.
    
    Parameters:
    rolename - The role name of the new role (must be unique)
    description - The description of this role
  - createUser
```
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.
    
    Parameters:
    username - The logon username of the new user (must be unique)
    password - The logon password of the new user
    fullName - The full name of the new user
  - findGroup
```
Group findGroup(java.lang.String groupname)
```
    Return the Group with the specified group name, if any; otherwise return null.
    
    Parameters:
    groupname - Name of the group to return
  - findRole
```
Role findRole(java.lang.String rolename)
```
    Return the Role with the specified role name, if any; otherwise return null.
    
    Parameters:
    rolename - Name of the role to return
  - findUser
```
User findUser(java.lang.String username)
```
    Return the User with the specified user name, if any; otherwise return null.
    
    Parameters:
    username - Name of the user to return
  - open
```
void open()
          throws java.lang.Exception
```
    Initialize access to this user database.
    
    Throws:
    
    java.lang.Exception - if any exception is thrown during opening
  - removeGroup
```
void removeGroup(Group group)
```
    Remove the specified Group from this user database.
    
    Parameters:
    group - The group to be removed
  - removeRole
```
void removeRole(Role role)
```
    Remove the specified Role from this user database.
    
    Parameters:
    role - The role to be removed
  - removeUser
```
void removeUser(User user)
```
    Remove the specified User from this user database.
    
    Parameters:
    user - The user to be removed
  - save
```
void save()
          throws java.lang.Exception
```
    Save any updated information to the persistent storage location for this user database.
    
    Throws:
    
    java.lang.Exception - if any exception is thrown during saving

Interface UserDatabase

Method Summary

Method Detail

getGroups

getId

getRoles

getUsers

close

createGroup

createRole

createUser

findGroup

findRole

findUser

open

removeGroup

removeRole

removeUser

save