com.ecyrd.jspwiki.auth.user
Class XMLUserDatabase

java.lang.Object
  extended by com.ecyrd.jspwiki.auth.user.AbstractUserDatabase
      extended by com.ecyrd.jspwiki.auth.user.XMLUserDatabase
All Implemented Interfaces:
UserDatabase

public class XMLUserDatabase
extends AbstractUserDatabase

Manages DefaultUserProfile objects using XML files for persistence. Passwords are hashed using SHA1. User entries are simple <user> elements under the root. User profile properties are attributes of the element. For example:

<users>
  <user loginName="janne" fullName="Janne Jalkanen"
    wikiName="JanneJalkanen" email="janne@ecyrd.com"
    password="{SHA}457b08e825da547c3b77fbc1ff906a1d00a7daee"/>
</users>

In this example, the un-hashed password is myP@5sw0rd. Passwords are hashed without salt.

Since:
2.3
Version:
$Revision: 1.14 $ $Date: 2006/05/20 23:56:17 $
Author:
Andrew Jaquith

Field Summary
static String PROP_USERDATABASE
          The jspwiki.properties property specifying the file system location of the user database.
 
Fields inherited from class com.ecyrd.jspwiki.auth.user.AbstractUserDatabase
log, PROP_SHARED_WITH_CONTAINER, SHA_PREFIX
 
Constructor Summary
XMLUserDatabase()
           
 
Method Summary
 void commit()
          Persists database changes to disk.
 void deleteByLoginName(String loginName)
          Looks up and deletes the first UserProfile in the user database that matches a profile having a given login name.
 UserProfile findByEmail(String index)
          Looks up and returns the first UserProfilein the user database that matches a profile having a given e-mail address.
 UserProfile findByFullName(String index)
          Looks up and returns the first UserProfilein the user database that matches a profile having a given full name.
 UserProfile findByLoginName(String index)
          Looks up and returns the first UserProfilein the user database that matches a profile having a given login name.
 UserProfile findByWikiName(String index)
          Looks up and returns the first UserProfilein the user database that matches a profile having a given wiki name.
 Principal[] getWikiNames()
          Returns all WikiNames that are stored in the UserDatabase as an array of WikiPrincipal objects.
 void initialize(WikiEngine engine, Properties props)
          Initializes the user database based on values from a Properties object.
 boolean isSharedWithContainer()
          Determines whether the user database shares user/password data with the web container; always returns false.
 void save(UserProfile profile)
          Saves a UserProfileto the user database, overwriting the existing profile if it exists.
 
Methods inherited from class com.ecyrd.jspwiki.auth.user.AbstractUserDatabase
find, getHash, getPrincipals, newProfile, validatePassword
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

PROP_USERDATABASE

public static final String PROP_USERDATABASE
The jspwiki.properties property specifying the file system location of the user database.

See Also:
Constant Field Values
Constructor Detail

XMLUserDatabase

public XMLUserDatabase()
Method Detail

commit

public void commit()
            throws WikiSecurityException
Persists database changes to disk.

Specified by:
commit in interface UserDatabase
Specified by:
commit in class AbstractUserDatabase
Throws:
WikiSecurityException
See Also:
UserDatabase.commit()

deleteByLoginName

public void deleteByLoginName(String loginName)
                       throws NoSuchPrincipalException,
                              WikiSecurityException
Looks up and deletes the first UserProfile in the user database that matches a profile having a given login name. If the user database does not contain a user with a matching attribute, throws a NoSuchPrincipalException. The method does not commit the results of the delete; it only alters the database in memory.

Parameters:
loginName - the login name of the user profile that shall be deleted
Throws:
NoSuchPrincipalException
WikiSecurityException

findByEmail

public UserProfile findByEmail(String index)
                        throws NoSuchPrincipalException
Looks up and returns the first UserProfilein the user database that matches a profile having a given e-mail address. If the user database does not contain a user with a matching attribute, throws a NoSuchPrincipalException.

Specified by:
findByEmail in interface UserDatabase
Specified by:
findByEmail in class AbstractUserDatabase
Parameters:
index - the e-mail address of the desired user profile
Returns:
the user profile
Throws:
NoSuchPrincipalException
See Also:
UserDatabase.findByEmail(String)

findByFullName

public UserProfile findByFullName(String index)
                           throws NoSuchPrincipalException
Looks up and returns the first UserProfilein the user database that matches a profile having a given full name. If the user database does not contain a user with a matching attribute, throws a NoSuchPrincipalException.

Specified by:
findByFullName in interface UserDatabase
Specified by:
findByFullName in class AbstractUserDatabase
Parameters:
index - the fill name of the desired user profile
Returns:
the user profile
Throws:
NoSuchPrincipalException
See Also:
UserDatabase.findByFullName(java.lang.String)

findByLoginName

public UserProfile findByLoginName(String index)
                            throws NoSuchPrincipalException
Looks up and returns the first UserProfilein the user database that matches a profile having a given login name. If the user database does not contain a user with a matching attribute, throws a NoSuchPrincipalException.

Specified by:
findByLoginName in interface UserDatabase
Specified by:
findByLoginName in class AbstractUserDatabase
Parameters:
index - the login name of the desired user profile
Returns:
the user profile
Throws:
NoSuchPrincipalException
See Also:
UserDatabase.findByLoginName(java.lang.String)

findByWikiName

public UserProfile findByWikiName(String index)
                           throws NoSuchPrincipalException
Looks up and returns the first UserProfilein the user database that matches a profile having a given wiki name. If the user database does not contain a user with a matching attribute, throws a NoSuchPrincipalException.

Specified by:
findByWikiName in interface UserDatabase
Specified by:
findByWikiName in class AbstractUserDatabase
Parameters:
index - the wiki name of the desired user profile
Returns:
the user profile
Throws:
NoSuchPrincipalException
See Also:
UserDatabase.findByWikiName(java.lang.String)

getWikiNames

public Principal[] getWikiNames()
                         throws WikiSecurityException
Returns all WikiNames that are stored in the UserDatabase as an array of WikiPrincipal objects. If the database does not contain any profiles, this method will return a zero-length array.

Returns:
the WikiNames
Throws:
WikiSecurityException

initialize

public void initialize(WikiEngine engine,
                       Properties props)
                throws NoRequiredPropertyException
Initializes the user database based on values from a Properties object. The properties object must contain a file path to the XML database file whose key is PROP_USERDATABASE.

Specified by:
initialize in interface UserDatabase
Specified by:
initialize in class AbstractUserDatabase
Throws:
NoRequiredPropertyException - if the user database cannot be located, parsed, or opened
See Also:
UserDatabase.initialize(com.ecyrd.jspwiki.WikiEngine, java.util.Properties)

isSharedWithContainer

public boolean isSharedWithContainer()
Determines whether the user database shares user/password data with the web container; always returns false.

Returns:
the result
See Also:
UserDatabase.isSharedWithContainer()

save

public void save(UserProfile profile)
          throws WikiSecurityException
Saves a UserProfileto the user database, overwriting the existing profile if it exists. The user name under which the profile should be saved is returned by the supplied profile's UserProfile.getLoginName()method.

Specified by:
save in interface UserDatabase
Specified by:
save in class AbstractUserDatabase
Parameters:
profile - the user profile to save
Throws:
WikiSecurityException - if the profile cannot be saved
See Also:
UserDatabase.save(com.ecyrd.jspwiki.auth.user.UserProfile)