Project

General

Profile

Download (10.1 KB) Statistics
| Branch: | Tag: | Revision:
1
/**
2
 *
3
 */
4
package eu.etaxonomy.taxeditor.ui.element;
5

    
6
import java.util.ConcurrentModificationException;
7
import java.util.HashSet;
8
import java.util.List;
9
import java.util.Set;
10

    
11
import org.eclipse.core.runtime.Assert;
12
import org.eclipse.jface.util.IPropertyChangeListener;
13
import org.eclipse.jface.util.PropertyChangeEvent;
14
import org.eclipse.swt.graphics.Color;
15
import org.eclipse.swt.layout.GridData;
16
import org.eclipse.swt.widgets.Composite;
17
import org.eclipse.swt.widgets.Control;
18
import org.eclipse.ui.forms.widgets.Section;
19
import org.eclipse.ui.forms.widgets.TableWrapData;
20

    
21
import eu.etaxonomy.taxeditor.model.AbstractUtility;
22
import eu.etaxonomy.taxeditor.model.MessagingUtils;
23

    
24
/**
25
 * @author n.hoffmann
26
 */
27
public abstract class AbstractCdmFormElement implements ICdmFormElement {
28

    
29
	protected CdmFormFactory formFactory;
30

    
31
	private List<IPropertyChangeListener> propertyChangeListeners;
32

    
33
	private Composite layoutComposite;
34

    
35
	private final Set<Control> controls = new HashSet<>();
36

    
37
	private final Set<ICdmFormElement> elements = new HashSet<>();
38
	private ICdmFormElement parentElement;
39

    
40
	private Color persistentBackgroundColor;
41

    
42

    
43
	protected AbstractCdmFormElement(CdmFormFactory formFactory, Composite layoutComposite){
44
		this.layoutComposite = layoutComposite;
45
		this.formFactory = formFactory;
46
	}
47

    
48
	public AbstractCdmFormElement(CdmFormFactory formFactory, ICdmFormElement formElement) {
49
		this(formFactory, formElement.getLayoutComposite());
50
		this.parentElement = formElement;
51
//		addControl(layoutComposite);
52
	}
53

    
54
	@Override
55
    public CdmFormFactory getFormFactory() {
56
		return formFactory;
57
	}
58

    
59
	/**
60
	 * Delegates the focus to <code>this</code> elements main input control
61
	 */
62
	public void setFocus(){
63
		// Override in subclasses where needed
64
	}
65

    
66
	/**
67
	 * Returns all Controls that are managed by this element
68
	 *
69
	 * @return a {@link java.util.Set} object.
70
	 */
71
	@Override
72
    public Set<Control> getControls(){
73
		return controls;
74
	}
75

    
76
	/**
77
	 * adds the control to the set of controls that are managed by this element
78
	 *
79
	 * @param child a {@link org.eclipse.swt.widgets.Control} object.
80
	 */
81
	protected void addControl(Control child){
82
		controls.add(child);
83
	}
84

    
85
	protected void removeControl(Control child){
86
		controls.remove(child);
87
	}
88

    
89
	/**
90
	 * <p>Getter for the field <code>elements</code>.</p>
91
	 *
92
	 * @return a {@link java.util.Set} object.
93
	 */
94
	@Override
95
    public Set<ICdmFormElement> getElements(){
96
		return elements;
97
	}
98

    
99
	/**
100
	 * <p>Getter for the field <code>parentElement</code>.</p>
101
	 *
102
	 * @return a {@link eu.etaxonomy.taxeditor.ui.element.ICdmFormElement} object.
103
	 */
104
	@Override
105
    public ICdmFormElement getParentElement(){
106
		return parentElement;
107
	}
108

    
109
	/** {@inheritDoc} */
110
	@Override
111
    public void addElement(ICdmFormElement element){
112
		elements.add(element);
113
	}
114

    
115
	/**
116
	 * Remove all child {@link ICdmFormElement}s and child {@link Control}s
117
	 * of the given and the element itself.
118
	 * @param formElement The element to remove
119
	 */
120
	public void removeElementsAndControls(ICdmFormElement formElement){
121
	    for(ICdmFormElement childElement : formElement.getElements()){
122
	        // recursion
123
	        childElement.removeElements();
124

    
125
	        // unregister selection arbitrator
126
	        if(childElement instanceof ISelectableElement){
127
	            SelectionArbitrator selectionArbitrator = ((ISelectableElement) childElement).getSelectionArbitrator();
128
	            if(selectionArbitrator != null){
129
	                formFactory.destroySelectionArbitrator(selectionArbitrator);
130
	            }
131
	        }
132

    
133
	        // unregister from property changes
134
	        formFactory.removePropertyChangeListener(childElement);
135

    
136
	        // dispose of the controls
137
	        removeControls(childElement);
138
	    }
139
	    removeControls(formElement);
140
	    this.elements.remove(formElement);
141
	}
142

    
143
	/**
144
	 * Removes all child {@link ICdmFormElement}s and child {@link Control}s
145
	 * and the element itself.
146
	 */
147
	@Override
148
    public void removeElements(){
149
	    Set<ICdmFormElement> tmpElements = new HashSet<>(getElements());
150
        for (ICdmFormElement childElement : tmpElements) {
151
            // recursion
152
			childElement.removeElements();
153

    
154
			// unregister selection arbitrator
155
			if(childElement instanceof ISelectableElement){
156
				SelectionArbitrator selectionArbitrator = ((ISelectableElement) childElement).getSelectionArbitrator();
157
				if(selectionArbitrator != null){
158
					formFactory.destroySelectionArbitrator(selectionArbitrator);
159
				}
160
			}
161

    
162
			// unregister from property changes
163
			formFactory.removePropertyChangeListener(childElement);
164

    
165
			// dispose of the controls
166
			removeControls(childElement);
167
		}
168
		if(this instanceof ISelectableElement){
169
            SelectionArbitrator selectionArbitrator = ((ISelectableElement) this).getSelectionArbitrator();
170
            if(selectionArbitrator != null){
171
                formFactory.destroySelectionArbitrator(selectionArbitrator);
172
            }
173
        }
174
		removeControls(this);
175
		elements.clear();
176
	}
177

    
178
	private void removeControls(ICdmFormElement element){
179
		if(element instanceof Section){
180
			((Section) element).dispose();
181
			element = null;
182
		}else{
183
			for(Control control : element.getControls()){
184
				// we added the layoutComposite of the parental element as the layout composite to this formElement
185
				// but we do not want to destroy it.
186
				if(control.equals(element.getLayoutComposite())){
187
					continue;
188
				}else{
189
					control.dispose();
190
					control = null;
191
				}
192
			}
193
		}
194
	}
195

    
196
	/**
197
	 * <p>Getter for the field <code>layoutComposite</code>.</p>
198
	 *
199
	 * @return a {@link org.eclipse.swt.widgets.Composite} object.
200
	 */
201
	@Override
202
    public Composite getLayoutComposite() {
203
		return layoutComposite;
204
	}
205

    
206
	/**
207
	 * <p>Setter for the field <code>layoutComposite</code>.</p>
208
	 *
209
	 * @param layoutComposite a {@link org.eclipse.swt.widgets.Composite} object.
210
	 */
211
	public void setLayoutComposite(Composite layoutComposite){
212
		this.layoutComposite = layoutComposite;
213
	}
214

    
215
	public void addIndent(int indent)
216
	{  this.layoutComposite = formFactory.createComposite(layoutComposite);
217

    
218
	    if (this.layoutComposite.getParent().getLayoutData() instanceof TableWrapData){
219
	        TableWrapData tableWrap = (TableWrapData)this.layoutComposite.getParent().getLayoutData();
220
	        tableWrap.indent = indent;
221

    
222
	        this.layoutComposite.setLayoutData(tableWrap);
223
	    }
224
	    if (this.layoutComposite.getLayoutData() instanceof GridData){
225
	        GridData gridData = new GridData();
226
	        gridData.verticalIndent = indent;
227
            this.layoutComposite.setLayoutData(gridData);
228

    
229
        }
230
	}
231
	/**
232
	 * <p>Getter for the field <code>propertyChangeListeners</code>.</p>
233
	 *
234
	 * @return a {@link java.util.Set} object.
235
	 */
236
	@Override
237
    public List<IPropertyChangeListener> getPropertyChangeListeners() {
238
		return propertyChangeListeners;
239
	}
240

    
241
	/** {@inheritDoc} */
242
	@Override
243
    public void setPropertyChangeListeners(List<IPropertyChangeListener> propertyChangeListeners){
244
		this.propertyChangeListeners = propertyChangeListeners;
245
	}
246

    
247
	/** {@inheritDoc} */
248
	@Override
249
    public void firePropertyChangeEvent(CdmPropertyChangeEvent event) {
250
	    //TODO: replace propertyChangeListeners with formFactory.getPropertyChangeListeners() and remove member propertyChangeListeners from AbstractCdmFormElement
251
		Assert.isNotNull(propertyChangeListeners, "Property change listeners are not present");
252

    
253
		try{
254
			for(Object listener : propertyChangeListeners){
255
				((IPropertyChangeListener)listener).propertyChange(event);
256
			}
257
		}catch(ConcurrentModificationException e){
258
			// There are two cases that produce a CME.
259
			// Described here: http://dev.e-taxonomy.eu/trac/ticket/2363#comment:2
260
			// and here: http://dev.e-taxonomy.eu/trac/ticket/2438
261
			// Ignoring the CME because nothing bad is happening
262
			MessagingUtils.warn(getClass(), "ConcurrentModificationException. Can be ignored.");
263
		}
264
	}
265

    
266
	/**
267
	 * Fires a {@link CdmPropertyChangeEvent} with the given object as source.
268
	 *
269
	 * @param object the object on which the property changed
270
	 */
271
	public void firePropertyChangeEvent(Object object){
272
		firePropertyChangeEvent(object, null);
273
	}
274

    
275
	/**
276
	 * Fires a {@link CdmPropertyChangeEvent} with the given object as source also containing the
277
	 * originating event
278
	 *
279
	 * @param object the object on which the property changed
280
	 * @param originatingEvent the originating event
281
	 */
282
	public void firePropertyChangeEvent(Object object, PropertyChangeEvent originatingEvent){
283
		firePropertyChangeEvent(new CdmPropertyChangeEvent(object, originatingEvent));
284
	}
285

    
286

    
287
	/**
288
	 * {@inheritDoc}
289
	 *
290
	 * This method gets called whenever the toolkit this composite was created with gets a property change notification.
291
	 *
292
	 * It is good advice to check whether the PropertyChangeEvent is destined for the implementing composite.
293
	 * Implementations should also check for null PropertyChangeEvents and return immediately in that case.
294
	 * @see eu.etaxonomy.taxeditor.ui.element.ICdmFormElement#propertyChange(org.eclipse.jface.util.PropertyChangeEvent)
295
	 */
296
	@Override
297
    public void propertyChange(PropertyChangeEvent event) {
298
		// implement in subclasses
299
	}
300

    
301
	/** {@inheritDoc} */
302
	@Override
303
    public boolean containsFormElement(ICdmFormElement formElement){
304
		if(formElement == this){
305
			return true;
306
		}else{
307
			for(ICdmFormElement element : getElements()){
308
				boolean contains = element.containsFormElement(formElement);
309
				if(contains == true){
310
					return true;
311
				}
312
			}
313
			return false;
314
		}
315
	}
316

    
317
	@Override
318
    public void refresh() {
319
		// empty default implementation
320
	}
321

    
322

    
323
	/** {@inheritDoc} */
324
	@Override
325
	public void setBackground(Color color) {
326
		for(ICdmFormElement element : getElements()){
327
		    element.setBackground(color);
328
		}
329
	}
330

    
331
	@Override
332
	public void setPersistentBackground(Color color) {
333
		persistentBackgroundColor = color;
334
		setBackground(color);
335
	}
336

    
337
	@Override
338
	public Color getPersistentBackground() {
339
		return persistentBackgroundColor;
340
	}
341

    
342
	public Color getColor(String colorId){
343
		return AbstractUtility.getColor(colorId);
344
	}
345
}
(2-2/53)