PluginServices

java.lang.Object
- org.gvsig.andami.PluginServices

```
public class PluginServices
extends Object
```
Provides services to Plugins. Each plugin has an associated PluginServices object, which provides specific services. Main of them: translations, logging, access to plugin's resources, background tasks, clipboard access and data persistence.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`class`	`PluginServices.PluginLoadDataException`
`class`	`PluginServices.PluginPersistenceAddDefinitionException`
`class`	`PluginServices.PluginPersistenceNeedDefinitionException`
`class`	`PluginServices.PluginSaveDataException`

Constructor Summary

Constructors
Constructor and Description
`PluginServices(PluginClassLoader loader)` Creates a new PluginServices objetct.
`PluginServices(PluginClassLoader loader, String[] alternativeNames)`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addDependencyWithPlugin(PluginServices otherPlugin)`
`static void`	`addLoaders(ArrayList classLoaders)`
`void`	`addPopupMenuListener(String name, Component c, ActionListener listener)` A�ade un listener a un popup menu registrado en el config.xml de alg�n plugin
`static Thread`	`backgroundExecution(Runnable r)` Runs a background task.
`static void`	`cancelableBackgroundExecution(IMonitorableTask task)` Runs a backbround task.
`static void`	`closeApplication()` Closes the application.
`String[]`	`getAlternativeNames()`
`static String`	`getArgumentByName(String name)` Returns the value of a command line named argument.
`static String[]`	`getArguments()` Gets an array containing the application's startup arguments.
`PluginClassLoader`	`getClassLoader()` Gets the plugin's classloader.
`static ExtensionDecorator`	`getDecoratedExtension(Class extensionClass)` Gets a reference to the Extension Decorator which adds some extra options to the basic extension interface.
`static ExtensionDecorator[]`	`getDecoratedExtensions()` Returns an array containing references to all the loaded extensions.
`static DlgPreferences`	`getDlgPreferences()`
`static ExclusiveUIExtension`	`getExclusiveUIExtension()` Gets the ExclusiveUIExtension, an special extension which will take control over the UI and will decide which extensions may be enable/disabled or visible/hidden.
`static IExtension`	`getExtension(Class extensionClass)` Gets the instance of the extension whose class is provided.
`static Iterator`	`getExtensions()` Gets an iterator with all the loaded Extensions.
`static String`	`getFromClipboard()` Gets text data from the Clipboard, if available.
`static IconTheme`	`getIconTheme()` Deprecated. use ToolsSwingLocator.getIconThemeManager().getCurrent()
`static IconThemeManager`	`getIconThemeManager()` Deprecated. use ToolsSwingLocator.getIconThemeManager()
`static Logger`	`getLogger()` Gets the logger.
`static MainFrame`	`getMainFrame()` Gets the application's main frame.
`PluginsManager`	`getManager()`
`static MDIManager`	`getMDIManager()` Gets the window manager (MDIManager).
`XMLEntity`	`getPersistentXML()` Gets the XML data which was saved on previous sessions for this plugins.
`File`	`getPluginDirectory()` Gets the plugin's root directory.
`File`	`getPluginHomeFolder()` Returns the folder where the plugin stores its resources.
`String`	`getPluginName()` Gets the plugin's name
`DynObject`	`getPluginProperties()`
`static PluginServices`	`getPluginServices(Object pluginClassInstance)` Gets a reference to the PluginServices object associated with the plugin containing the provided class.
`static PluginServices`	`getPluginServices(String pluginName)` Gets a reference to the PluginServices object associated with the provided plugin.
`static String`	`getText(Object pluginObject, String key)` Returns the message in the current's locale language corresponding to the provided translation key.
`String`	`getText(String key)` Returns the message in the current's locale language corresponding to the provided translation key.
`static void`	`putInClipboard(String data)` Stores the provided text data on the clipboard.
`static void`	`registerKeyStroke(KeyStroke key, KeyEventDispatcher a)`
`static boolean`	`runningInDevelopment()` Try to detect if the application is running in a development environment.
`void`	`savePluginProperties()`
`static void`	`setArguments(String[] arguments)` Replaces the original Andami arguments with the provided arguments.
`static void`	`setExclusiveUIExtension(ExclusiveUIExtension extension)` Sets the ExclusiveUIExtension, an special extension which will take control over the UI and will decide which extensions may be enable/disabled or visible/hidden.
`void`	`setPersistentXML(XMLEntity entity)` Sets the XML data which should be saved on disk for this plugin.
`String`	`toString()`
`static void`	`unRegisterKeyStroke(KeyStroke key)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - PluginServices
```
public PluginServices(PluginClassLoader loader)
```
    Creates a new PluginServices objetct.
    
    Parameters:
    loader - The Plugin's ClassLoader.
  - PluginServices
```
public PluginServices(PluginClassLoader loader,
              String[] alternativeNames)
```
- Method Detail
  - getAlternativeNames
```
public String[] getAlternativeNames()
```
  - getText
