roaddefectdao.java

来自「Java的框架」· Java 代码 · 共 108 行

package mcaps.apps.prrm.roaddefect.dao;

import java.util.Date;
import java.util.List;

import mcaps.apps.prrm.roaddefect.model.RoadDefect;



/**
 * Road Defect Data Access Object interface.
 * 
 * @author jov
 * @date Sept 25, 2005
 * @version 1.0.1.0
 */
public interface RoadDefectDAO {

//	/**
//	 * Returns the road map data source.
//	 * @return road map data source
//	 */
//	DataSource getRoadMapDataSource();
//	
//	/**
//	 * Sets the road map data source.
//	 * @param roadMapDataSource
//	 */
//	void setRoadMapDataSource(DataSource roadMapDataSource);
	
	/**
	 * Get road defect that matches the roadDefectID parameter.
	 * @param roadDefectID the id of the road defect
	 * @return road defect object that has the same id as the roadDefectID parameter.
	 */
	RoadDefect getRoadDefect(Integer roadDefectID); 

	/**
	 * Gets all road defects
	 * @return list of all road defects
	 */
	List getAllRoadDefects();

	/**
	 * Gets road defects that macthes the search criteria as specified by the 
	 * road defect parameter.
	 * @param roadDefect road defect
	 * @return list of road defects that matches the search criteria as specified 
	 * by the road defect parameter.
	 */
	List getRoadDefects(RoadDefect roadDefect);

	/**
	 * Get road defect by contact id.
	 * @param contactID contact id.
	 * @return return the list of road defects that matches the contact id.
	 */
	List getRoadDefectsByContactID(Integer contactID); 

	/**
	 * Saves the road defect.
	 * @param roadDefect road defect to save
	 */
	void saveRoadDefect(RoadDefect roadDefect); 

	/**
	 * Deletes a road defect
	 * @param roadDefect road defect to save
	 */
	void removeRoadDefect(RoadDefect roadDefect); 

	/**
	 * Purges road defects which are last modified from the specified start date
	 * till the specified end date
	 * @param startDate the start date
	 * @param endDate the end date
	 * @return the number of road defects purged
	 */
	int purgeRoadDefect(Date startDate, Date endDate);

	/**
	 * Duplicates road defects are last modified from the specified start date
	 * till the specified end date
	 * @param startDate the start date
	 * @param endDate the end date
	 * @return the number of road defects duplicated
	 * @throws Exception
	 */
	int copyRoadDefectToFile(Date startDate, Date endDate);

	/**
	 * Gets road defects are last modified from the specified start date
	 * till the specified end date
	 * @param startDate the start date
	 * @param endDate the end date
	 * @return the road defects found
	 * @throws Exception
	 */
	List getClosedRoadDefects(Date startLastModifiedTime, Date endLastModifiedTime);

	/**
	 * Changes the status of the road defect.
	 * @param roadDefectID
	 * @param status
	 */
	void changeRoadDefectStatus(Integer roadDefectID, String status);
}