daointerface.java

航空定票系统：户端功能模块：用户登录模块

package com.tarena.abs.dao;
import java.util.*;
import com.tarena.abs.model.*;
/**
 * 该接口是一个DAO描述接口，该接口定义了对数据访问的操作。
 * @author tony tang
 *
 */
public interface DAOInterface {
	/**
	 * 代表不限定的出发地或目的地。该属性可用在getAllSchedular()和getAllFlight()
	 * 方法的调用中作为方法的参数,代表不限定出发地或目的地的查找。
	 */
	public static final String NO_LIMITED_ADDRESS="no_limited";
	
	/**
	 * 该方法根据一个用户名和密码到数据库或文件中查找是
	 * 否有符合条件的注册用户的记录。若有，返回一个User对象；
	 * 若无，返回null。
	 * @param name  用户姓名
	 * @param password  用户密码
	 * @return  得到的User对象null
	 */
	public User getUser(String name,String password);
	
	/**
	 * 该方法将给定的User对象添加到数据库或文件中。
	 * @param u 给定的User对象。
	 * @return 如果添加成功则返回true,否则返回false。
	 */
	public boolean addUser(User u);
	
	/**
	 * 该方法根据给定的航班号，查找数据库或文件中存储的航班计划对象。
	 * @param number  给定的航班号
	 * @return  返回找到的航班计划对象或返回null
	 */
	public FlightSchedular getSchedular(String number);
	
	/**
	 * 该方法根据给定的出发地和目的地来查询满足条件的航班计划。
	 * 该方法可以使用参数DAOInterface.NO_LIMITED_ADDRESS来代表不限定的出发地
	 * 或目的地。
	 * @param fromAddress  出发地
	 * @param toAddress  目的地
	 * @return  所有满足条件的航班计划的集合。
	 */
	public Collection getAllSchedular(String fromAddress,String toAddress);
	
	/**
	 * 该方法根据给定的出发地，目的地和出发日期来查询满足条件的航班。
	 * 该方法可以使用参数DAOInterface.NO_LIMITED_ADDRESS来代表不限定的出发地
	 * 或目的地。
	 * @param fromAddress  出发地
	 * @param toAddress  目的地
	 * @param date  出发日期
	 * @return  所有满足条件的航班的集合。
	 */
	public Collection getAllFlight(String fromAddress,String toAddress,MyDate date);
	
	/**
	 * 该方法将给定的航班计划添加到底层数据中。
	 * @param fs  给定的航班计划对象。
	 * @return  如果添加成功返回true,否则返回false。
	 */
	public boolean addSchedular(FlightSchedular fs);
	
	/**
	 * 该方法把给定航班号的航班记录从底层数据中删除掉。
	 * @param flightNumber
	 * @return  如果删除成功返回true,否则返回false。
	 */
	public boolean removeSchedular(String flightNumber);
	
	/**
	 * 该方法根据给定的航班号和日期执行订票的操作，
	 * 如果预定成功则把底层数据中航班的座位数减1，并向底层数据中添加一条订票记录，
	 * 然后返回该航班的票价；如果预定失败，则返回-1。
	 * @param number  航班号
	 * @param date  日期
	 * @return  预定成功则返回本航班的实际票价，否则返回-1。
	 */
	public int order(String number,MyDate date);
	
	/**
	 * 该方法用来更新航班数据，删除已过期的航班记录，生成新的航班记录。
	 *
	 */
	public void dataUpdate();	
	
	/**
	 * 该方法返回所有的飞机机型的集合。
	 * @return 所有的飞机机型的集合
	 */
	public Collection getAllPlane();
	
	/**
	 * 该方法向底层数据中添加一条机型信息。
	 * @param pm 飞机机型对象
	 * @return 如果添加成功返回true,否则返回false。
	 */
	public boolean addPlaneModel(PlaneModel pm);
	
	/**
	 * 该方法删除底层数据中给定的飞机型号信息。
	 * @param model  给定的飞机型号
	 * @return  如果删除成功返回true,否则返回false。
	 */
	public boolean removePlaneModel(String model);
}