org.apache.james.user.jcr

Class JCRUsersRepository

java.lang.Object

org.apache.james.user.lib.AbstractUsersRepository

org.apache.james.user.jcr.JCRUsersRepository

All Implemented Interfaces:

Configurable, LogEnabled, UsersRepository

public class JCRUsersRepository
extends AbstractUsersRepository

UsersRepository implementation which stores users to a JCR Repository

Constructor Summary

Constructors

Constructor and Description
JCRUsersRepository()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	contains(String name) Returns whether or not this user is in the repository
int	countUsers() Returns a count of the users in the repository.
protected void	doAddUser(String username, String password) Add the user with the given username and password
void	doConfigure(org.apache.commons.configuration.HierarchicalConfiguration config)
String	getRealName(String name) Returns the user name of the user matching name on an equalsIgnoreCase basis.
User	getUserByName(String username) Get the user object with the specified user name.
Iterator<String>	list() List users in repository.
void	removeUser(String username) Removes a user from the repository
void	setRepository(javax.jcr.Repository repository)
boolean	test(String username, String password) Test if user with name 'name' has password 'password'.
protected String	toSafeName(String key)
void	updateUser(User user) Update the repository with the specified user object.

Methods inherited from class org.apache.james.user.lib.AbstractUsersRepository

addUser, configure, getLogger, isValidUsername, setDomainList, setEnableVirtualHosting, setLog, supportVirtualHosting

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JCRUsersRepository

public JCRUsersRepository()

Method Detail

setRepository

public void setRepository(javax.jcr.Repository repository)

doConfigure

public void doConfigure(org.apache.commons.configuration.HierarchicalConfiguration config)
                 throws org.apache.commons.configuration.ConfigurationException

Overrides:

doConfigure in class AbstractUsersRepository

Throws:

org.apache.commons.configuration.ConfigurationException

toSafeName

protected String toSafeName(String key)

getUserByName

public User getUserByName(String username)

Get the user object with the specified user name. Return null if no such user.

Parameters:

username - the name of the user to retrieve

Returns:

the user being retrieved, null if the user doesn't exist

getRealName

public String getRealName(String name)

Returns the user name of the user matching name on an equalsIgnoreCase basis. Returns null if no match.

Parameters:

name - the name to case-correct

Returns:

the case-correct name of the user, null if the user doesn't exist

updateUser

public void updateUser(User user)
                throws UsersRepositoryException

Update the repository with the specified user object. A user object with this username must already exist.

Parameters:

user - the user

Throws:

UsersRepositoryException - If an error occurred

removeUser

public void removeUser(String username)
                throws UsersRepositoryException

Removes a user from the repository

Parameters:

username - the user to remove from the repository

Throws:

UsersRepositoryException

contains

public boolean contains(String name)
                 throws UsersRepositoryException

Returns whether or not this user is in the repository

Parameters:

name - the name to check in the repository

Returns:

whether the user is in the repository

Throws:

UsersRepositoryException

test

public boolean test(String username,
           String password)
             throws UsersRepositoryException

Test if user with name 'name' has password 'password'.

Parameters:

username - the name of the user to be tested

password - the password to be tested

Returns:

true if the test is successful, false if the user doesn't exist or if the password is incorrect

Throws:

UsersRepositoryException

Since:

James 1.2.2

countUsers

public int countUsers()
               throws UsersRepositoryException

Returns a count of the users in the repository.

Returns:

the number of users in the repository

Throws:

UsersRepositoryException

list

public Iterator<String> list()
                      throws UsersRepositoryException

List users in repository.

Returns:

Iterator over a collection of Strings, each being one user in the repository.

Throws:

UsersRepositoryException

doAddUser

protected void doAddUser(String username,
             String password)
                  throws UsersRepositoryException

Description copied from class: AbstractUsersRepository

Add the user with the given username and password

Specified by:

doAddUser in class AbstractUsersRepository

Throws:

UsersRepositoryException - If an error occurred