Application: gvSIG desktop

import com.iver.andami.plugins.ExtensionDecorator;

import com.iver.andami.plugins.IExtension;

import com.iver.andami.plugins.PluginClassLoader;

import com.iver.andami.ui.mdiFrame.MDIFrame;

import com.iver.andami.ui.mdiFrame.MainFrame;

import com.iver.andami.ui.mdiManager.MDIManager;

/**

 * Clase que proporciona servicios a los plugins.

 * @author Fernando Gonz?lez Cort?s

 */

public class PluginServices {

	/**

	 * Crea un nuevo PluginServices

	 * @param loader

	 *            ClassLoader del plugin

	 */

	/**

	 * Devuelve el mensaje en el idioma del locale actual del texto

	 * correspondiente a la clave que se pasa como par?metro

	 * @param key

	 *            Clave del texto que se quiere obtener

	 * @return Texto en el idioma que toca o la propia clave si no se encuentra

	 *         en el fichero

	 */

	/**

	 * Obtiene el classloader del plugin

	 * @return Returns the loader.

	 */

	public PluginClassLoader getClassLoader() {

	/**

	 * Obtiene el nombre del plugin

	 * @return String

	 */

	String getPluginName() {

	/**

	 * Establece el paquete de traducciones del objeto pluginservices asociado a

	 * un plugin

	 * @param name

	 *            nombre del paquete

	 * @param locale

	/**

	 * Obtienen una referencia al PluginServices del plugin cuyo nombre se pasa

	 * como par?metro

	 * @param pluginClassInstance

	 *            Instancia de una clase propia del plugin a cuyos servicios se

	 *            quiere acceder

	 * @return Objeto PluginServices asociado al plugin

	 * @throws RuntimeException

	 *             Si el par?metro no es un objeto cargado desde un plugin

	 */

	/**

	 * Obtienen una referencia al PluginServices del plugin cuyo nombre se pasa

	 * como par?metro

	 * @param pluginName

	 *            Instancia de una clase propia del plugin a cuyos servicios se

	 *            quiere acceder

	 * @return Objeto PluginServices asociado al plugin

	 */

	public static PluginServices getPluginServices(String pluginName) {

	/**

	 * Obtiene una referencia al gestor de ventanas

	 * @return MDIManager

	 */

	public static MDIManager getMDIManager() {

	/**

	 * Obtiene una referencia al marco principal de la aplicaci?n

	 * @return MainFrame

	 */

	public static MainFrame getMainFrame() {

	/**

	 * Obtiene una referencia a la instancia de la extensi?n cuya clase se pasa

	 * como par?metro

	 * @param extensionClass

	 *            Clase de la extensi?n cuya instancia se quiere obtener

	 * @return Instancia de la extensi?n o null en caso de que no haya una

	 *         extensi?n con esa clase

	 */

	/**

	 * Gets a reference to the Extension Decorator with support for several more

	 * options

	 * @param extensionClass

	 * @return

	 */

	/**

	 * Obtiene un iterador sobre las extensiones

	 * @return Iterator

	 */

	public static Iterator getExtensions() {

	/**

	 * Obtiene una traducci?n de un plugin

	 * @param pluginObject

	 *            Objeto cargado desde un plugin

	 * @param key

	 *            Nombre de la clave cuyo valor se quiere obtener

	 * @return El valor, si existe. La clave si no existe. Si el objeto que se

	 *         pasa como par?metro no ha sido cargado desde un plugin se

	 *         devuelve la clave.

	/**

	 * Establece los datos del plugin que deber?n persistir entre ejecuciones en

	 * formato xml

	 * @param entity

	 *            DOCUMENT ME!

	 */

	/**

	 * Obtiene un objeto que representa la persistencia del plugin en formato

	 * xml.

	 * @return Devuelve null hasta que se invoca el m?todo setPersistentXML

	 */

	public XMLEntity getPersistentXML() {

	/**

	 * A?ade un listener a un popup menu registrado en el config.xml de alg?n

	 * plugin

	 * @param name

	 *            Nombre del men? contextual

	 * @param c

	 * @param 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

	/**

	 * Obtiene una referencia al directorio del plugin

	 * @return File

	 */

	public File getPluginDirectory() {

	/**

	 * Ejecuta una tarea en segundo plano, dejando a la interfaz responder pero

	 * inhibiendo los eventos

	 * @param r

	 *            Tarea a ejecutar

	 * @return Thread en el que se ejecuta la tarea

	 */

	public static Thread backgroundExecution(Runnable r) {

	/**

	 * Runs a task in background. This task could be monitored and canceled, and

	 * doesnt inhibed any event.

	 * @param task

	 *            IMonitorableTask

	 */

	/**

	 * DOCUMENT ME!

	 * @author Fernando Gonz?lez Cort?s

	 */

	private static class RunnableDecorator implements Runnable {

		/**

		 * Crea un nuevo RunnableDecorator.

		 * @param r

		 *            DOCUMENT ME!

		 */

	/**

	 * Usually appName plugins-directory [locale] [other args]

	 * @return the original arguments that Andami received. (app-name

	 *         plugins-directory, locale, etc)

	 */

	public static void setAuthentication(IAuthentication authen) {

		authentication = authen;

	}

}