Project

General

Profile

Download (19.8 KB) Statistics
| Branch: | Tag: | Revision:
1
/**
2
 * Copyright (C) 2007 EDIT
3
 * European Distributed Institute of Taxonomy
4
 * http://www.e-taxonomy.eu
5
 *
6
 * The contents of this file are subject to the Mozilla Public License Version 1.1
7
 * See LICENSE.TXT at the top of this package for the full license terms.
8
 */
9

    
10
package eu.etaxonomy.taxeditor.ui.section.reference;
11

    
12

    
13

    
14
import java.util.ArrayList;
15
import java.util.Arrays;
16
import java.util.List;
17

    
18
import org.eclipse.swt.SWT;
19
import org.joda.time.DateTime;
20

    
21
import eu.etaxonomy.cdm.model.agent.AgentBase;
22
import eu.etaxonomy.cdm.model.agent.Institution;
23
import eu.etaxonomy.cdm.model.agent.TeamOrPersonBase;
24
import eu.etaxonomy.cdm.model.reference.Reference;
25
import eu.etaxonomy.cdm.model.reference.ReferenceFactory;
26
import eu.etaxonomy.cdm.model.reference.ReferenceType;
27
import eu.etaxonomy.taxeditor.store.StoreUtil;
28
import eu.etaxonomy.taxeditor.ui.combo.EnumComboElement;
29
import eu.etaxonomy.taxeditor.ui.element.CdmFormFactory;
30
import eu.etaxonomy.taxeditor.ui.element.CdmPropertyChangeEvent;
31
import eu.etaxonomy.taxeditor.ui.element.DoiWithLabelElement;
32
import eu.etaxonomy.taxeditor.ui.element.ICdmFormElement;
33
import eu.etaxonomy.taxeditor.ui.element.IErrorIntolerableElement;
34
import eu.etaxonomy.taxeditor.ui.element.IExceptionHandler;
35
import eu.etaxonomy.taxeditor.ui.element.TextWithLabelElement;
36
import eu.etaxonomy.taxeditor.ui.element.ToggleableTextElement;
37
import eu.etaxonomy.taxeditor.ui.element.UriWithLabelElement;
38
import eu.etaxonomy.taxeditor.ui.element.VerbatimTimePeriodElement;
39
import eu.etaxonomy.taxeditor.ui.mvc.element.DateElement;
40
import eu.etaxonomy.taxeditor.ui.section.AbstractIdentifiableEntityDetailElement;
41
import eu.etaxonomy.taxeditor.ui.selection.EntitySelectionElement;
42

    
43
/**
44
 * <p>
45
 * ReferenceBaseDetailElement class.
46
 * </p>
47
 *
48
 * @author n.hoffmann
49
 * @created Mar 2, 2010
50
 */
