Class TorqueAbstractUserManager
java.lang.Object
org.apache.avalon.framework.logger.AbstractLogEnabled
org.apache.fulcrum.security.spi.AbstractManager
org.apache.fulcrum.security.spi.AbstractEntityManager
org.apache.fulcrum.security.spi.AbstractUserManager
org.apache.fulcrum.security.torque.TorqueAbstractUserManager
- All Implemented Interfaces:
Serializable,org.apache.avalon.framework.activity.Disposable,org.apache.avalon.framework.configuration.Configurable,org.apache.avalon.framework.logger.LogEnabled,org.apache.avalon.framework.service.Serviceable,org.apache.avalon.framework.thread.ThreadSafe,UserManager
- Direct Known Subclasses:
PeerUserManager,TorqueBasicUserManagerImpl,TorqueDynamicUserManagerImpl
public abstract class TorqueAbstractUserManager extends AbstractUserManager
This implementation persists to a database via Torque.
- Version:
- $Id:$
- Author:
- Thomas Vandahl
- See Also:
- Serialized Form
-
Field Summary
-
Constructor Summary
Constructors Constructor Description TorqueAbstractUserManager() -
Method Summary
Modifier and Type Method Description booleancheckExists(String userName)Check whether a specified user's account exists.voidconfigure(org.apache.avalon.framework.configuration.Configuration conf)Avalon Service lifecycle methodprotected abstract <T extends User>
List<T>doSelectAllUsers(Connection con)Get all specialized Usersprotected abstract <T extends User>
TdoSelectById(Integer id, Connection con)Get a specialized User by idprotected abstract <T extends User>
TdoSelectByName(String name, Connection con)Get a specialized User by name<T extends User>
UserSet<T>getAllUsers()Retrieves all users defined in the system.<T extends User>
TgetUser(String userName)Retrieve a user from persistent storage using username as the key.<T extends User>
TgetUserById(Object id)Retrieve a User object with specified id.protected <T extends User>
TpersistNewUser(T user)Creates new user account with specified attributes.voidremoveUser(User user)Removes an user account from the system.voidsaveUser(User user)Stores User attributes.Methods inherited from class org.apache.fulcrum.security.spi.AbstractUserManager
addUser, authenticate, changePassword, checkExists, forcePassword, getACL, getACLFactory, getUser, getUserInstance, getUserInstanceMethods inherited from class org.apache.fulcrum.security.spi.AbstractEntityManager
getClassName, setClassNameMethods inherited from class org.apache.fulcrum.security.spi.AbstractManager
dispose, getGroupManager, getPermissionManager, getRoleManager, getServiceManager, getUserManager, release, resolve, service
-
Constructor Details
-
TorqueAbstractUserManager
public TorqueAbstractUserManager()
-
-
Method Details
-
configure
public void configure(org.apache.avalon.framework.configuration.Configuration conf) throws org.apache.avalon.framework.configuration.ConfigurationExceptionAvalon Service lifecycle method- Specified by:
configurein interfaceorg.apache.avalon.framework.configuration.Configurable- Overrides:
configurein classAbstractEntityManager- Throws:
org.apache.avalon.framework.configuration.ConfigurationException
-
doSelectAllUsers
protected abstract <T extends User> List<T> doSelectAllUsers(Connection con) throws org.apache.torque.TorqueExceptionGet all specialized Users- Parameters:
con- a database connection- Returns:
- a List of User instances
- Throws:
org.apache.torque.TorqueException- if any database error occurs
-
doSelectByName
protected abstract <T extends User> T doSelectByName(String name, Connection con) throws org.apache.torque.NoRowsException, org.apache.torque.TooManyRowsException, org.apache.torque.TorqueExceptionGet a specialized User by name- Parameters:
name- the name of the groupcon- a database connection- Returns:
- a User instance
- Throws:
org.apache.torque.NoRowsException- if no such group existsorg.apache.torque.TooManyRowsException- if multiple groups with the given name existorg.apache.torque.TorqueException- if any database error occurs if any other database error occurs
-
doSelectById
protected abstract <T extends User> T doSelectById(Integer id, Connection con) throws org.apache.torque.NoRowsException, org.apache.torque.TooManyRowsException, org.apache.torque.TorqueExceptionGet a specialized User by id- Parameters:
id- the id of the groupcon- a database connection- Returns:
- a User instance
- Throws:
org.apache.torque.NoRowsException- if no such group existsorg.apache.torque.TooManyRowsException- if multiple groups with the given id existorg.apache.torque.TorqueException- if any database error occurs if any other database error occurs
-
removeUser
Removes an user account from the system.- Parameters:
user- the object describing the account to be removed.- Throws:
DataBackendException- if there was an error accessing the data backend.UnknownEntityException- if the user account is not present.
-
persistNewUser
Creates new user account with specified attributes.- Specified by:
persistNewUserin classAbstractUserManager- Parameters:
user- the object describing account to be created.- Throws:
DataBackendException- if there was an error accessing the data backend.
-
saveUser
Stores User attributes. The User is required to exist in the system.- Parameters:
user- The User to be stored.- Throws:
DataBackendException- if there was an error accessing the data backend.UnknownEntityException- if the role does not exist.
-
checkExists
Check whether a specified user's account exists. The login name is used for looking up the account.- Parameters:
userName- The name of the user to be checked.- Returns:
- true if the specified account exists
- Throws:
DataBackendException- if there was an error accessing the data backend.
-
getUser
public <T extends User> T getUser(String userName) throws UnknownEntityException, DataBackendExceptionRetrieve a user from persistent storage using username as the key. Additionally retrieves all attached objects fromTorqueAbstractSecurityEntity.retrieveAttachedObjects(Connection, Boolean)- Specified by:
getUserin interfaceUserManager- Overrides:
getUserin classAbstractUserManager- Parameters:
userName- the name of the user.- Returns:
- an User object.
- Throws:
UnknownEntityException- if the user's account does not exist in the database.DataBackendException- if there is a problem accessing the storage.
-
getAllUsers
Retrieves all users defined in the system.- Returns:
- the names of all users defined in the system.
- Throws:
DataBackendException- if there was an error accessing the data backend.
-
getUserById
public <T extends User> T getUserById(Object id) throws DataBackendException, UnknownEntityExceptionRetrieve a User object with specified id.- Specified by:
getUserByIdin interfaceUserManager- Overrides:
getUserByIdin classAbstractUserManager- Parameters:
id- the id of the User.- Returns:
- an object representing the User with specified id.
- Throws:
DataBackendException- if there was an error accessing the data backend.UnknownEntityException- if the user does not exist.
-