Personal tools
gvSIG Desktop
gvSIG Desktop

Cached time 11/21/13 17:45:09 Clear cache and reload

 
Document Actions

Framework de plugins, Andami

by Joaquin Jose del Cerro Murciano last modified 2012-03-12 15:32

Andami es el framework que utiliza gvSIG para componer la aplicación. Principalmente provee dos tipos de servicios, por un lado de gestión y carga de plugins y por otro, la gestión de ventanas que componen el interfaz de usuario.

En este punto vamos a centrarnos un poquito en la gestión de plugins. Andami proporciona un lanzador para la aplicación que inicializa el sistema de plugins, y se encarga de cargar los plugins que están instalados en la aplicación. Un plugin es una unidad funcional que puede proveer:

  • Opciones de menús a instalar en la aplicación
  • Nuevos botones y barras de herramientas
  • Nuevos proveedores de datos
  • Nuevos tipos de documentos

Normalmente, en una instalación de gvSIG, encontraremos una carpeta gvSIG/extensiones. Esta carpeta contiene dentro los distintos plugins que están instalados en la aplicación. Cada plugin está contenido en una carpeta, y dentro de esta, nos encontraremos, siempre, los ficheros:

  • config.xml, que describe:

    • Dónde encontrar las clases de ese plugin

      Tip

      Puede encontrar más información sobre la estructura y distintas etiquetas que están permitidas en este fichero en el documento el fichero config.xml

    • Si ese plugin depende de algún otro plugin

    • Qué opciones de menú añade el plugin a la aplicación

    • Qué barras de herramientas y botones añade el plugin.

  • package.info, que informa sobre la versión, nombre, identificador o descripción del plugin. Sería algo así como el contenedor de los metadatos del plugin, y nos permite identificarlo para poder actualizarlo o reinstalarlo.

Adicionalmente podemos encontrarnos una carpeta theme, en la que está la configuración del splash de la aplicación, iconos de las ventanas o colores de fondo.

Aunque el mecanismo para añadir nueva funcionalidad a gvSIG es aportando nuevos plugins, estos a su vez contendrán una o más extensiones, siendo estas extensiones las que implementarán la funcionalidad a aportar. Así pues, tendremos que un plugin contendrá extensiones.

Relacionado con el manejo de plugins las principales piezas que nos vamos a encontrar son:

  • PluginsLocator, que nos dará acceso al manager de plugins a través de un método estático getManager.
  • PluginsManager, que nos proporciona métodos para interrogar sobre qué plugins hay cargados y qué extensión tienen cada uno de estos.
  • La clase PluginsServices que representa la instancia de un plugin dado.
  • El interface IExtension, que representa una acción o bloque de acciones a incorporar a gvSIG.
  • El interface ExclusiveUIExtension, que nos permite controlar la visibilidad de todas las extensiones cargadas en la aplicación.

De estas entidades nos vamos a detener un poco más en la interface IExtension- Esta es la interface que deberemos implementar para poder añadir un nuevo botón u opción de menú. En esta interface nos encontraremos los métodos:

  • Initialize, este método se ejecuta cuando se carga la extensión, en la inicialización del plugin. Hay que tener en cuenta que cuando se invoque a este método es posible que no hayan sido cargadas e inicializadas todas las extensiones de gvSIG. Normalmente aquí realizaremos la inicialización de componentes de nuestra extensión que deban ser usados por otras extensiones.
  • postInitilize, se invoca en la indización la la extensión. Justo despues de haber invocado al método initialize de todas las extensiones de gvSIG. Normalmente, aquí realizaremos la inicialización de componentes de nuestra extensión que requieran de otras extensiones.
  • terminate, se invoca cuando gvSIG precisa descargar esa extensión. Normalmente esto se producirá al cierre de la aplicación. Aquí deberemos asegurarnos que sean liberados los recursos del sistema que tenga reservados nuestra extensión.
  • execute. Este método se ejecuta cada vez que el usuario interactúa con el menú o botón de la barra de herramientas asociado a la extensión. Normalmente será donde se implemente la ejecución de nuestra funcionalidad.
  • isEnable, es invocado cuando se precisa saber si el interfaz de usuario asociado a la extensión (botones u opciones de menú) deben estar habilitados.
  • isVisible, es invocado cuando se precisa saber si el interfaz de usuario asociado a la extensión (botones u opciones de menú) deben estar visibles.

View source document Get permanent link


Powered by Plone CMS, the Open Source Content Management System

This site conforms to the following standards: