/***********************************************************************
* Copyright (c) 2000-2004 The Apache Software Foundation. *
* All rights reserved. *
* ------------------------------------------------------------------- *
* Licensed under the Apache License, Version 2.0 (the "License"); you *
* may not use this file except in compliance with the License. You *
* may obtain a copy of the License at: *
* *
* http://www.apache.org/licenses/LICENSE-2.0 *
* *
* Unless required by applicable law or agreed to in writing, software *
* distributed under the License is distributed on an "AS IS" BASIS, *
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or *
* implied. See the License for the specific language governing *
* permissions and limitations under the License. *
***********************************************************************/
package org.apache.james.userrepository;
import org.apache.avalon.cornerstone.services.store.ObjectRepository;
import org.apache.avalon.cornerstone.services.store.Store;
import org.apache.avalon.framework.activity.Initializable;
import org.apache.avalon.framework.component.Component;
import org.apache.avalon.framework.component.ComponentException;
import org.apache.avalon.framework.component.ComponentManager;
import org.apache.avalon.framework.component.Composable;
import org.apache.avalon.framework.configuration.Configurable;
import org.apache.avalon.framework.configuration.Configuration;
import org.apache.avalon.framework.configuration.ConfigurationException;
import org.apache.avalon.framework.configuration.DefaultConfiguration;
import org.apache.avalon.framework.logger.AbstractLogEnabled;
import org.apache.james.services.User;
import org.apache.james.services.UsersRepository;
import java.io.File;
import java.util.Iterator;
/**
* Implementation of a Repository to store users on the File System.
*
* Requires a configuration element in the .conf.xml file of the form:
* <repository destinationURL="file://path-to-root-dir-for-repository"
* type="USERS"
* model="SYNCHRONOUS"/>
* Requires a logger called UsersRepository.
*
*
* @version CVS $Revision: 1.10.4.3 $
*
*/
public class UsersFileRepository
extends AbstractLogEnabled
implements UsersRepository, Component, Configurable, Composable, Initializable {
/**
* Whether 'deep debugging' is turned on.
*/
protected static boolean DEEP_DEBUG = false;
/** @deprecated what was this for? */
private static final String TYPE = "USERS";
private Store store;
private ObjectRepository or;
/**
* The destination URL used to define the repository.
*/
private String destination;
/**
* @see org.apache.avalon.framework.component.Composable#compose(ComponentManager)
*/
public void compose( final ComponentManager componentManager )
throws ComponentException {
try {
store = (Store)componentManager.
lookup( "org.apache.avalon.cornerstone.services.store.Store" );
} catch (Exception e) {
final String message = "Failed to retrieve Store component:" + e.getMessage();
getLogger().error( message, e );
throw new ComponentException( message, e );
}
}
/**
* @see org.apache.avalon.framework.configuration.Configurable#configure(Configuration)
*/
public void configure( final Configuration configuration )
throws ConfigurationException {
destination = configuration.getChild( "destination" ).getAttribute( "URL" );
if (!destination.endsWith(File.separator)) {
destination += File.separator;
}
}
/**
* @see org.apache.avalon.framework.activity.Initializable#initialize()
*/
public void initialize()
throws Exception {
try {
//prepare Configurations for object and stream repositories
final DefaultConfiguration objectConfiguration
= new DefaultConfiguration( "repository",
"generated:UsersFileRepository.compose()" );
objectConfiguration.setAttribute( "destinationURL", destination );
objectConfiguration.setAttribute( "type", "OBJECT" );
objectConfiguration.setAttribute( "model", "SYNCHRONOUS" );
or = (ObjectRepository)store.select( objectConfiguration );
if (getLogger().isDebugEnabled()) {
StringBuffer logBuffer =
new StringBuffer(192)
.append(this.getClass().getName())
.append(" created in ")
.append(destination);
getLogger().debug(logBuffer.toString());
}
} catch (Exception e) {
if (getLogger().isErrorEnabled()) {
getLogger().error("Failed to initialize repository:" + e.getMessage(), e );
}
throw e;
}
}
/**
* List users in repository.
*
* @return Iterator over a collection of Strings, each being one user in the repository.
*/
public Iterator list() {
return or.list();
}
/**
* Update the repository with the specified user object. A user object
* with this username must already exist.
*
* @param user the user to be added.
*
* @return true if successful.
*/
public synchronized boolean addUser(User user) {
String username = user.getUserName();
if (contains(username)) {
return false;
}
try {
or.put(username, user);
} catch (Exception e) {
throw new RuntimeException("Exception caught while storing user: " + e );
}
return true;
}
public void addUser(String name, Object attributes) {
if (attributes instanceof String) {
User newbie = new DefaultUser(name, "SHA");
newbie.setPassword( (String) attributes);
addUser(newbie);
}
else {
throw new RuntimeException("Improper use of deprecated method"
+ " - use addUser(User user)");
}
}
public synchronized User getUserByName(String name) {
if (contains(name)) {
try {
return (User)or.get(name);
} catch (Exception e) {
throw new RuntimeException("Exception while retrieving user: "
+ e.getMessage());
}
} else {
return null;
}
}
public User getUserByNameCaseInsensitive(String name) {
String realName = getRealName(name);
if (realName == null ) {
return null;
}
return getUserByName(realName);
}
public String getRealName(String name) {
Iterator it = list();
while (it.hasNext()) {
String temp = (String) it.next();
if (name.equalsIgnoreCase(temp)) {
return temp;
}
}
return null;
}
public Object getAttributes(String name) {
throw new UnsupportedOperationException("Improper use of deprecated method - read javadocs");
}
public boolean updateUser(User user) {
String username = user.getUserName();
if (!contains(username)) {
return false;
}
try {
or.put(username, user);
} catch (Exception e) {
throw new RuntimeException("Exception caught while storing user: " + e );
}
return true;
}
public synchronized void removeUser(String name) {
or.remove(name);
}
public boolean contains(String name) {
return or.containsKey(name);
}
public boolean containsCaseInsensitive(String name) {
Iterator it = list();
while (it.hasNext()) {
if (name.equalsIgnoreCase((String)it.next())) {
return true;
}
}
return false;
}
public boolean test(String name, Object attributes) {
try {
return attributes.equals(or.get(name));
} catch (Exception e) {
return false;
}
}
public boolean test(String name, String password) {
User user;
try {
if (contains(name)) {
user = (User) or.get(name);
} else {
return false;
}
} catch (Exception e) {
throw new RuntimeException("Exception retrieving User" + e);
}
return user.verifyPassword(password);
}
public int countUsers() {
int count = 0;
for (Iterator it = list(); it.hasNext(); it.next()) {
count++;
}
return count;
}
}