```
public String getText(String key)
```
    Returns the message in the current's locale language corresponding to the provided translation key. The key-message pairs are obtained from the plugin's translation files (text_xx.properties files).
    
    Parameters:
    key - Translation key whose associated message is to be obtained
    
    Returns:
    The message associated with the provided key, in one of the current locale languages, or the key if the translation is not found.
  - getClassLoader
```
public PluginClassLoader getClassLoader()
```
    Gets the plugin's classloader.
    
    Returns:
    Returns the loader.
  - getPluginName
```
public String getPluginName()
```
    Gets the plugin's name
    
    Returns:
    The plugin's name
  - getPluginServices
```
public static PluginServices getPluginServices(Object pluginClassInstance)
```
    Gets a reference to the PluginServices object associated with the plugin containing the provided class. Obtienen una referencia al PluginServices del plugin cuyo nombre se pasa como par�metro
    
    Parameters:
    pluginClassInstance - An instance of a class. This class is contained in a plugin, whose services are to be obtained
    
    Returns:
    The PluginServices object associated to the containing plugin
    
    Throws:
    
    RuntimeException - If the parameter was not loaded from a plugin
  - getPluginServices
```
public static PluginServices getPluginServices(String pluginName)
```
    Gets a reference to the PluginServices object associated with the provided plugin.
    
    Parameters:
    pluginName - Plugin's name whose services are going to be used
    
    Returns:
    The PluginServices object associated with the provided plugin.
  - getMDIManager
```
public static MDIManager getMDIManager()
```
    Gets the window manager (MDIManager).
    
    Returns:
    A reference to the window manager (MDIManager).
  - getMainFrame
```
public static MainFrame getMainFrame()
```
    Gets the application's main frame.
    
    Returns:
    A reference to the application's main window
  - registerKeyStroke
```
public static void registerKeyStroke(KeyStroke key,
                     KeyEventDispatcher a)
```
  - unRegisterKeyStroke
```
public static void unRegisterKeyStroke(KeyStroke key)
```
  - getExtension
```
public static IExtension getExtension(Class extensionClass)
```
    Gets the instance of the extension whose class is provided.
    
    Parameters:
    extensionClass - Class of the extension whose instance is to be returned
    
    Returns:
    The instance of the extension, or null if the instance does not exist.Instancia de la extensi�n o null en caso de que no haya una
  - getDecoratedExtension
```
public static ExtensionDecorator getDecoratedExtension(Class extensionClass)
```
    Gets a reference to the Extension Decorator which adds some extra options to the basic extension interface.
    
    Parameters:
    extensionClass - The class of the extension whose decorator is to be returned
    
    Returns:
    The ExtensionDecorator associated with the provided extension, or null if the extension does not exist.
  - getDecoratedExtensions
```
public static ExtensionDecorator[] getDecoratedExtensions()
```
    Returns an array containing references to all the loaded extensions.
    
    Returns:
    ExtensionDecorator[] An array of ExtensionDecorators (each Decorator contains one extension).
  - getExtensions
```
public static Iterator getExtensions()
```
    Gets an iterator with all the loaded Extensions.
    
    Returns:
    Iterator over the decorated extensions (each member of the iterator is an ExtensionDecorator, which in turn contains one IExtension object).
  - getText
```
public static String getText(Object pluginObject,
             String key)
```
    Returns the message in the current's locale language corresponding to the provided translation key. The key-message pairs are obtained from the plugin's translation files (text_xx.properties files).
    
    Parameters:
    pluginObject - Any object which was loaded from a plugin
    key - Translation key whose associated message is to be obtained
    
    Returns:
    The message associated with the provided key, in one of the current locale languages, or the key if the translation is not found.
  - setPersistentXML
```
public void setPersistentXML(XMLEntity entity)
```
    Sets the XML data which should be saved on disk for this plugin. This data can be retrieved on following sessions.
    
    Parameters:
    The - XMLEntity object containing the data to be persisted.
    See Also:
    PluginServices.getPersistentXML(), XMLEntity
  - getPersistentXML
```
public XMLEntity getPersistentXML()
```
    Gets the XML data which was saved on previous sessions for this plugins.
    
    Returns:
    An XMLEntity object containing the persisted data
  - addPopupMenuListener
```
public void addPopupMenuListener(String name,
                        Component c,
                        ActionListener listener)
```
    A�ade un listener a un popup menu registrado en el config.xml de alg�n plugin
    
    Parameters:
    name - Nombre del men� contextual
    c - Componente que desplegar� el men� cuando se haga click con el bot�n derecho
    listener - Listener que se ejecutar� cuando se seleccione cualquier entrada del men�
    
    Throws:
    
    RuntimeException - Si la interfaz no est� preparada todav�a. S�lo puede darse durante el arranque
  - getPluginDirectory
```
public File getPluginDirectory()
```
    Gets the plugin's root directory.
    
    Returns:
    A File pointing to the plugin's root directory.
  - backgroundExecution
```
public static Thread backgroundExecution(Runnable r)
```
    Runs a background task. The events produced on the main frame will be inhibited.
    
    Parameters:
    r - The task to run.
    
    Returns:
    The Thread on which the task is executed.
  - cancelableBackgroundExecution
