MemoryUserDatabase (Apache Tomcat 7.0.109 API Documentation)

java.lang.Object
- org.apache.catalina.users.MemoryUserDatabase

All Implemented Interfaces:

UserDatabase
```
public class MemoryUserDatabase
extends Object
implements UserDatabase
```
Concrete implementation of UserDatabase that loads all defined users, groups, and roles into an in-memory data structure, and uses a specified XML file for its persistent storage.

Since:

4.1

Author:

Craig R. McClanahan

Field Summary

Fields
Modifier and Type	Field and Description
`protected HashMap<String,Group>`	`groups` The set of `Group`s defined in this database, keyed by group name.
`protected String`	`id` The unique global identifier of this user database.
`protected String`	`pathname` The relative (to `catalina.base`) or absolute pathname to the XML file in which we will save our persistent information.
`protected String`	`pathnameNew` The relative or absolute pathname of the file in which we write our new information prior to renaming.
`protected String`	`pathnameOld` The relative or absolute pathname to the file in which our old information is stored while renaming is in progress.
`protected boolean`	`readonly` A flag, indicating if the user database is read only.
`protected HashMap<String,Role>`	`roles` The set of `Role`s defined in this database, keyed by role name.
`protected HashMap<String,User>`	`users` The set of `User`s defined in this database, keyed by user name.

Constructor Summary

Constructors
Constructor and Description

MemoryUserDatabase()
Create a new instance with default values.

MemoryUserDatabase(String id)
Create a new instance with the specified values.

Constructors
Constructor and Description
`MemoryUserDatabase()` Create a new instance with default values.
`MemoryUserDatabase(String id)` Create a new instance with the specified values.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`close()` Finalize access to this user database.
`Group`	`createGroup(String groupname, String description)` Create and return a new `Group` defined in this user database.
`Role`	`createRole(String rolename, String description)` Create and return a new `Role` defined in this user database.
`User`	`createUser(String username, String password, String fullName)` Create and return a new `User` defined in this user database.
`Group`	`findGroup(String groupname)` Return the `Group` with the specified group name, if any; otherwise return `null`.
`Role`	`findRole(String rolename)` Return the `Role` with the specified role name, if any; otherwise return `null`.
`User`	`findUser(String username)` Return the `User` with the specified user name, if any; otherwise return `null`.
`Iterator<Group>`	`getGroups()` Return the set of `Group`s defined in this user database.
`String`	`getId()` Return the unique global identifier of this user database.
`String`	`getPathname()` Return the relative or absolute pathname to the persistent storage file.
`boolean`	`getReadonly()` Returning the readonly status of the user database
`Iterator<Role>`	`getRoles()` Return the set of `Role`s defined in this user database.
`Iterator<User>`	`getUsers()` Return the set of `User`s defined in this user database.
`boolean`	`isWriteable()` Check for permissions to save this user database to persistent storage location
`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.
`void`	`setPathname(String pathname)` Set the relative or absolute pathname to the persistent storage file.
`void`	`setReadonly(boolean readonly)` Setting the readonly status of the user database
`String`	`toString()` Return a String representation of this UserDatabase.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - groups
```
protected final HashMap<String,Group> groups
```
    The set of Groups defined in this database, keyed by group name.
  - id
```
protected final String id
```
    The unique global identifier of this user database.
  - pathname
```
protected String pathname
```
    The relative (to catalina.base) or absolute pathname to the XML file in which we will save our persistent information.
  - pathnameOld
```
protected String pathnameOld
```
    The relative or absolute pathname to the file in which our old information is stored while renaming is in progress.
  - pathnameNew
```
protected String pathnameNew
```
    The relative or absolute pathname of the file in which we write our new information prior to renaming.
  - readonly
```
protected boolean readonly
```
    A flag, indicating if the user database is read only.
  - roles
```
protected final HashMap<String,Role> roles
```
    The set of Roles defined in this database, keyed by role name.
  - users
```
protected final HashMap<String,User> users
```
    The set of Users defined in this database, keyed by user name.
- Constructor Detail
  - MemoryUserDatabase
```
public MemoryUserDatabase()
```
    Create a new instance with default values.
  - MemoryUserDatabase
```
public MemoryUserDatabase(String id)
```
    Create a new instance with the specified values.
    
    Parameters:
    id - Unique global identifier of this user database
- Method Detail
  - getGroups
```
public Iterator<Group> getGroups()
```
    Return the set of Groups defined in this user database.
    
    Specified by:
    
    getGroups in interface UserDatabase
    
    Returns:
    the set of Groups defined in this user database.
  - getId
```
public String getId()
```
    Return the unique global identifier of this user database.
    
    Specified by:
    
    getId in interface UserDatabase
    
    Returns:
    the unique global identifier of this user database.
  - getPathname
```
public String getPathname()
```
    Return the relative or absolute pathname to the persistent storage file.
  - setPathname
```
public void setPathname(String pathname)
```
    Set the relative or absolute pathname to the persistent storage file.
    
    Parameters:
    pathname - The new pathname
  - getReadonly
```
public boolean getReadonly()
```
    Returning the readonly status of the user database
  - setReadonly
```
public void setReadonly(boolean readonly)
```
    Setting the readonly status of the user database
    
    Parameters:
    readonly - the new status
  - getRoles
```
public Iterator<Role> getRoles()
```
    Return the set of Roles defined in this user database.
    
    Specified by:
    
    getRoles in interface UserDatabase
    
    Returns:
    the set of Roles defined in this user database.
  - getUsers
```
public Iterator<User> getUsers()
```
    Return the set of Users defined in this user database.
    
    Specified by:
    
    getUsers in interface UserDatabase
    
    Returns:
    the set of Users defined in this user database.
  - close
```
public void close()
           throws Exception
