svn-gvsig-desktop / tags / v1_0_2_Build_896 / frameworks / _fwAndami / src / com / iver / andami / plugins / Extension.java @ 10391
History | View | Annotate | Download (4.26 KB)
1 | 5005 | jorpiell | package com.iver.andami.plugins; |
---|---|---|---|
2 | 1104 | fjp | /* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana
|
3 | *
|
||
4 | * Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.
|
||
5 | *
|
||
6 | * This program is free software; you can redistribute it and/or
|
||
7 | * modify it under the terms of the GNU General Public License
|
||
8 | * as published by the Free Software Foundation; either version 2
|
||
9 | * of the License, or (at your option) any later version.
|
||
10 | *
|
||
11 | * This program is distributed in the hope that it will be useful,
|
||
12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
14 | * GNU General Public License for more details.
|
||
15 | *
|
||
16 | * You should have received a copy of the GNU General Public License
|
||
17 | * along with this program; if not, write to the Free Software
|
||
18 | * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,USA.
|
||
19 | *
|
||
20 | * For more information, contact:
|
||
21 | *
|
||
22 | * Generalitat Valenciana
|
||
23 | * Conselleria d'Infraestructures i Transport
|
||
24 | * Av. Blasco Ib??ez, 50
|
||
25 | * 46010 VALENCIA
|
||
26 | * SPAIN
|
||
27 | *
|
||
28 | * +34 963862235
|
||
29 | * gvsig@gva.es
|
||
30 | * www.gvsig.gva.es
|
||
31 | *
|
||
32 | * or
|
||
33 | *
|
||
34 | * IVER T.I. S.A
|
||
35 | * Salamanca 50
|
||
36 | * 46005 Valencia
|
||
37 | * Spain
|
||
38 | *
|
||
39 | * +34 963163400
|
||
40 | * dac@iver.es
|
||
41 | */
|
||
42 | 5005 | jorpiell | /* CVS MESSAGES:
|
43 | *
|
||
44 | * $Id$
|
||
45 | * $Log$
|
||
46 | 9321 | jmvivo | * Revision 1.6.4.2 2006-12-14 16:12:44 jmvivo
|
47 | * Modificaciones para dar soporte a que una Extension tenga el control exclusivo del UI (visibilidad/habilitado)
|
||
48 | *
|
||
49 | * Revision 1.6.4.1 2006/11/15 00:08:21 jjdelcerro
|
||
50 | 8765 | jjdelcerro | * *** empty log message ***
|
51 | *
|
||
52 | * Revision 1.7 2006/09/15 10:39:18 caballero
|
||
53 | * multisplah y postInitialize
|
||
54 | *
|
||
55 | * Revision 1.6 2006/07/31 18:22:13 cesar
|
||
56 | 6586 | cesar | * Rename finalize method to terminate method
|
57 | *
|
||
58 | * Revision 1.5 2006/05/02 15:53:06 jorpiell
|
||
59 | 5005 | jorpiell | * Se ha cambiado la interfaz Extension por dos clases: una interfaz (IExtension) y una clase abstract(Extension). A partir de ahora todas las extensiones deben heredar de Extension
|
60 | *
|
||
61 | *
|
||
62 | */
|
||
63 | 598 | fernando | /**
|
64 | * <p>
|
||
65 | * Una extensi?n es el mecanismo en la que los plugins pueden extender Andami.
|
||
66 | * En la aplicaci?n habr? una instancia de cada extensi?n, las cuales tienen
|
||
67 | * unos m?todos que ser?n ejecutados en respuesta a acciones del usuario. Las
|
||
68 | * extensiones pueden a?adir controles a la interfaz de usuario. Pueden
|
||
69 | * a?adir men?s y herramientas de la barra de herramientas, de forma que al
|
||
70 | * ser seleccionadas se ejecute c?digo de la extensi?n. Adem?s de implementar esta
|
||
71 | * interfaz, una extensi?n ha de tener un constructor vac?o, el cual ser? invocado
|
||
72 | * para crear la instancia de la interfaz
|
||
73 | * </p>
|
||
74 | 8765 | jjdelcerro | *
|
75 | 598 | fernando | * <p>
|
76 | * En un plugin correctamente implementado se crear? una instancia de cada
|
||
77 | 5005 | jorpiell | * extensi?n, que tiene que heredar de esta clase abstracta. Tras la creaci?n
|
78 | * se invocar? al m?todo inicializar y luego con la aplicaci?n en marcha se
|
||
79 | * invocar? a los m?todos isEnabled(), isVisible(), repetidas veces para
|
||
80 | * controlar la activaci?n y visualizaci?n de los controles relacionados
|
||
81 | * con la extensi?n. Cuando se ejecuta una extensi?n se ejecuta el metodo
|
||
82 | * execute. Dicho m?todo se ejecuta en el thread de la interfaz de usuario,
|
||
83 | * por lo que dejar? la interfaz bloqueada. Si se quiere dejar activa la
|
||
84 | * interfaz se deber? lanzar un thread a parte. Al finalizar la extensi?n, se
|
||
85 | * ejecutar? el m?todo finalize.
|
||
86 | 598 | fernando | * </p>
|
87 | 8765 | jjdelcerro | *
|
88 | 5005 | jorpiell | * <p>
|
89 | 8765 | jjdelcerro | * Si se desea dotar de m?s funcionalidad a las extensiones, se deben
|
90 | 5005 | jorpiell | * incluir los nuevos m?todos en esta clase y sobreescribirlos en las
|
91 | * clases que implementen la extensi?n. De ese modo se evita que el impacto
|
||
92 | * sobre la aplicaci?n sea muy grande si se tiene que a?adir un nuevo
|
||
93 | * m?todo en la extensi?n.
|
||
94 | 8765 | jjdelcerro | * </p>
|
95 | 5005 | jorpiell | *
|
96 | * @author Jorge Piera Llodr? (piera_jor@gva.es)
|
||
97 | 598 | fernando | */
|
98 | 5005 | jorpiell | public abstract class Extension implements IExtension { |
99 | 8765 | jjdelcerro | |
100 | 5005 | jorpiell | /*
|
101 | * (non-Javadoc)
|
||
102 | 8765 | jjdelcerro | * @see com.iver.andami.plugins.Extension#terminate()
|
103 | 5005 | jorpiell | */
|
104 | 6586 | cesar | public void terminate(){ |
105 | 8765 | jjdelcerro | |
106 | 5005 | jorpiell | } |
107 | 8765 | jjdelcerro | /*
|
108 | * (non-Javadoc)
|
||
109 | * @see com.iver.andami.plugins.Extension#postInitialize()
|
||
110 | */
|
||
111 | public void postInitialize(){ |
||
112 | 598 | fernando | |
113 | 8765 | jjdelcerro | } |
114 | |||
115 | 9321 | jmvivo | /**
|
116 | * (non-Javadoc)
|
||
117 | * @see com.iver.andami.plugins.IExtension#isEnabled(IExtension extension)
|
||
118 | */
|
||
119 | public boolean isEnabled(IExtension extension) { |
||
120 | return extension.isEnabled();
|
||
121 | } |
||
122 | |||
123 | /**
|
||
124 | * (non-Javadoc)
|
||
125 | * @see com.iver.andami.plugins.IExtension#isVisible(IExtension extension)
|
||
126 | */
|
||
127 | public boolean isVisible(IExtension extension) { |
||
128 | return extension.isVisible();
|
||
129 | } |
||
130 | |||
131 | 598 | fernando | } |