/**
* eAdventure (formerly <e-Adventure> and <e-Game>) is a research project of the
* <e-UCM> research group.
*
* Copyright 2005-2010 <e-UCM> research group.
*
* You can access a list of all the contributors to eAdventure at:
* http://e-adventure.e-ucm.es/contributors
*
* <e-UCM> is a research group of the Department of Software Engineering
* and Artificial Intelligence at the Complutense University of Madrid
* (School of Computer Science).
*
* C Profesor Jose Garcia Santesmases sn,
* 28040 Madrid (Madrid), Spain.
*
* For more info please visit: <http://e-adventure.e-ucm.es> or
* <http://www.e-ucm.es>
*
* ****************************************************************************
*
* This file is part of eAdventure, version 2.0
*
* eAdventure is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* eAdventure 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with eAdventure. If not, see <http://www.gnu.org/licenses/>.
*/
/*
* To change this license header, choose License Headers in Project Properties.
* To change this template file, choose Tools | Templates
* and open the template in the editor.
*/
package es.eucm.ead.editor.control;
import es.eucm.ead.editor.view.components.OutputLogPanel;
import javax.script.ScriptContext;
/**
* Controls script retrieval, launching and execution. Scripts are also used
* as an extension mechanism for the editor.
*
* @author mfreire
*/
public interface ScriptController {
/**
* Resets engine state, and reloads available scripts.
*/
public void refreshScripts();
/**
* Runs a script.
* @param script to execute
* @param out optional output (null = ignore output)
* @param context to execute code in
* @param source optional source of code
* @return result of executing script
*/
public Object eval(String script, OutputLogPanel out,
ScriptContext context, String source);
/**
* Set the actual super-controller.
* @param controller the main controller, providing access to model, views,
* and more
*/
void setController(Controller controller);
/**
* Requests the script execution context
* @return the private scope
*/
ScriptContext getContext();
}