package com.struts2.framework.service;

import java.io.Serializable;
import java.util.Collection;

import com.struts2.framework.dao.BaseDao;

public interface Manager {
	/**
	 * Expose the setDao method for testing purposes
	 * 
	 * @param dao
	 */
	public void setDao(BaseDao baseDao);

	/**
	 * Generic method used to get a all objects of a particular type.
	 * 
	 * @param clazz
	 *            the type of objects
	 * @return List of populated objects
	 */
	public Collection getObjects(Class clazz);

	/**
	 * Generic method to get an object based on class and identifier.
	 * 
	 * @param clazz
	 *            model class to lookup
	 * @param id
	 *            the identifier (primary key) of the class
	 * @return a populated object
	 * @see org.springframework.orm.ObjectRetrievalFailureException
	 */
	public Object getObject(Class clazz, Serializable id);

	/**
	 * Generic method to save an object.
	 * 
	 * @param o
	 *            the object to save
	 */
	public Object saveObject(Object o);

	/**
	 * Generic method to save an object.
	 * 
	 * @param o
	 *            the object to update
	 */
	public void updateObject(Object o);

	/**
	 * Generic method to delete an object based on class and id
	 * 
	 * @param clazz
	 *            model class to lookup
	 * @param id
	 *            the identifier of the class
	 */
	public void removeObject(Class clazz, Serializable id);

	/**
	 * Generic method to query object based on class and querry parameters
	 * 
	 * @param clazz
	 *            model class to lookup
	 * @param parameters
	 *            query parameters under where conditions
	 */
	public Collection getObjects(Class clazz, Object parameters);

}