/**
 * 
 */
package com.ftrd;

import java.util.List;

/**
 * @author Daniel.Tu
 * @since 2008-10-06
 *
 */

public interface Service {

	/**
	 * 建立網絡相冊的連接
	 * 
	 * @param username
	 * @param password
	 * @param apiKey
	 */
	public void connect(String username, String password, String apiKey) throws Exception;
	
	/**
	 * 根據給定網絡相冊的id獲得該相冊對象
	 * 
	 * @param album_id
	 * @return
	 */
	public Object getAlbum(String album_id) throws Exception;
	
	
	/**
	 * 根據給定網絡相冊的id獲取該相冊的標簽Tags
	 * 
	 * @param album_id
	 * @return
	 */
	public List getAlbumTags(String album_id) throws Exception;
	
	/**
	 * 根據網絡相冊的Id下載該相冊對象到本地并更新數據庫
	 * 
	 * @param album_id
	 * @return
	 */
	public int downloadAlbum(String album_id) throws Exception; 
	
	/**
	 * 創建一個指定命名的新相冊
	 * 
	 * @param album_id
	 */
	public void addAlbum(String album_id) throws Exception; 
	
	
	/**
	 * 修改指定相冊的信息
	 * 
	 * @param album_id
	 */
	public void modifyAlbum(String album_id) throws Exception; 
	
	
	/**
	 * 刪除指定Id的網絡相冊
	 * 
	 * @param album_id
	 */
	public void deleteAlbum(String album_id) throws Exception; 
	
	/**
	 * 下載給定id相冊內的所有內容
	 * 
	 * @param album_id
	 */
	public void downloadContentsInAlbum(String album_id) throws Exception; 
	
	/**
	 * 獲得給定相冊下的所有圖片
	 * 
	 * @param album_id
	 * @return
	 */
	public List getPhotots(String album_id) throws Exception;
	
	/**
	 *  獲取給定相冊中的某張圖片
	 * 
	 * @param album_id
	 * @param photo_id
	 * @return
	 */
	public Object getPhoto(String album_id, String photo_id) throws Exception;
		
	/**
	 * 下載給定相冊中的某張圖片保存到本地并更新數據庫
	 * 
	 * @param album_id
	 * @param photo_id
	 */
	public void download(String album_id, String photo_id) throws Exception; 
	
	/**
	 * 獲得給定圖片的所有標簽Tags
	 * 
	 * @param photo_id
	 * @return
	 */
	public List getPhotoTags(String photo_id) throws Exception; 
	
	/**
	 * 獲得給定圖片的所有注釋信息
	 * 
	 * @param photo_id
	 * @return
	 */
	public List getPhotoComments(String photo_id) throws Exception; 
	
	/**
	 * 向給定的相冊中添加新圖片
	 * 
	 * @param album_id
	 * @param photo_id
	 */
	public void uploadPhoto(String album_id, String filename) throws Exception; 
	
	/**
	 * 從給定的相冊中刪除指定id的圖片
	 * 
	 * @param album_id
	 * @param photo_id
	 */
	public void deletePhoto(String album_id, String photo_id) throws Exception; 
	
	/**
	 *  向給定的圖片中添加標簽tag
	 * 
	 * @param album_id
	 * @param photo_id
	 */
	public void addTags(String photo_id, String tag) throws Exception;
	
	/**
	 * 從給定的圖片中刪除標簽tag
	 * 
	 * @param photo_id
	 * @param tag
	 */
	public void removeTags(String photo_id, String tag) throws Exception;
	
	/**
	 *  把圖片存儲到本地
	 * 
	 * @param photo
	 * @param author
	 */
	public void saveToFile(Object photo,String author) throws Exception;
	
}