51
public class ReferenceDetailElement extends AbstractIdentifiableEntityDetailElement<Reference>
52
		implements IErrorIntolerableElement, IExceptionHandler {
53

    
54

    
55

    
56
    private ToggleableTextElement toggleableAbbrevCache;
57

    
58
	private TextWithLabelElement text_edition;
59
	private TextWithLabelElement text_editor;
60
	private TextWithLabelElement text_isbn;
61
	private TextWithLabelElement text_issn;
62
	private TextWithLabelElement text_organisation;
63
	private TextWithLabelElement text_pages;
64
	private TextWithLabelElement text_placePublished;
65
	private TextWithLabelElement text_publisher;
66
	private TextWithLabelElement text_referenceAbstract;
67
	private TextWithLabelElement text_series;
68
//	private TextWithLabelElement text_seriesPart;
69
	private TextWithLabelElement text_volume;
70
	private TextWithLabelElement text_abbrevTitle;
71
	private TextWithLabelElement text_title;
72
	private DoiWithLabelElement text_doi;
73
	private UriWithLabelElement text_uri;
74
	private DateElement text_accessed;
75
	private EntitySelectionElement<AgentBase> selection_authorTeam;
76
	private VerbatimTimePeriodElement element_timePeriod;
77
	private EntitySelectionElement<Reference> selection_inReference;
78
	private EntitySelectionElement<Institution> selection_institution;
79
	private EnumComboElement<ReferenceType> combo_referenceType;
80

    
81
	private EntitySelectionElement<Reference> selection_inSeries;
82
	private boolean isWizard;
83

    
84
	/**
85
	 * <p>
86
	 * Constructor for ReferenceBaseDetailElement.
87
	 * </p>
88
	 *
89
	 * @param cdmFormFactory
90
	 *            a {@link eu.etaxonomy.taxeditor.ui.element.CdmFormFactory}
91
	 *            object.
92
	 * @param formElement
93
	 *            a {@link eu.etaxonomy.taxeditor.ui.element.ICdmFormElement}
94
	 *            object.
95
	 * @param style
96
	 *            a int.
97
	 */
98
	public ReferenceDetailElement(CdmFormFactory cdmFormFactory,
99
			ICdmFormElement formElement, int style, boolean isWizard) {
100
		super(cdmFormFactory, formElement);
101
		this.isWizard = isWizard;
102
	}
103

    
104

    
105
	/** {@inheritDoc} */
106
	@Override
107
	protected void createControls(ICdmFormElement formElement,
108
			Reference entity, int style) {
109
		setWarnForReferencingObjects(formElement);
110
		toggleable_cache = formFactory.createToggleableTextField(formElement,
111
				"Reference Cache", entity.getTitleCache(),
112
				entity.isProtectedTitleCache(), style);
113

    
114
		toggleableAbbrevCache = formFactory.createToggleableTextField(formElement,
115
		        "Nomencl. Cache", entity.getAbbrevTitleCache(),
116
		        entity.isProtectedAbbrevTitleCache(), style);
117

    
118
		combo_referenceType = formFactory.createEnumComboElement(ReferenceType.class,
119
						formElement, style);
120

    
121
		combo_referenceType.setSelection(entity.getType());
122

    
123
		// title
124
		text_title = formFactory.createTextWithLabelElement(formElement,
125
				"Title", entity.getTitle(), style);
126
		// abbreviated title
127
		text_abbrevTitle = formFactory.createTextWithLabelElement(formElement,
128
		        "Nomencl. Title", entity.getAbbrevTitle(), style);
129

    
130
		// author team
131
		selection_authorTeam = formFactory
132
				.createSelectionElement(AgentBase.class,//getConversationHolder(),
133
				        formElement, "Author",
134
						entity.getAuthorship(),
135
						EntitySelectionElement.ALL, style);
136

    
137
		ReferenceType referenceType = entity.getType();
138

    
139
		if (referenceType != null) {
140

    
141
			createInReferenceByType(this, referenceType, entity, SWT.NULL);
142

    
143
			if (referenceType.equals(ReferenceType.Generic)) {
144
				createGenericControls(this, entity, SWT.NULL);
145
				createPublicationControls(this, referenceType, entity, SWT.NULL);
146

    
147
			} else {
148
				if (referenceType.isPrintedUnit()) {
149
					createPrintedUnitControls(this, referenceType, entity,
150
							SWT.NULL);
151
				}
152
				if (referenceType.isPublication()) {
153
					createPublicationControls(this, referenceType, entity,
154
							SWT.NULL);
155
				}
156
				if (referenceType.isVolumeReference()) {
157
					createVolumeControls(this, entity, SWT.NULL);
158
				}
159
				if (referenceType.isSection()) {
160
					createSectionControls(this, entity, SWT.NULL);
161
				}
162

    
163
			}
164
		}
165

    
166
		// date published
167
		element_timePeriod = formFactory.createVerbatimTimePeriodElement(formElement,
168
				"Date Published", entity.getDatePublished(), style);
169

    
170
		if(referenceType != null && (!referenceType.equals(ReferenceType.Journal) && !referenceType.equals(ReferenceType.PrintSeries) && !referenceType.equals(ReferenceType.PersonalCommunication))) {
171
            text_doi = formFactory.createDoiWithLabelElement(formElement, "DOI", entity.getDoi(), style);
172
        }
173
		createUriAndAbstract(this, entity, SWT.NULL);
174

    
175
		handleToggleableAbbrevTitleField();
176
		handleToggleableCacheField();
177
	}
178

    
179
	private void createWebPageControls(ReferenceDetailElement referenceDetailElement, Reference reference, int style) {
180
		DateTime accessed = reference.getAccessed();
181

    
182
		 text_accessed = formFactory.createDateElement(referenceDetailElement, "Accessed", accessed, style, false);
183

    
184
	}
185

    
186
	/*
187
	 * (non-Javadoc)
188
	 *
189
	 * @see
190
	 * eu.etaxonomy.taxeditor.forms.section.cdmdetail.AbstractCdmDetailComposite
191
	 * #updateContent()
192
	 */
193
	/** {@inheritDoc} */
194
	@Override
195
	protected void updateContent() {
196
		if (getEntity() == null) {
197
			setEntity(ReferenceFactory.newGeneric());
198
		}
199

    
200
		super.updateContent();
201

    
202
		// enable elements according to state of cache protection
203
		// setEnabled(getEntity().isProtectedTitleCache(), Arrays.asList(new
204
		// Object[]{text_cache}));
205
		toggleable_cache.setEnabled(getEntity().isProtectedTitleCache());
206
		toggleableAbbrevCache.setEnabled(getEntity().isProtectedAbbrevTitleCache());
207
		setIrrelevantReferenceDetail(false);
208
		setIrrelevantReferenceDetail(true);
209
	}
210

    
211
	/**
212
	 * Creates an in reference for reference types that do hav this.
213
	 *
214
	 * @param element
215
	 * @param referenceType
216
	 * @param reference
217
	 * @param style
218
	 */
219
	private void createInReferenceByType(ICdmFormElement element,
220
			ReferenceType referenceType, Reference reference, int style) {
221
		boolean createInReferenceWidget = true;
222
		String label = "In Reference";
223

    
224
		switch (referenceType) {
225
		case Generic:
226
			break;
227
		case Section:
228
		    break;
229
		case BookSection:
230
			label = "Book";
231
			break;
232
		case InProceedings:
233
			label = "Print Series";
234
			break;
235
		case Article:
236
			label = "Journal";
237
			break;
238
		case WebPage:
239
			break;
240
		default:
241
			createInReferenceWidget = false;
242
		}
243

    
244
		if (createInReferenceWidget) {
245
			selection_inReference = formFactory
246
					.createSelectionElement(Reference.class,//getConversationHolder(),
247
					        element, label,
248
							reference.getInReference(),
249
							EntitySelectionElement.ALL, style);
250
		}
251
	}
252

    
253
	/**
254
	 * Creates additional controls to edit a generic reference
255
	 *
256
	 * @param element
257
	 * @param reference
258
	 * @param listener
259
	 * @param style
260
	 */
261
	private void createGenericControls(ICdmFormElement element,
262
			Reference reference, int style) {
263

    
264
		// editor
265
		text_editor = formFactory.createTextWithLabelElement(element, "Editor",
266
				reference.getEditor(), style);
267

    
268
		// series
269
		text_series = formFactory.createTextWithLabelElement(element, "Series",
270
				reference.getSeriesPart(), style);
271

    
272
		// volume
273
		text_volume = formFactory.createTextWithLabelElement(element, "Volume",
274
				reference.getVolume(), style);
275

    
276
		// pages
277
		text_pages = formFactory.createTextWithLabelElement(element, "Pages",
278
				reference.getPages(), style);
279

    
280

    
281
	}
282

    
283
	/**
284
	 * Creates additional controls to edit a publication
285
	 *
286
	 * @param element
287
	 * @param reference
288
	 * @param listener
289
	 * @param style
290
	 */
291
	private void createPublicationControls(ICdmFormElement element,
292
			ReferenceType referenceType, Reference reference, int style) {
293

    
294
		// placePublished
295
		text_placePublished = formFactory.createTextWithLabelElement(element,
296
				"Place Published", reference.getPlacePublished(), style);
297

    
298
		// publisher
299
		text_publisher = formFactory.createTextWithLabelElement(element,
300
				"Publisher", reference.getPublisher(), style);
301

    
302
		if (referenceType.equals(ReferenceType.Journal)) {
303
			// issn
304
			text_issn = formFactory.createTextWithLabelElement(element, "ISSN",
305
					reference.getIssn(), style);
306
		}
307

    
308
		if (referenceType.equals(ReferenceType.Report)) {
309
			// institution
310
			selection_institution = formFactory
311
					.createSelectionElement(Institution.class,//getConversationHolder(),
312
					        element, "Institution",
313
							reference.getInstitution(),
314
							EntitySelectionElement.ALL, style);
315
		}
316

    
317
		if (referenceType.equals(ReferenceType.Thesis)) {
318
			// school
319
			selection_institution = formFactory
320
					.createSelectionElement(Institution.class,//getConversationHolder(),
321
					        element, "School",
322
							reference.getSchool(),
323
							EntitySelectionElement.ALL, style);
324
		}
325

    
326
		if (referenceType.equals(ReferenceType.Proceedings)) {
327
			// organization
328
			text_organisation = formFactory.createTextWithLabelElement(element,
329
					"Organisation", reference.getOrganization(), style);
330
		}
331
	}
332

    
333
	/**
334
	 * Creates additional controls to edit a section
335
	 *
336
	 * @param element
337
	 * @param reference
338
	 * @param style
339
	 */
340
	private void createSectionControls(ICdmFormElement element,
341
			Reference reference, int style) {
342
		// pages
343
		text_pages = formFactory.createTextWithLabelElement(element, "Pages",
344
				reference.getPages(), style);
345
	}
346

    
347
	/**
348
	 * Creates additional controls to edit a volume
349
	 *
350
	 * @param element
351
	 * @param reference
352
	 * @param style
353
	 */
354
	private void createVolumeControls(ICdmFormElement element,
355
			Reference reference, int style) {
356

    
357
		text_volume = formFactory.createTextWithLabelElement(element, "Volume",
358
				reference.getVolume(), style);
359

    
360
		text_series = formFactory.createTextWithLabelElement(element, "Series",
361
				reference.getSeriesPart(), style);
362
	}
363

    
364
	/**
365
	 *
366
	 * @param element
367
	 * @param referenceType
368
	 * @param reference
369
	 * @param style
370
	 */
371
	private void createPrintedUnitControls(ICdmFormElement element,
372
			ReferenceType referenceType, Reference reference, int style) {
373
		// in series
374
		selection_inSeries = formFactory
375
				.createSelectionElement(Reference.class,//getConversationHolder(),
376
				        element, "In Series",
377
						(Reference) reference.getInSeries(),
378
						EntitySelectionElement.ALL, style);
379

    
380
		// editor
381
		text_editor = formFactory.createTextWithLabelElement(element, "Editor",
382
				reference.getEditor(), style);
383

    
384
		/* series part
385
		text_seriesPart = formFactory.createTextWithLabelElement(element,
386
				"Series", reference.getSeriesPart(), style);
387
*/
388
		if (referenceType.equals(ReferenceType.Book)) {
389
			// edition
390
			text_edition = formFactory.createTextWithLabelElement(element,
391
					"Edition", reference.getEdition(), style);
392

    
393
			// isbn
394
			text_isbn = formFactory.createTextWithLabelElement(element, "ISBN",
395
					reference.getIsbn(), style);
396
		}
397
	}
398

    
399
	private void createUriAndAbstract(ICdmFormElement element,
400
			Reference reference, int style) {
401
		// uri
402
		text_uri = formFactory.createUriWithLabelElement(element, "URI",
403
				reference.getUri(), style);
404
		if (reference.getType().equals(ReferenceType.WebPage)){
405
			createWebPageControls(this, reference, style);
406
		}
407
		// abstract
408
		text_referenceAbstract = formFactory.createMultiLineTextWithLabel(
409
				element, "Reference Abstract", 100, style);
410
		text_referenceAbstract.setText(reference.getReferenceAbstract());
411
	}
412

    
413
	/** {@inheritDoc} */
414
	@Override
415
	public void handleEvent(Object eventSource) {
416
		if (eventSource == combo_referenceType) {
417
			getEntity().setType(combo_referenceType.getSelection());
418
			updateContent();
419
	        //this is needed for the "new" wizards in order to redraw correctly
420
			StoreUtil.reflowParentScrolledForm(getLayoutComposite(), true);
421
		} else if (eventSource == element_timePeriod) {
422
			getEntity().setDatePublished(element_timePeriod.getTimePeriod());
423
			clearException();
424
		}
425
		// selections
426
		else if (eventSource == selection_authorTeam) {
427
			getEntity().setAuthorship(
428
					(TeamOrPersonBase) selection_authorTeam.getEntity());
429
		} else if (eventSource == selection_inReference) {
430
			getEntity().setInReference(selection_inReference.getSelection());
431
		} else if (eventSource == selection_inSeries) {
432
			getEntity().setInReference(selection_inSeries.getSelection());
433
		} else if (eventSource == selection_institution) {
434
			getEntity().setInstitution(selection_institution.getSelection());
435
		}
436

    
437
		// textfields
438
		else if (eventSource == toggleable_cache) {
439
			handleToggleableCacheField();
440
		}
441
		else if (eventSource == toggleableAbbrevCache) {
442
		    handleToggleableAbbrevTitleField();
443
		} else if (eventSource == text_edition) {
444
			getEntity().setEdition(text_edition.getText());
445
		} else if (eventSource == text_editor) {
446
			getEntity().setEditor(text_editor.getText());
447
		} else if (eventSource == text_isbn) {
448
			getEntity().setIsbn(text_isbn.getText());
449
		} else if (eventSource == text_issn) {
450
			getEntity().setIssn(text_issn.getText());
451
		} else if (eventSource == text_organisation) {
452
			getEntity().setOrganization(text_organisation.getText());
453
		} else if (eventSource == text_pages) {
454
			getEntity().setPages(text_pages.getText());
455
		} else if (eventSource == text_placePublished) {
456
			getEntity().setPlacePublished(text_placePublished.getText());
457
		} else if (eventSource == text_publisher) {
458
			getEntity().setPublisher(text_publisher.getText());
459
		} else if (eventSource == text_referenceAbstract) {
460
			getEntity().setReferenceAbstract(text_referenceAbstract.getText());
461
		} else if (eventSource == text_series) {
462
			getEntity().setSeriesPart(text_series.getText());
463
		} else if (eventSource == text_title ) {
464
			getEntity().setTitle(text_title.getText());
465
			if (!toggleable_cache.isEnabled()){
466
			    toggleable_cache.setText(getEntity().generateTitle());
467
			}
468
		} else if (eventSource == text_abbrevTitle ) {
469
		    getEntity().setAbbrevTitle(text_abbrevTitle.getText());
470
		    if (!toggleableAbbrevCache.isEnabled()){
471
		        toggleableAbbrevCache.setText(getEntity().generateAbbrevTitle());
472
		    }
473
		} else if (eventSource == text_uri) {
474
			getEntity().setUri(text_uri.parseText());
475
		} else if (eventSource == text_volume) {
476
			getEntity().setVolume(text_volume.getText());
477
		}else if (eventSource == text_doi) {
478
            getEntity().setDoi(text_doi.parseText());
479
        }else if (eventSource == text_accessed.getController()) {
480
            getEntity().setAccessed(text_accessed.getController().getDateTime());
481
        }
482

    
483
		if (eventSource != text_title && eventSource != text_abbrevTitle) {
484
		    // set abbrev title cache to null to force new generation
485
		    // for the standard title cache this is done by a PropertyChangeListener registered
486
		    // in IdentifiableEntity.initListeners()
487
		    if(!getEntity().isProtectedAbbrevTitleCache()){
488
		        getEntity().setAbbrevTitleCache(null, getEntity().isProtectedAbbrevTitleCache());
489
		    }
490
		    if(!getEntity().isProtectedTitleCache()){
491
                getEntity().setTitleCache(null, getEntity().isProtectedTitleCache());
492
            }
493

    
494
			toggleable_cache.setText(getEntity().getTitleCache());
495
			toggleableAbbrevCache.setText(getEntity().getAbbrevTitleCache());
496
		}
497

    
498
		firePropertyChangeEvent(new CdmPropertyChangeEvent(this, null));
499
	}
500

    
501

    
502
    @Override
503
    public void updateToggleableCacheField() {
504
        if (!getEntity().isProtectedTitleCache()) {
505
            toggleable_cache.setText(getEntity().generateTitle());
506
        }
507
        if (!getEntity().isProtectedAbbrevTitleCache()) {
508
            toggleableAbbrevCache.setText(getEntity().generateAbbrevTitle());
509
        }
510
    }
511

    
512
    protected void handleToggleableAbbrevTitleField() {
513
        boolean pushedAbbrevState = toggleableAbbrevCache.getState();
514
        getEntity().setAbbrevTitleCache(toggleableAbbrevCache.getText(), pushedAbbrevState);
515
        setIrrelevantReferenceDetail(true);
516
        updateToggleableCacheField();
517
    }
518

    
519
	/*
520
	 * (non-Javadoc)
521
	 *
522
	 * @see
523
	 * eu.etaxonomy.taxeditor.section.AbstractCdmDetailElement#handleException
524
	 * (eu.etaxonomy.taxeditor.forms.CdmPropertyChangeEvent)
525
	 */
526
	/** {@inheritDoc} */
527
	@Override
528
	public void handleException(CdmPropertyChangeEvent event) {
529
		exceptionOccurred(event);
530
	}
531

    
532
	/*
533
	 * (non-Javadoc)
534
	 *
535
	 * @see eu.etaxonomy.taxeditor.forms.IExceptionHandler#clearException()
536
	 */
537
	/** {@inheritDoc} */
538
	@Override
539
	public void clearException() {
540
		exceptionOccurred(null);
541
	}
542

    
543
	private final List<IExceptionHandler> exceptionHandlers = new ArrayList<IExceptionHandler>();
544

    
545
	/*
546
	 * (non-Javadoc)
547
	 *
548
	 * @see
549
	 * eu.etaxonomy.taxeditor.forms.IErrorIntolerableElement#addExceptionHandler
550
	 * (eu.etaxonomy.taxeditor.forms.IExceptionHandler)
551
	 */
552
	/** {@inheritDoc} */
553
	@Override
554
	public void addExceptionHandler(IExceptionHandler handler) {
555
		exceptionHandlers.add(handler);
556
	}
557

    
558
	/*
559
	 * (non-Javadoc)
560
	 *
561
	 * @see
562
	 * eu.etaxonomy.taxeditor.forms.IErrorIntolerableElement#removeExceptionHandler
563
	 * (eu.etaxonomy.taxeditor.forms.IExceptionHandler)
564
	 */
565
	/** {@inheritDoc} */
566
	@Override
567
	public void removeExceptionHandler(IExceptionHandler handler) {
568
		exceptionHandlers.remove(handler);
569
	}
570

    
571
	/*
572
	 * (non-Javadoc)
573
	 *
574
	 * @see
575
	 * eu.etaxonomy.taxeditor.forms.IErrorIntolerableElement#exceptionOccurred
576
	 * (eu.etaxonomy.taxeditor.forms.CdmPropertyChangeEvent)
577
	 */
578
	/** {@inheritDoc} */
579
	@Override
580
	public void exceptionOccurred(CdmPropertyChangeEvent event) {
581
		for (IExceptionHandler handler : exceptionHandlers) {
582
			if (event == null) {
583
				handler.clearException();
584
			} else {
585
				handler.handleException(event);
586
			}
587
		}
588
	}
589

    
590
	@Override
591
	protected void handleToggleableCacheField() {
592

    
593
		boolean pushedState = toggleable_cache.getState();
594
        getEntity().setTitleCache(toggleable_cache.getText(), pushedState);
595
        setIrrelevantReferenceDetail(false);
596
        updateToggleableCacheField();
597
    }
598

    
599
	protected void setIrrelevantReferenceDetail(boolean abbrev){
600

    
601
		List<Object> except = new ArrayList();
602

    
603
	    except.addAll( Arrays.asList(new Object[] { toggleable_cache, toggleableAbbrevCache, text_editor, text_isbn, text_issn, text_organisation, text_pages, text_placePublished, text_publisher, text_referenceAbstract,  text_uri, selection_institution}));
604
	    boolean pushedState;
605
	    if (abbrev){
606
	      except.add(text_title);
607
	    } else{
608
	      except.add(text_abbrevTitle);
609
	    }
610
	    pushedState = toggleableAbbrevCache.getState() || toggleable_cache.getState();
611

    
612
	    switch( getEntity().getType()){
613
	    case Journal:
614
	    	except.add(element_timePeriod);
615
	    	break;
616
	    case Book:
617
	    	except.remove(text_series);
618
	    	except.remove(text_edition);
619
	    	break;
620
	    default:
621
	    	break;
622
	    }
623

    
624
	    setIrrelevant(pushedState, except);
625
	    text_title.setIrrelevant(toggleable_cache.getState());
626
	    text_abbrevTitle.setIrrelevant(toggleableAbbrevCache.getState());
627
	}
628

    
629

    
630

    
631

    
632
}
(3-3/6)