```
    Finalize access to this user database.
    
    Specified by:
    
    close in interface UserDatabase
    
    Throws:
    
    Exception - if any exception is thrown during closing
  - createGroup
```
public Group createGroup(String groupname,
                String description)
```
    Create and return a new Group defined in this user database.
    
    Specified by:
    
    createGroup in interface UserDatabase
    
    Parameters:
    groupname - The group name of the new group (must be unique)
    description - The description of this group
    
    Returns:
    The new group
  - createRole
```
public Role createRole(String rolename,
              String description)
```
    Create and return a new Role defined in this user database.
    
    Specified by:
    
    createRole in interface UserDatabase
    
    Parameters:
    rolename - The role name of the new group (must be unique)
    description - The description of this group
    
    Returns:
    The new role
  - createUser
```
public User createUser(String username,
              String password,
              String fullName)
```
    Create and return a new User defined in this user database.
    
    Specified by:
    
    createUser in interface UserDatabase
    
    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
    
    Returns:
    The new user
  - findGroup
```
public Group findGroup(String groupname)
```
    Return the Group with the specified group name, if any; otherwise return null.
    
    Specified by:
    
    findGroup in interface UserDatabase
    
    Parameters:
    groupname - Name of the group to return
    
    Returns:
    the Group with the specified group name, if any; otherwise return null.
  - findRole
```
public Role findRole(String rolename)
```
    Return the Role with the specified role name, if any; otherwise return null.
    
    Specified by:
    
    findRole in interface UserDatabase
    
    Parameters:
    rolename - Name of the role to return
    
    Returns:
    the Role with the specified role name, if any; otherwise return null.
  - findUser
```
public User findUser(String username)
```
    Return the User with the specified user name, if any; otherwise return null.
    
    Specified by:
    
    findUser in interface UserDatabase
    
    Parameters:
    username - Name of the user to return
    
    Returns:
    the User with the specified user name, if any; otherwise return null.
  - open
```
public void open()
          throws Exception
```
    Initialize access to this user database.
    
    Specified by:
    
    open in interface UserDatabase
    
    Throws:
    
    Exception - if any exception is thrown during opening
  - removeGroup
```
public void removeGroup(Group group)
```
    Remove the specified Group from this user database.
    
    Specified by:
    
    removeGroup in interface UserDatabase
    
    Parameters:
    group - The group to be removed
  - removeRole
```
public void removeRole(Role role)
```
    Remove the specified Role from this user database.
    
    Specified by:
    
    removeRole in interface UserDatabase
    
    Parameters:
    role - The role to be removed
  - removeUser
```
public void removeUser(User user)
```
    Remove the specified User from this user database.
    
    Specified by:
    
    removeUser in interface UserDatabase
    
    Parameters:
    user - The user to be removed
  - isWriteable
```
public boolean isWriteable()
```
    Check for permissions to save this user database to persistent storage location
  - save
```
public void save()
          throws Exception
```
    Save any updated information to the persistent storage location for this user database.
    
    Specified by:
    
    save in interface UserDatabase
    
    Throws:
    
    Exception - if any exception is thrown during saving
  - toString
```
public String toString()
```
    Return a String representation of this UserDatabase.
    
    Overrides:
    
    toString in class Object

Class MemoryUserDatabase

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

groups

id

pathname

pathnameOld

pathnameNew

readonly

roles

users

Constructor Detail

MemoryUserDatabase

MemoryUserDatabase

Method Detail

getGroups

getId

getPathname

setPathname

getReadonly

setReadonly

getRoles

getUsers

close

createGroup

createRole

createUser

findGroup

findRole

findUser

open

removeGroup

removeRole

removeUser

isWriteable

save

toString