service.java

使用Flickr API来操作网络相册

/**
 * 
 */
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;
	
}