/tags/v1_0_2_Build_916/libraries/libIverUtiles/src/com/iver/utiles/extensionPoints/package.html - Annotate - | gvSIG desktop 1 - gvSIG

root / tags / v1_0_2_Build_916 / libraries / libIverUtiles / src / com / iver / utiles / extensionPoints / package.html @ 12327

History | View | Annotate | Download (4.36 KB)

-            jjdelcerro
+<html>
 <body>
-            jjdelcerro
+<p>
-            jorpiell
+Este paquete expone un mecanismo para registro de clases.
-            jjdelcerro
+</p>
 <p>
-            jjdelcerro
+Permite registrar clases o factorias de clases que luego pueden ser
 recuperadas para construir instancias.
-            jjdelcerro
+</p>
 <p>
-            jjdelcerro
+La finalidad de este registro es el manejo de puntos de extension a una
 aplicacion. Una aplicacion declara o registra con un nombre los puntos de
 extension que va a tener. Cada punto de extension puede tener registradas una
 o mas extensiones. Cuando se quiere a?adir una extension a la aplicacion, se
 registra la clase o factoria que gestiona esa extension para el punto de extension
 que se desee.
-            jjdelcerro
+</p>
 <p>
-            jjdelcerro
+Veamos esto con un ejemplo.
-            jjdelcerro
+</p>
 <p>
-            jjdelcerro
+Supongamos que queremos a?adir un punto de extension a la aplicacion gvSIG, que
 permita asignar un mecanismo de presentacion de la informacion asociada a la
 herramienta de "informacion" especializada segun el tipo de tema sobre el que se
 esta trabajando.
-            jjdelcerro
+</p>
 <p>
-            jjdelcerro
+Lo primero que tendriamos que hacer es darle un nombre al punto de extension.
-            jjdelcerro
+Lo llamaremos "InfoByPoint". Para esto, la aplicacion que valla a utilizar
-            jjdelcerro
+las extensiones que se registren en este punto deberia hacer lo siguiente:
-            jjdelcerro
+</p>
-            vacevedo
+<pre>
-            jjdelcerro
+  ExtensionPoint infoByPoint = new ExtensionPoint("InfoByPoint","Registra las distintas extensiones que se pueden a?adir al 'InfoByPoint'");
   ExtensionPoints extensionPoints = ExtensionPointsSingleton.getInstance();
   extensionPoints.put(infoByPoint);
-            vacevedo
+</pre>
-            jjdelcerro
+<p>
-            jjdelcerro
+Con esto creamos un punto de extension de nombre "InfoByPoint", recogemos la
 instancia del registro de extensiones e insertamos el nuevo punto de extenstion
-            jjdelcerro
+en el.<br>
 Normalmente esta operacion, en el contexto de gvSIG, se realizaria en la
 inicializacion de la extension de andami en la que vallamos a a?adir
 la herramienta de informacion.
 </p>
 <p>
 Las extensiones a registrar en el "InfoByPoint" podrian consistir un un
 JPanel que gestione la presentacion a usar para el tema.
 </p>
 <p>
 Luego, desde la parte de la aplicacion que necesite a?adir nueva funcionalidad
 en este punto de extension, se deberia a?adir la extension. Por ejemplo
 en la extension de andami de WMS, se podria a?adir a "InfoByPoint" la posibilidad
 de usar una forma especial de presentacion. Podria hacerse:
 </p>
 <pre>
     ExtensionPoints extensionPoints = ExtensionPointsSingleton.getInstance();
     extensionPoints.add("InfoByPoint","WMS",PanelQueGestionaLaExtension);
 </pre>
 <p>
 Donde "PanelQueGestionaLaExtension" sera el JPanel que gestiona la extension para
 "InfoByPoint" de WMS.
 </p>
 <p>
 Si quieran acceder a la extension de nombre "WMS"
-            jjdelcerro
+se haria:
-            jjdelcerro
+</p>
-            vacevedo
+<pre>
-            jjdelcerro
+    ExtensionPoints extensionPoints = ExtensionPointsSingleton.getInstance();
-            jjdelcerro
+    ExtensionPoint infoByPoint = (ExtensionPoint)extensionPoints.get("InfoByPoint");
-            jjdelcerro
+    Object ext = infoByPoint.create("WMS");
-            vacevedo
+</pre>
-            jjdelcerro
+<p>
 Y esto nos devolberia un objeto JPanel que gestiona la extension "WMS"
 para el "InfoByPoint".
 </p>
 <p>
 Si quisiesemos recorrer las distintas extensiones de ese punto podriamos
 hacerlo asi:
 </p>
-            vacevedo
+<pre>
-            jjdelcerro
+    ExtensionPoints extensionPoints = ExtensionPointsSingleton.getInstance();
-            jjdelcerro
+    ExtensionPoint infoByPoint = (ExtensionPoint)extensionPoints.get("InfoByPoint");
-            jjdelcerro
+    Iterator infoByPoint =infoByPoint.keySet().iterator();
     while( i.hasNext() ) {
       String nombre = (String)i.next();
       ...
       // Y para crear los JPanel asociados a la extension...
       Object panel = infoByPoint.create(nombre);
       ...
+    }
-            vacevedo
+</pre>
-            jjdelcerro
+<p>
 Ademas de registrar clases en un punto de extension, se pueden registrar
 instancias que implementen el interface de IExtensionBuilder. En este caso,
 cuando se invoque al metodo "create" del punto de extension, en lugar
 de crear una instancia, como no tiene la clase, este invocara al metodo
 create del objeto que ha sido registrado.
 </p>
             jjdelcerro
-            jjdelcerro
+<p>
 Podemos encontrar un ejemplo de esto en la extension de JDBC para el
 catalogo. Como no existe una capa especifica para las capas JDBC, en lugar
 de registrar en el punto de extension una clase "capa JDBC", se registra
 una clase que implementa el interface IExtensionBuilder, que en su
 metodo create construye una capa vectorial y la inicializa de la forma
 apropiada para funcionar con la fuente de datos de JDBC.
 </p>
 <p>
 Hay que tener en cuenta que para un punto de extension dado, deberia ser
 trasparente que se registren en el clases o instancias que contruyen las clases.
 E incluso que es posible mezclar en un punto de extension los dos
 mecanismos, como es el caso del catalogo.
 </p>
-            jjdelcerro
+</body>
 </html>