/*
 *  UserBridge.java
 *  
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU Library General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 *  
 *  Author: Winter Lau
 *  http://dlog4j.sourceforge.net
 */
package com.liusoft.dlog4j;

import com.liusoft.dlog4j.beans.UserBean;

/**
 * 用戶資料管理接口
 * 用戶注冊/登錄/資料修改等都是通過該接口進行
 * 該接口用戶擴展跟其他系統的用戶數據同步功能
 * @author liudong
 */
public interface UserBridge {
	
	/**
	 * 添加一個用戶
	 * @param user
	 * @throws Exception
	 */
	public void create(final UserBean user);
	
	/**
	 * 更新用戶資料
	 * @param user
	 * @throws Exception
	 */
	public void update(final UserBean user);
	
	/**
	 * 通過用戶名來獲取用戶資料
	 * @param username
	 * @return
	 * @throws Exception
	 */
	public UserBean getUserByName(final String username);
	
	/**
	 * 通過用戶昵稱來獲取用戶資料
	 * @param nickname
	 * @return
	 * @throws Exception
	 */
	public UserBean getUserByNickname(final String nickname);
	
	/**
	 * 用戶登錄后觸發該方法
	 * @param user
	 * @throws Exception
	 */
	public void userLogin(final UserBean user);
	
	/**
	 * 用戶退出登錄后觸發該方法
	 * @param user
	 * @param manual_logout 是手工注銷還是會話實效時由系統調用
	 * @throws Exception
	 */
	public void userLogout(final SessionUserObject user, boolean manual_logout);

}