```
public static void cancelableBackgroundExecution(IMonitorableTask task)
```
    Runs a backbround task. This task may be monitored and canceled, and does not inhibit any event.
    
    Parameters:
    task - The task to run.
  - closeApplication
```
public static void closeApplication()
```
    Closes the application. Cleanly exits from the application: terminates all the extensions, then exits.
  - getArguments
```
public static String[] getArguments()
```
    Gets an array containing the application's startup arguments.
    
    Usually: appName plugins-directory [locale] [other args]
    
    Returns:
    the original arguments that Andami received. (app-name plugins-directory, locale, etc)
  - setArguments
```
public static void setArguments(String[] arguments)
```
    Replaces the original Andami arguments with the provided arguments.
    
    Parameters:
    arguments - An array of String, each element of the array represents one argument.
  - getArgumentByName
```
public static String getArgumentByName(String name)
```
    Returns the value of a command line named argument.
    
    The argument format is:
    -{argumentName}={argumentValue}
    
    example:
    ' -language=en '
    
    Returns:
    String The value of the argument
  - getLogger
```
public static Logger getLogger()
```
    Gets the logger. The logger is used to register important events (errors, etc), which are stored on a file which can be checked later.
    
    Returns:
    A Logger object.
    See Also:
    object from the Log4j library.
  - getDlgPreferences
```
public static DlgPreferences getDlgPreferences()
```
  - putInClipboard
```
public static void putInClipboard(String data)
```
    Stores the provided text data on the clipboard.
    
    Parameters:
    data - An String containing the data to be stored on the clipboard.
  - getFromClipboard
```
public static String getFromClipboard()
```
    Gets text data from the Clipboard, if available.
    
    Returns:
    An String containing the clipboard's data, or null if the data was not available.
  - getExclusiveUIExtension
```
public static ExclusiveUIExtension getExclusiveUIExtension()
```
    Gets the ExclusiveUIExtension, an special extension which will take control over the UI and will decide which extensions may be enable/disabled or visible/hidden.
    
    Returns:
    If an ExclusiveUIExtension was set, return this extension. Otherwise, return null.
    See Also:
    Launcher.initializeExclusiveUIExtension(), org.gvsig.andami.plugins.IExtension#isEnabled(IExtension extension), org.gvsig.andami.plugins.IExtension#isVisible(IExtension extension)
  - setExclusiveUIExtension
```
public static void setExclusiveUIExtension(ExclusiveUIExtension extension)
```
    Sets the ExclusiveUIExtension, an special extension which will take control over the UI and will decide which extensions may be enable/disabled or visible/hidden.
    
    The ExclusiveUIExtension is normally set by the following Andami startup argument:
    
    ExclusiveUIExtension=ExtensionName
    
    See Also:
    Launcher.initializeExclusiveUIExtension(), org.gvsig.andami.plugins.IExtension#isEnabled(IExtension extension), org.gvsig.andami.plugins.IExtension#isVisible(IExtension extension)
  - addLoaders
```
public static void addLoaders(ArrayList classLoaders)
```
  - getIconThemeManager
```
public static IconThemeManager getIconThemeManager()
```
    Deprecated. use ToolsSwingLocator.getIconThemeManager()
  - getIconTheme
```
public static IconTheme getIconTheme()
```
    Deprecated. use ToolsSwingLocator.getIconThemeManager().getCurrent()
  - runningInDevelopment
```
public static boolean runningInDevelopment()
```
    Try to detect if the application is running in a development environment.
    This look for .project and .classpath files in the starts path of the application.
    
    Returns:
    true if .project and .classpath are in the development path
  - getManager
```
public PluginsManager getManager()
```
  - getPluginProperties
```
public DynObject getPluginProperties()
```
  - savePluginProperties
```
public void savePluginProperties()
```
  - getPluginHomeFolder
```
public File getPluginHomeFolder()
```
    Returns the folder where the plugin stores its resources. That folder will be usually a subfolder into the application folder in the user home folder.
    
    Returns:
    the folder where the plugin stores its resources
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - addDependencyWithPlugin
```
public void addDependencyWithPlugin(PluginServices otherPlugin)
```

Class PluginServices

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

PluginServices

PluginServices

Method Detail

getAlternativeNames

getText

getClassLoader

getPluginName

getPluginServices

getPluginServices

getMDIManager

getMainFrame

registerKeyStroke

unRegisterKeyStroke

getExtension

getDecoratedExtension

getDecoratedExtensions

getExtensions

getText

setPersistentXML

getPersistentXML

addPopupMenuListener

getPluginDirectory

backgroundExecution

cancelableBackgroundExecution

closeApplication

getArguments

setArguments

getArgumentByName

getLogger

getDlgPreferences

putInClipboard

getFromClipboard

getExclusiveUIExtension

setExclusiveUIExtension

addLoaders

getIconThemeManager

getIconTheme

runningInDevelopment

getManager

getPluginProperties

savePluginProperties

getPluginHomeFolder

toString

addDependencyWithPlugin