package jas2.jds.module;
import javax.swing.BoundedRangeModel;
import java.util.Properties;

import hepjas.analysis.EventSource;
/**
 * The application will provide a LocalJobBuilder to all LocalDIMs.  Those
 * DIMs must use the LocalJobBuilder to create a new local job.
 *  @see LocalDIM
 */
public interface LocalJobBuilder
{
	/**
	 * Tells the Job Builder to create a job, which it does by calling the DIM's
	 * openDataSet method with the specified dataSourceName.
	 *  @see AbstractDIM#openDataSet(String)
	 */
	public abstract void createJob(String dataSourceName);

	/** Puts a message in the message window (e.g. "loading data...") */
	public abstract void setMessage(String message); 

	/**
	 * Enables the event source to take control of the progress meter, so the
	 * user can be given feedback on what is going on.
	 */
	public abstract void setProgressModel(BoundedRangeModel model);
	public abstract void clearProgressModel();
	
	/**
	 * Allows a LocalDIM to delay setting the EventSource in the case that
	 * opening the EventSouce may take a long time. In this case the LocalDIM
	 * may return null from its openDataSet method, and instead call this
	 * method later when the EventSource is ready.
	 * @see AbstractDIM#openDataSet(String)
	 * @param source The newly opened EventSource to be added to the job.
	 */
	
	public void setEventSource(EventSource source);
}