/******************************************************************************
 * Copyright (C) 2012 Heng Sin Low                                            *
 * Copyright (C) 2012 Trek Global                 							  *
 * This program is free software; you can redistribute it and/or modify it    *
 * under the terms version 2 of the GNU General Public License as published   *
 * by the Free Software Foundation. This program is distributed in the hope   *
 * that it will be useful, but WITHOUT ANY WARRANTY; without even the implied *
 * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.           *
 * See the GNU General Public License for more details.                       *
 * You should have received a copy of the GNU General Public License along    *
 * with this program; if not, write to the Free Software Foundation, Inc.,    *
 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.                     *
 *****************************************************************************/
package org.adempiere.util;

import java.io.File;
import java.util.List;

import org.compiere.model.MLookup;
import org.compiere.process.ProcessInfo;
import org.compiere.process.SvrProcess;

/**
 * Interface to provide server process access to UI.<br/>
 * iDempiere process usually extends {@link SvrProcess} and uses the protected processUI reference.<br/>
 * Process must perform null check when using the SvrProcess.processUI field since it will be null when a process is not launch
 * from the client end (for e.g from scheduler).  
 * @author hengsin
 *
 */
public interface IProcessUI {

	/**
	 *  Lock User Interface.
	 *  Called from the Worker before processing
	 *  @param pi process info
	 */
	public void lockUI (ProcessInfo pi);

	/**
	 *  Unlock User Interface.
	 *  Called from the Worker when processing is done
	 *  @param pi process info
	 */
	public void unlockUI (ProcessInfo pi);

	/**
	 *  Is the UI locked
	 *  @return true, if UI is locked
	 */
	public boolean isUILocked();
	
	/**
	 * Provide status feedback to user
	 * @param message
	 */
	public void statusUpdate(String message);
	
	/**
	 * Prompt for user input.
	 * 
	 * Example Usage in process:
	 * <pre>
	 * 	    final StringBuffer answer = new StringBuffer();
	 *		aProcessMonitor.ask(adMessage, new Callback<String>() {				
	 *			@Override
	 *			public void onCallback(String result) {
	 *				answer.append(result != null ? result : "-");
	 *			}
	 *		});
	 *      
	 *      //wait for answer		
	 *		while (answer.length() == 0) {
	 *			try {
	 *				Thread.sleep(200);
	 *			} catch (InterruptedException e) {}
	 *		}
	 *
	 *      //process answer from user
	 *      ...
	 * </pre>
	 * @param message
	 * @param callback
	 */
	public void ask(String message, Callback<Boolean> callback);
	
	/**
	 * ask for input from user
	 * @param message
	 * @param callback
	 */
	public void askForInput(String message, Callback<String> callback);
	
	/**
	 * Prompt for secret input (for e.g password) from user.
	 * 
	 * @param message
	 * @param callback
	 */
	public void askForSecretInput(String message, Callback<String> callback);

	/**
	 * Prompt user for input with a configurable DisplayType (String, Number, TableDir or Search)
	 * <p>
	 * Usage is the same from ask and askForInput methods with some additional parameters
	 *
	 * muriloht - devCoffee #3390
	 *
	 * @param message
	 * @param lookup
	 * @param displayType
	 * @param callback
	 */
	default public void askForInput(String message, MLookup lookup, int displayType, Callback<Object> callback){
		throw new RuntimeException();
	}

	/**
	 * add to list of file available for download after process end 
	 * @param file
	 */
	public void download(File file);

	/**
	 * show reports from a given file list
	 *
	 * matheus.marcelino - devCoffee #5561
	 *
	 * @param pdfList
	 */
	default public void showReports(List<File> pdfList)
	{
		throw new RuntimeException();
	}

	/**
	 * show an info window from inside a process with user defined parameters
	 *
	 * gustavo.francisco - devCoffee #7094
	 *
	 * @param WindowNo
	 * @param tableName
	 * @param keyColumn
	 * @param queryValue
	 * @param multipleSelection
	 * @param whereClause
	 * @param AD_InfoWindow_ID
	 * @param lookup
	 */
	default public void showInfoWindow(int WindowNo, String tableName, String keyColumn, String queryValue,
			boolean multipleSelection, String whereClause, Integer AD_InfoWindow_ID, boolean lookup)
	{
		throw new RuntimeException();
	}
}