roaddefectmanager.java

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

package mcaps.apps.prrm.roaddefect.service;

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

import mcap.core.map.service.WfsTransactionService;
import mcap.core.map.util.WfsTransactionFactory;
import mcaps.apps.prrm.roaddefect.dao.RoadDefectDAO;
import mcaps.apps.prrm.roaddefect.model.RoadDefect;


/**
 * Business Service Interface for implementation that provides 
 * road defect management service.
 * 
 * @author jov
 * @date Dec 7, 2005
 * @version 1.0.1.0
 */
public interface RoadDefectManager {

	/**
	 * Set the RoadDefectDAO
	 * @param dao the RoadDefectDAO
	 */
	void setRoadDefectDAO (RoadDefectDAO dao);

	/**
	 * Sets the wfsTransaction.
	 * @param wfsTransaction The wfsTransaction to set.
	 */
	void setWfsTransactionService (WfsTransactionService wfsTransactionService);

	/**
	 * Sets the wfsTransactionFactory.
	 * @param wfsTransactionFactory The wfsTransactionFactory to set.
	 */
	void setWfsTransactionFactory (WfsTransactionFactory wfsTransactionFactory); 

	//---------------------------------------------------------------
	// Actual business method
	//---------------------------------------------------------------
	/**
	 * Retrieve road defect by road defect id
	 * @param roadDefectID road defect id
	 * @return Road Defect object
	 */
	RoadDefect getRoadDefect(Integer roadDefectID);

	/**
	 * Search for road defects that matches the road defect
	 * object.
	 * @param defect
	 * @return
	 */
	List getRoadDefects(RoadDefect roadDefect);

	/**
	 * Retrieve a list of road roadDefect.
	 * @return
	 */
	List getAllRoadDefects();
	
	/**
	 * Saves the road defect
	 * @param roadDefect the road defect object to save
	 * @return the id of the road defect saved
	 */
	void saveRoadDefect(RoadDefect roadDefect)throws Exception;
	
	/**
	 * Deletes a road defect 
	 * @param roadDefect the road defect object to delete
	 */
	void removeRoadDefect(RoadDefect roadDefect)throws Exception;

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

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

	/**
	 * 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
	 */
	List getClosedRoadDefects(Date startLastModifiedTime, Date endLastModifiedTime);

	/**
	 * Sets the road defect status to opened
	 * @param roadDefectID the road defect id
	 */
	void openRoadDefect(Integer roadDefectID);

	/**
	 * Sets the road defect status to closed
	 * @param roadDefectID road defect id
	 */
	void closeRoadDefect(Integer roadDefectID) throws Exception;
	
	/**
	 * Sets the road defect status to completed
	 * @param roadDefectID road defect id
	 */
	void completeRoadDefect(Integer roadDefectID);

	/**
	 * Assigned the road defect for inspection
	 * @param roadDefectID road defect id
	 */
	void assignRoadDefectForInspection(Integer roadDefectID);

	/**
	 * set the road defect for done
	 * @param roadDefectID road defect id
	 */
	void setRoadDefectForDone(Integer roadDefectID);
	/**
	 * Assigned the road defect for repair
	 * @param roadDefectID road defect id
	 */
	void assignRoadDefectForRepair(Integer roadDefectID);
	
	/**
	 * set the road defect Inspectioned
	 * @param roadDefectID road defect id
	 */
	void setRoadDefectForInspectioned(Integer roadDefectID);
	
	
}