org.apache.catalina.users
Class MemoryUserDatabase

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

Version:

$Id: MemoryUserDatabase.java 1301272 2012-03-15 23:41:08Z markt $

Author:

Craig R. McClanahan

Field Summary

protected HashMap<String,Group>	groups The set of Groups 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 Roles defined in this database, keyed by role name.
protected HashMap<String,User>	users The set of Users defined in this database, keyed by user name.

Constructor Summary

MemoryUserDatabase()
Create a new instance with default values.

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

Method Summary

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 Groups 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 Roles defined in this user database.
Iterator<User>	getUsers() Return the set of Users 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

getId

public String getId()

Return the unique global identifier of this user database.

Specified by:

getId in interface UserDatabase

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

getUsers

public Iterator<User> getUsers()

Return the set of Users defined in this user database.

Specified by:

getUsers in interface UserDatabase

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

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

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

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

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

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

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