org.gvsig.scripting

Interface ScriptingManager

All Superinterfaces:

ScriptManager

All Known Implementing Classes:

DefaultScriptingManager

public interface ScriptingManager
extends ScriptManager

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.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_ISOLATION_GROUP
static java.lang.String	INSTALLER_PROVIDER_DESCRIPTION
static java.lang.String	INSTALLER_PROVIDER_NAME
static java.lang.String	PYTHON_LANGUAGE_NAME
static java.lang.String	UNIT_DIALOG
static java.lang.String	UNIT_EXTERNALFILE
static java.lang.String	UNIT_FOLDER
static java.lang.String	UNIT_SCRIPT

Method Summary

Modifier and Type	Method and Description
void	addAlternativeUserFolder(java.io.File f, java.lang.String name, java.lang.String description)
void	addLibFolder(java.io.File lib)
ScriptingFolder	createLink(java.lang.String name, java.io.File link, java.lang.String targetPathName)
ScriptingFolder	createLink(java.lang.String name, ScriptingFolder link, java.lang.String targetPathName)
ScriptingUnit	createUnit(java.lang.String unitType, ScriptingFolder folder, java.lang.String id)
ScriptingUnit	createUnit(java.lang.String unitType, ScriptingFolder folder, java.lang.String id, java.lang.String language)
java.lang.Object	get(java.lang.String key) Retrieves a value set in the state of this ScriptingManager
java.util.List<ScriptingFolder>	getAlternativeUserFolders()
java.io.File	getDataFolder(java.lang.String id)
java.lang.String	getEngineNameByLanguage(java.lang.String langName)
java.util.Set<java.lang.String>	getEnginesIsolationGroups()
java.util.Map	getExtendedProperties() Returns a hash map with all new properties associated to this layer.
java.lang.String	getExtensionOfLanguage(java.lang.String language)
ScriptingFolder	getFolder(java.io.File file) Returns the ScriptingFolder associated with the file specified
java.io.File	getHomeFolder()
ProviderFactory	getInstallerFactory()
java.util.List<java.io.File>	getLibFolders()
java.util.Map<java.lang.String,java.lang.String>	getLibFoldersVersions() Return a map with the label and suffix of the library versions.
java.io.File	getPackagesFolder() Devuelbe la carpeta en la que se encuentran los paquetes de la aplicacion.
java.lang.Object	getProperty(java.lang.Object key) Returns a reference to an object (property) associated to this layer.
java.io.File	getRootUserFolder()
ScriptingBaseScript	getScript(java.io.File file) Returns the ScriptingBaseScript associated with the file specified
ScriptingBaseScript	getScript(java.lang.String name)
java.util.List<java.lang.String>	getSupportedLanguages()
ScriptingFolder	getSystemFolder() Returns the System's Folder
ScriptingUnit	getUnit(java.lang.String pathName) Return the ScriptingUnit associated with the path specified.
java.util.List<java.lang.String>	getUnitTypes()
ScriptingFolder	getUserFolder() Returns the User's Folder
void	loadEngines() Search the available engines and initialize the manager.
void	put(java.lang.String key, java.lang.Object value) 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
void	registerDataFolder(ScriptingFolder folderScript, java.lang.String id)
void	registerSystemFolder(java.lang.String name, java.io.File folder) Registers a File System with ScriptingUnits in the SystemFolder
java.util.List<DataFolderFound>	searchOldVersions(Version currentVersion, FolderSet folder)
void	setHomeFolder(java.io.File home)
void	setPackagesFolder(java.io.File folder) Establece la carpeta en la que se encuentran los paquetes de la aplicacion.
void	setProperty(java.lang.Object key, java.lang.Object obj) Inserts an object as a property to this layer.
boolean	validateUnitId(ScriptingFolder folder, java.lang.String id) Checks if an id is unique in a determinate folder

Methods inherited from interface org.gvsig.tools.script.ScriptManager

createEvaluator, createScript, loadScript, loadScript, locateScript

Field Detail

INSTALLER_PROVIDER_NAME

static final java.lang.String INSTALLER_PROVIDER_NAME

See Also:

Constant Field Values

INSTALLER_PROVIDER_DESCRIPTION

static final java.lang.String INSTALLER_PROVIDER_DESCRIPTION

See Also:

Constant Field Values

PYTHON_LANGUAGE_NAME

static final java.lang.String PYTHON_LANGUAGE_NAME

See Also:

Constant Field Values

DEFAULT_ISOLATION_GROUP

static final java.lang.String DEFAULT_ISOLATION_GROUP

See Also:

Constant Field Values

UNIT_SCRIPT

static final java.lang.String UNIT_SCRIPT

See Also:

Constant Field Values

UNIT_DIALOG

static final java.lang.String UNIT_DIALOG

See Also:

Constant Field Values

UNIT_FOLDER

static final java.lang.String UNIT_FOLDER

See Also:

Constant Field Values

UNIT_EXTERNALFILE

static final java.lang.String UNIT_EXTERNALFILE

See Also:

Constant Field Values

Method Detail

setHomeFolder

void setHomeFolder(java.io.File home)

getHomeFolder

java.io.File getHomeFolder()

getDataFolder

