3 * Copyright (C) 2007 EDIT
4 * European Distributed Institute of Taxonomy
5 * http://www.e-taxonomy.eu
7 * The contents of this file are subject to the Mozilla Public License Version 1.1
8 * See LICENSE.TXT at the top of this package for the full license terms.
11 package eu
.etaxonomy
.taxeditor
.ui
.dialogs
.filteredSelection
;
13 import java
.lang
.reflect
.Field
;
14 import java
.text
.Collator
;
15 import java
.util
.Comparator
;
16 import java
.util
.HashSet
;
17 import java
.util
.List
;
19 import java
.util
.UUID
;
21 import org
.eclipse
.core
.runtime
.CoreException
;
22 import org
.eclipse
.core
.runtime
.IProgressMonitor
;
23 import org
.eclipse
.core
.runtime
.IStatus
;
24 import org
.eclipse
.core
.runtime
.OperationCanceledException
;
25 import org
.eclipse
.core
.runtime
.Status
;
26 import org
.eclipse
.jface
.dialogs
.IDialogSettings
;
27 import org
.eclipse
.jface
.viewers
.ILabelProvider
;
28 import org
.eclipse
.jface
.viewers
.LabelProvider
;
29 import org
.eclipse
.jface
.window
.Window
;
30 import org
.eclipse
.jface
.wizard
.WizardDialog
;
31 import org
.eclipse
.swt
.SWT
;
32 import org
.eclipse
.swt
.events
.SelectionAdapter
;
33 import org
.eclipse
.swt
.events
.SelectionEvent
;
34 import org
.eclipse
.swt
.events
.SelectionListener
;
35 import org
.eclipse
.swt
.widgets
.Composite
;
36 import org
.eclipse
.swt
.widgets
.Control
;
37 import org
.eclipse
.swt
.widgets
.Link
;
38 import org
.eclipse
.swt
.widgets
.Shell
;
39 import org
.eclipse
.swt
.widgets
.Text
;
40 import org
.eclipse
.ui
.IMemento
;
41 import org
.eclipse
.ui
.dialogs
.FilteredItemsSelectionDialog
;
43 import eu
.etaxonomy
.cdm
.api
.conversation
.ConversationHolder
;
44 import eu
.etaxonomy
.cdm
.api
.conversation
.IConversationEnabled
;
45 import eu
.etaxonomy
.cdm
.model
.common
.CdmBase
;
46 import eu
.etaxonomy
.cdm
.model
.common
.ICdmBase
;
47 import eu
.etaxonomy
.cdm
.model
.common
.IIdentifiableEntity
;
48 import eu
.etaxonomy
.cdm
.model
.common
.UuidAndTitleCache
;
49 import eu
.etaxonomy
.cdm
.persistence
.hibernate
.CdmDataChangeMap
;
50 import eu
.etaxonomy
.taxeditor
.newWizard
.AbstractNewEntityWizard
;
51 import eu
.etaxonomy
.taxeditor
.store
.StoreUtil
;
52 import eu
.etaxonomy
.taxeditor
.store
.internal
.TaxeditorStorePlugin
;
55 * <p>Abstract AbstractFilteredCdmResourceSelectionDialog class.</p>
61 public abstract class AbstractFilteredCdmResourceSelectionDialog
<T
extends ICdmBase
> extends
62 FilteredItemsSelectionDialog
implements IConversationEnabled
{
64 private ConversationHolder conversation
;
66 protected List
<UuidAndTitleCache
<T
>> model
;
67 private Set
<T
> transientCdmObjects
= new HashSet
<T
>();
68 private String settings
;
71 * <p>Constructor for AbstractFilteredCdmResourceSelectionDialog.</p>
73 * @param shell a {@link org.eclipse.swt.widgets.Shell} object.
75 * @param title a {@link java.lang.String} object.
76 * @param multi a boolean.
77 * @param settings a {@link java.lang.String} object.
78 * @param cdmObject a T object.
79 * @param <T> a T object.
81 protected AbstractFilteredCdmResourceSelectionDialog(Shell shell
, ConversationHolder conversation
, String title
, boolean multi
, String settings
, T cdmObject
) {
84 setMessage("Use * for wildcard, or ? to see all entries");
85 this.settings
= settings
;
87 this.conversation
= conversation
;
93 String objectTitle
= getTitle(cdmObject
);
94 if (objectTitle
!= null) {
95 setInitialPattern(objectTitle
);
98 setListLabelProvider(createListLabelProvider());
99 setDetailsLabelProvider(createDetailsLabelProvider());
101 setSelectionHistory(new ResourceSelectionHistory());
105 * By default, we are returning the standard list label provider
107 * Override in subclasses if you want different behavior
111 protected ILabelProvider
createDetailsLabelProvider() {
112 return createListLabelProvider();
119 protected ILabelProvider
createListLabelProvider() {
120 return new FilteredCdmResourceLabelProvider();
124 * Override in subclasses.
125 * Will run before initModel()
127 protected void init() {
132 * <p>getSelectionFromDialog</p>
134 * @param dialog a {@link eu.etaxonomy.taxeditor.ui.dialogs.filteredSelection.AbstractFilteredCdmResourceSelectionDialog} object.
135 * @param <TYPE> a TYPE object.
136 * @return a TYPE object.
138 protected static <TYPE
extends CdmBase
> TYPE
getSelectionFromDialog(AbstractFilteredCdmResourceSelectionDialog
<TYPE
> dialog
) {
139 //dialog.setInitialPattern("");
140 int result
= dialog
.open();
142 if (result
== Window
.CANCEL
) {
146 UUID uuid
= dialog
.getSelectedUuidAndTitleCache().getUuid();
150 return dialog
.getCdmObjectByUuid(uuid
);
154 * Check if object was created during the life of this dialog. If not,
155 * retrieve it from the CdmStore.
157 * @param cdmUuid a {@link java.util.UUID} object.
158 * @return a T object.
160 protected T
getCdmObjectByUuid(UUID cdmUuid
) {
161 for (T cdmObject
: transientCdmObjects
) {
162 if (cdmObject
.getUuid().equals(cdmUuid
)) {
166 return getPersistentObject(cdmUuid
);
170 * <p>getPersistentObject</p>
172 * @param uuid a {@link java.util.UUID} object.
173 * @return a T object.
175 abstract protected T
getPersistentObject(UUID uuid
);
180 // protected void addObjectToModel(T cdmObject) {
181 // model.add(new UuidAndTitleCache(cdmObject.getClass(), cdmObject.getUuid(), getTitle(cdmObject)));
182 // transientCdmObjects.add(cdmObject);
186 * <p>isObjectTransient</p>
188 * @param cdmObject a T object.
191 protected boolean isObjectTransient(T cdmObject
) {
192 return (getPersistentObject(cdmObject
.getUuid()) == null);
198 * @param cdmObject a T object.
199 * @return a {@link java.lang.String} object.
201 protected String
getTitle(T cdmObject
) {
202 if(cdmObject
== null){
206 if (cdmObject
instanceof IIdentifiableEntity
) {
207 return ((IIdentifiableEntity
) cdmObject
).getTitleCache();
210 throw new IllegalArgumentException("Generic method only" +
211 " supports cdmObject of type IIdentifiableEntity." +
212 " Please implement specific method in subclass.");
218 public void refresh() {
226 abstract protected void initModel();
229 * @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog#createFilter()
233 protected ItemsFilter
createFilter() {
234 return new ItemsFilter() {
237 * Always returns false to enforce refiltering even if the pattern is equal
240 public boolean equalsFilter(ItemsFilter filter
) {
245 public boolean isConsistentItem(Object item
) {
250 public boolean matchItem(Object item
) {
252 if(item
instanceof UuidAndTitleCache
){
253 text
= ((UuidAndTitleCache
) item
).getTitleCache();
254 }else if(item
instanceof String
){
255 text
= (String
) item
;
257 return text
!= null ?
matches(text
) : false;
265 * Set the filter input to the Agent's title cache
267 * @param cdmObject a T object.
269 protected void setPattern(T cdmObject
) {
270 // FilteredSelection does some very tricky caching to make sure it
271 // runs with high performance.
272 // This works for most use cases, but we want to change the model while the dialog is open
273 // and all the clever caching prevents the content provider from knowing that the model has changed
274 // I am aware, that this is a hack, but the FilteredSelectionDialog API does not offer a convenient
275 // way to solve the problem.
277 Field lastCompletedFilter
= this.getClass().getSuperclass().getSuperclass().getDeclaredField("lastCompletedFilter");
278 lastCompletedFilter
.setAccessible(true);
279 lastCompletedFilter
.set(this, null);
280 } catch (SecurityException e
) {
281 StoreUtil
.error(getClass(), e
);
282 } catch (NoSuchFieldException e
) {
283 StoreUtil
.error(getClass(), e
);
284 } catch (IllegalArgumentException e
) {
285 StoreUtil
.error(getClass(), e
);
286 } catch (IllegalAccessException e
) {
287 StoreUtil
.error(getClass(), e
);
290 // this also is not the nicest way to do it.
291 // I am still amazed, that FilteredSelectionDialog does not offer any methods to change its data
292 // once it was opened. Am I doing it wrong?
293 String pattern
= getTitle(cdmObject
);
294 ((Text
) getPatternControl()).setText(pattern
);
298 * @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog#fillContentProvider(org.eclipse.ui.dialogs.FilteredItemsSelectionDialog.AbstractContentProvider, org.eclipse.ui.dialogs.FilteredItemsSelectionDialog.ItemsFilter, org.eclipse.core.runtime.IProgressMonitor)
302 protected void fillContentProvider(AbstractContentProvider contentProvider
,
303 ItemsFilter itemsFilter
, IProgressMonitor progressMonitor
)
304 throws CoreException
{
307 progressMonitor
.beginTask("Looking for entities", model
.size());
308 for(UuidAndTitleCache
<T
> element
: model
){
309 contentProvider
.add(element
, itemsFilter
);
310 if (progressMonitor
.isCanceled()) {
311 throw new OperationCanceledException();
313 progressMonitor
.worked(1);
316 StoreUtil
.warn(getClass(), "Model for Filtered Selection is null:" + this.getClass().getSimpleName());
320 progressMonitor
.done();
325 * @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog#getDialogSettings()
329 protected IDialogSettings
getDialogSettings() {
330 IDialogSettings settings
= TaxeditorStorePlugin
.getDefault().getDialogSettings().getSection(getSettings());
332 if (settings
== null) {
333 settings
= TaxeditorStorePlugin
.getDefault().getDialogSettings().addNewSection(getSettings());
339 * @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog#getElementName(java.lang.Object)
343 public String
getElementName(Object item
) {
344 return ((UuidAndTitleCache
) item
).getTitleCache();
348 * @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog#getItemsComparator()
352 protected Comparator
getItemsComparator() {
353 return new Comparator
<UuidAndTitleCache
>() {
354 public int compare(UuidAndTitleCache entity1
,
355 UuidAndTitleCache entity2
) {
356 Collator collator
= Collator
.getInstance();
357 return collator
.compare(entity1
.getTitleCache(), entity2
.getTitleCache());
363 * @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog#validateItem(java.lang.Object)
367 protected IStatus
validateItem(Object item
) {
368 return Status
.OK_STATUS
;
372 * <p>getSelectedUuidAndTitleCache</p>
374 * @return a {@link eu.etaxonomy.cdm.model.common.UuidAndTitleCache} object.
376 protected UuidAndTitleCache
getSelectedUuidAndTitleCache() {
377 Object
[] result
= getResult();
378 return result
[0] == null ?
null : (UuidAndTitleCache
) result
[0];
382 * <p>Getter for the field <code>settings</code>.</p>
384 * @return a {@link java.lang.String} object.
386 public String
getSettings() {
387 if(settings
== null){
388 throw new IllegalStateException("No SETTINGS set.");
396 * @created Oct 19, 2009
399 private class ResourceSelectionHistory
extends SelectionHistory
{
401 * @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog.SelectionHistory#restoreItemFromMemento(org.eclipse.ui.IMemento)
403 protected Object
restoreItemFromMemento(IMemento element
) {
404 return element
.getString("resource"); //$NON-NLS-1$
407 * @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog.SelectionHistory#storeItemToMemento(java.lang.Object,
408 * org.eclipse.ui.IMemento)
410 protected void storeItemToMemento(Object item
, IMemento element
) {
411 element
.putString("resource", item
.toString()); //$NON-NLS-1$
416 * <p>getNewWizardLinkText</p>
418 * @return a {@link java.lang.String} object.
420 protected abstract String
getNewWizardLinkText();
423 * <p>getNewEntityWizard</p>
425 * @return a {@link eu.etaxonomy.taxeditor.newWizard.AbstractNewEntityWizard} object.
427 protected abstract AbstractNewEntityWizard
getNewEntityWizard(String parameter
);
429 public class FilteredCdmResourceLabelProvider
extends LabelProvider
{
430 public String
getText(Object element
) {
431 if (element
== null) {
434 return ((UuidAndTitleCache
) element
).getTitleCache();
439 * @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog#createExtendedContentArea(org.eclipse.swt.widgets.Composite)
443 protected Control
createExtendedContentArea(Composite parent
) {
444 if(getNewWizardLinkText() != null){
445 Link link
= new Link(parent
, SWT
.NONE
);
446 link
.setText(getNewWizardLinkText());
447 link
.addSelectionListener(getNewWizardLinkSelectionListener());
453 protected SelectionListener
getNewWizardLinkSelectionListener(){
454 return new SelectionAdapter() {
457 * @see org.eclipse.swt.events.SelectionAdapter#widgetSelected(org.eclipse.swt.events.SelectionEvent)
460 public void widgetSelected(SelectionEvent e
) {
462 AbstractNewEntityWizard wizard
= getNewEntityWizard(e
.text
);
463 wizard
.init(null, null);
464 WizardDialog dialog
= new WizardDialog(getShell(), wizard
);
465 int status
= dialog
.open();
467 if (status
== IStatus
.OK
) {
469 T entity
= (T
) wizard
.getEntity();
471 // addObjectToModel(teamOrPerson);
474 getConversationHolder().bind();
481 * <p>getConversationHolder</p>
483 * @return a {@link eu.etaxonomy.cdm.api.conversation.ConversationHolder} object.
485 public ConversationHolder
getConversationHolder() {
490 public void update(CdmDataChangeMap changeEvents
) {}