usermanager.java

Struts数据库项目中的一个实例

package com.relationinfo.service;

import java.util.List;

import com.relationinfo.dao.UserDAO;
import com.relationinfo.model.User;


/**
 * Business Service Interface to handle communication between web and
 * persistence layer.
 *
 * <p><a href="UserManager.java.html"><i>www.relationinfo.com</i></a></p>
 *
 * @author caoguangxin www.relationinfo.com
 *  Modified by  caoguangxin www.relationinfo.com 
 */
public interface UserManager {
    //~ Methods ================================================================

    public void setUserDAO(UserDAO dao);
    
    /**
     * Retrieves a user by username.  An exception is thrown if now user 
     * is found.
     *
     * @param username
     * @return User
     */
    public User getUser(String username);

    /**
     * Retrieves a list of users, filtering with parameters on a user object
     * @param user parameters to filter on
     * @return List
     */
    public List getUsers(User user);

    /**
     * Saves a user's information
     *
     * @param user the user's information
     * @throws UserExistsException
     */
    public void saveUser(User user) throws UserExistsException;

    /**
     * Removes a user from the database by their username
     *
     * @param username the user's username
     */
    public void removeUser(String username);
    
    /**
     * Validates a user based on a cookie value.  If successful, it returns
     * a new cookie String.  If not, then it returns null.
     * 
     * @param value (in format username|guid)
     * @return indicator that this is a valid login (null == invalid)
     */
    public String checkLoginCookie(String value);
 
    /**
     * Creates a cookie string using a username - designed for use when
     * a user logs in and wants to be remembered.
     * 
     * @param username
     * @return String to put in a cookie for remembering user
     */
    public String createLoginCookie(String username);
    
    /**
     * Deletes all cookies for user.
     * @param username
     */
    public void removeLoginCookies(String username);
}