/**
 * IJobManager.java
 * Created on May 15, 2008
 * (C) Copyright TANDBERG Television Ltd.
 */
package com.tandbergtv.watchpoint.pmm.job;

import java.util.List;

import com.tandbergtv.watchpoint.pmm.entities.Job;
import com.tandbergtv.watchpoint.pmm.entities.RuleType;

/**
 * @author spuranik
 * 
 * This interface deals with all job related tasks.
 */
public interface IJobManager {

	/**
	 * @param job
	 *            the job entity for which a job needs to be created in the system
	 */
	public void createJob(Job job);

	/**
	 * @param jobId
	 *            The jobId for which the job entity is requested
	 * @return the job entity corresponding to the job id provided.
	 */
	public Job getJob(long jobId);

	/**
	 * @param job
	 *            job entity for which needs to be updated in the system
	 */
	public void updateJob(Job job);

	/**
	 * @param jobId
	 *            job id for the job which needs to be deleted
	 */
	public void deleteJob(long jobId);

	/**
	 * @param contextId
	 *            contextId for which jobs need to be looked up
	 * @return the complete list of jobs for a given context Id
	 */
	public List<Job> getAllJobs(long contextId);

	/**
	 * @return retrieves all ruletypes and returns a list
	 */
	public List<RuleType> getAllRuleTypes();

	/**
	 * @param name
	 *            rule type name to search for
	 * @return RuleType object corresponding to this name
	 */
	public RuleType getRuleType(String name);

	/**
	 * @param isAssociatedWithTitles
	 *            true/false
	 * @return list of rule types which are/are not associated with titles
	 */
	public List<RuleType> getRuleTypes(boolean isAssociatedWithTitles);
	
	/**
	 * Returns all jobs that invoke this ruleset.
	 * 
	 * @return
	 */
	List<Job> getAllJobs(String ruleSetId);
}