Application: gvSIG desktop » gvSIG scripting

package org.gvsig.scripting;

import java.io.File;

import java.util.List;

import java.util.Map;

import org.gvsig.tools.service.spi.ProviderFactory;

/**

 * There are two top level management roles within ScriptingFramework: logical

 * and User's Interface (UI) management.

 *

 * This class is responsible of the logical role. It provides all the services

 * to manage the information used in ScriptingFramework.

 *

 * @see ScriptingUIManager

 * @see ScriptingHelpManager

 */

public interface ScriptingManager {

    public static final String INSTALLER_PROVIDER_NAME = "Script";

    public static final String INSTALLER_PROVIDER_DESCRIPTION = "Provider to install scripts";

    public static final String HELP_INSTALLER_PROVIDER_NAME = "ScriptHelp";

    public static final String HELP_INSTALLER_PROVIDER_DESCRIPTION = "Provider to install scripting help";

    public static final String UNIT_SCRIPT = "Script";

    public static final String UNIT_DIALOG = "Dialog";

    public static final String UNIT_FOLDER = "Folder";

    public void setHomeFolder(File home);

    public File getHomeFolder();

    /**

     * Returns the System's Folder

     *

     * @return a {@link ScriptingFolder} with the System's Folder.

     */

    public ScriptingFolder getSystemFolder();

    /**

     * Returns the User's Folder

     *

     * @return a {@link ScriptingFolder} with the User's Folder.

     */

    public ScriptingFolder getUserFolder();

    public List<ScriptingFolder> getAlternativeUserFolders();

    public void addAlternativeUserFolder(File f, String name, String description);

    public ScriptingUnit createUnit(String unitType, ScriptingFolder folder, String id);

    public ScriptingUnit createUnit(String unitType, ScriptingFolder folder, String id, String language);

    public List<String> getUnitTypes();

    /**

     * Returns the {@link ScriptingBaseScript} associated with the file

     * specified

     *

     * @param file File where is contained the {@link ScriptingBaseScript}'s

     * information

     *

     * @return {@link ScriptingBaseScript}

     */

    public ScriptingBaseScript getScript(File file);

    public ScriptingBaseScript getScript(String name);

    /**

     * Returns the {@link ScriptingFolder} associated with the file specified

     *

     * @param file File where is contained the {@link ScriptingFolder}'s

     * information

     *

     * @return {@link ScriptingFolder}

     */

    public ScriptingFolder getFolder(File file);

    /**

     * Returns the path of the User's Folder

     *

     * @return a String with the path of the User's Folder

     */

//    public String getRootUserFolder();

    /**

     * Registers a File System with {@link ScriptingUnit}s in the SystemFolder

     *

     * @param name String with the identificator name of the File System

     * registered

     * @param folder File with the root of the File System to register

     */

    public void registerSystemFolder(String name, File folder);

    public List<String> getSupportedLanguages();

    public String getExtensionOfLanguage(String language);

    public String getEngineNameByLanguage(String langName);

    /**

     * Checks if an id is unique in a determinate folder

     *

     * @param folder {

     * @ScriptingFolder} with the directory to verify the id

     * @param id String with the id to validate

     *

     * @return true if there isn't another {@link ScriptingUnit} with the same

     * id, and false in the other case

     */

    public boolean validateUnitId(ScriptingFolder folder, String id);

    /**

     * Sets a key/value pair in the state of the ScriptingManager that may

     * either create a Java Language Binding to be used in the execution of

     * scripts

     *

     * @param key The name of named value to add

     * @param value The value of named value to add.

     */

    public void put(String key, Object value);

    /**

     * Retrieves a value set in the state of this ScriptingManager

     *

     * @param key The key whose value is to be returned

     *

     * @return an Object with the value corresponding to the key

     */

    public Object get(String key);

    /**

     * Gets the Help manager

     *

     * @return a {@link ScriptingHelpManager}

     *

     * @see ScriptingHelpManager

     */

    public ScriptingHelpManager getHelpManager();

    public void addLibFolder(File lib);

    public File getRootUserFolder();

    public ProviderFactory getInstallerFactory();

    public ProviderFactory getHelpInstallerFactory();

    /**

     * Devuelbe la carpeta en la que se encuentran los paquetes

     * de la aplicacion.

     * 

     * @return 

     */

    public File getPackagesFolder();

    /**

     * Establece la carpeta en la que se encuentran los paquetes

     * de la aplicacion.

     * @param folder 

     */

    public void setPackagesFolder(File folder);

}