java.io.File getDataFolder(java.lang.String id)

registerDataFolder

void registerDataFolder(ScriptingFolder folderScript,
                        java.lang.String id)

searchOldVersions

java.util.List<DataFolderFound> searchOldVersions(Version currentVersion,
                                                  FolderSet folder)

getSystemFolder

ScriptingFolder getSystemFolder()

Returns the System's Folder

Returns:

a ScriptingFolder with the System's Folder.

getUserFolder

ScriptingFolder getUserFolder()

Returns the User's Folder

Returns:

a ScriptingFolder with the User's Folder.

getAlternativeUserFolders

java.util.List<ScriptingFolder> getAlternativeUserFolders()

addAlternativeUserFolder

void addAlternativeUserFolder(java.io.File f,
                              java.lang.String name,
                              java.lang.String description)

createUnit

ScriptingUnit createUnit(java.lang.String unitType,
                         ScriptingFolder folder,
                         java.lang.String id)

createUnit

ScriptingUnit createUnit(java.lang.String unitType,
                         ScriptingFolder folder,
                         java.lang.String id,
                         java.lang.String language)

getUnitTypes

java.util.List<java.lang.String> getUnitTypes()

getScript

ScriptingBaseScript getScript(java.io.File file)

Returns the ScriptingBaseScript associated with the file specified

Parameters:

file - File where is contained the ScriptingBaseScript's information

Returns:

ScriptingBaseScript

getScript

ScriptingBaseScript getScript(java.lang.String name)

getFolder

ScriptingFolder getFolder(java.io.File file)

Returns the ScriptingFolder associated with the file specified

Parameters:

file - File where is contained the ScriptingFolder's information

Returns:

ScriptingFolder

getUnit

ScriptingUnit getUnit(java.lang.String pathName)

Return the ScriptingUnit associated with the path specified. the path should start with "User" or "System".

Parameters:

pathName -

Returns:

the required ScriptingUnit

registerSystemFolder

void registerSystemFolder(java.lang.String name,
                          java.io.File folder)

Registers a File System with ScriptingUnits in the SystemFolder

Parameters:

name - String with the identificator name of the File System registered

folder - File with the root of the File System to register

getSupportedLanguages

java.util.List<java.lang.String> getSupportedLanguages()

getExtensionOfLanguage

java.lang.String getExtensionOfLanguage(java.lang.String language)

getEngineNameByLanguage

java.lang.String getEngineNameByLanguage(java.lang.String langName)

getEnginesIsolationGroups

java.util.Set<java.lang.String> getEnginesIsolationGroups()

validateUnitId

boolean validateUnitId(ScriptingFolder folder,
                       java.lang.String id)

Checks if an id is unique in a determinate folder

Parameters:

folder - {

id - String with the id to validate

Returns:

true if there isn't another ScriptingUnit with the same id, and false in the other case

put

void put(java.lang.String key,
         java.lang.Object value)

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

Parameters:

key - The name of named value to add

value - The value of named value to add.

get

java.lang.Object get(java.lang.String key)

Retrieves a value set in the state of this ScriptingManager

Parameters:

key - The key whose value is to be returned

Returns:

an Object with the value corresponding to the key

addLibFolder

void addLibFolder(java.io.File lib)

getRootUserFolder

java.io.File getRootUserFolder()

getInstallerFactory

ProviderFactory getInstallerFactory()

getPackagesFolder

java.io.File getPackagesFolder()

Devuelbe la carpeta en la que se encuentran los paquetes de la aplicacion.

Returns:

setPackagesFolder

void setPackagesFolder(java.io.File folder)

Establece la carpeta en la que se encuentran los paquetes de la aplicacion.

Parameters:

folder -

loadEngines

void loadEngines()

Search the available engines and initialize the manager.

getLibFolders

java.util.List<java.io.File> getLibFolders()

getLibFoldersVersions

java.util.Map<java.lang.String,java.lang.String> getLibFoldersVersions()

Return a map with the label and suffix of the library versions. For each value of map, the value is the name of the version (a label) and the key is the suffix for that version.

Returns:

a map with suffix and labels of library versions.

getProperty

java.lang.Object getProperty(java.lang.Object key)

Returns a reference to an object (property) associated to this layer.

For example, you can attach a network definition to key "network" and check if a layer has a network loaded using getAssociatedObject("network") and that it's not null.

Parameters:

key - the key associated to the property

Returns:

null if key is not found

See Also:

getExtendedProperties(), setProperty(Object, Object)

setProperty

void setProperty(java.lang.Object key,
                 java.lang.Object obj)

Inserts an object as a property to this layer.

Parameters:

key - the key associated to the property

obj - the property

See Also:

getProperty(Object), getExtendedProperties()

getExtendedProperties

java.util.Map getExtendedProperties()

Returns a hash map with all new properties associated to this layer.

Returns:

hash table with the added properties

See Also:

getProperty(Object), setProperty(Object, Object)

createLink

ScriptingFolder createLink(java.lang.String name,
                           java.io.File link,
                           java.lang.String targetPathName)

createLink

ScriptingFolder createLink(java.lang.String name,
                           ScriptingFolder link,
                           java.lang.String targetPathName)