EDIT

/**

* Copyright (C) 2007 EDIT

* European Distributed Institute of Taxonomy

* http://www.e-taxonomy.eu

*

* The contents of this file are subject to the Mozilla Public License Version 1.1

* See LICENSE.TXT at the top of this package for the full license terms.

*/

package eu.etaxonomy.taxeditor.ui.dialog.selection;

import java.text.Collator;

import java.util.Comparator;

import java.util.HashSet;

import java.util.Iterator;

import java.util.List;

import java.util.Set;

import java.util.UUID;

import org.eclipse.core.runtime.CoreException;

import org.eclipse.core.runtime.IProgressMonitor;

import org.eclipse.core.runtime.IStatus;

import org.eclipse.core.runtime.OperationCanceledException;

import org.eclipse.jface.dialogs.IDialogSettings;

import org.eclipse.jface.viewers.ILabelProvider;

import org.eclipse.jface.viewers.LabelProvider;

import org.eclipse.jface.viewers.StructuredSelection;

import org.eclipse.jface.window.Window;

import org.eclipse.jface.wizard.WizardDialog;

import org.eclipse.swt.SWT;

import org.eclipse.swt.events.SelectionAdapter;

import org.eclipse.swt.events.SelectionEvent;

import org.eclipse.swt.events.SelectionListener;

import org.eclipse.swt.graphics.Cursor;

import org.eclipse.swt.widgets.Composite;

import org.eclipse.swt.widgets.Control;

import org.eclipse.swt.widgets.Link;

import org.eclipse.swt.widgets.Shell;

import eu.etaxonomy.cdm.api.conversation.ConversationHolder;

import eu.etaxonomy.cdm.api.conversation.IConversationEnabled;

import eu.etaxonomy.cdm.model.common.CdmBase;

import eu.etaxonomy.cdm.model.common.ICdmBase;

import eu.etaxonomy.cdm.model.common.IIdentifiableEntity;

import eu.etaxonomy.cdm.persistence.dto.UuidAndTitleCache;

import eu.etaxonomy.cdm.persistence.hibernate.CdmDataChangeMap;

import eu.etaxonomy.taxeditor.l10n.Messages;

import eu.etaxonomy.taxeditor.model.MessagingUtils;

import eu.etaxonomy.taxeditor.newWizard.AbstractNewEntityWizard;

import eu.etaxonomy.taxeditor.preference.IPreferenceKeys;

import eu.etaxonomy.taxeditor.preference.PreferencesUtil;

import eu.etaxonomy.taxeditor.store.internal.TaxeditorStorePlugin;

/**

 * <p>Abstract AbstractFilteredCdmResourceSelectionDialog class.</p>

 *

 * @author n.hoffmann

 * @created 04.06.2009

 * @version 1.0

 */

public abstract class AbstractFilteredCdmResourceSelectionDialog<T extends ICdmBase> extends

		SearchDialog implements IConversationEnabled {

	private final ConversationHolder conversation;

	protected List<UuidAndTitleCache<T>> model;

	private final Set<T> transientCdmObjects = new HashSet<T>();

	private final String settings;

	protected final int limitOfInitialElements = 100;

	private T selectedObject;

	protected T cdmBaseToBeFiltered;

	/**

	 * <p>Constructor for AbstractFilteredCdmResourceSelectionDialog.</p>

	 *

	 * @param shell a {@link org.eclipse.swt.widgets.Shell} object.

	 * @param conversation

	 * @param title a {@link java.lang.String} object.

	 * @param multi a boolean.

	 * @param settings a {@link java.lang.String} object.

	 * @param cdmObject a T object.

	 * @param <T> a T object.

	 */

	protected AbstractFilteredCdmResourceSelectionDialog(Shell shell, ConversationHolder conversation, String title, boolean multi, String settings, T cdmObject) {

		super(shell, multi);

		setShellStyle(SWT.DIALOG_TRIM);

		setTitle(title);

		setMessage(Messages.SearchDialog_patternLabel);

		this.settings = settings;

		this.conversation = conversation;

		this.cdmBaseToBeFiltered = cdmObject;

		Cursor cursor = shell.getCursor();

		shell.setCursor(shell.getDisplay().getSystemCursor(SWT.CURSOR_WAIT));

		init();

		shell.setCursor(cursor);

		setListLabelProvider(createListLabelProvider());

	}

	/**

	 * By default, we are returning the standard list label provider

	 *

	 * Override in subclasses if you want different behavior

	 *

	 * @return

	 */

	protected ILabelProvider createDetailsLabelProvider() {

		return createListLabelProvider();

	}

	/**

	 *

	 * @return

	 */

	protected ILabelProvider createListLabelProvider() {

		return new FilteredCdmResourceLabelProvider();

	}

	/**

	 * Override in subclasses.

	 * Will run before initModel()

	 */

	protected void init() {

	}

	/**

	 * <p>getSelectionFromDialog</p>

	 *

	 * @param dialog a {@link eu.etaxonomy.taxeditor.ui.dialog.selection.AbstractFilteredCdmResourceSelectionDialog} object.

	 * @param <TYPE> a TYPE object.

	 * @return a TYPE object.

	 */

	protected static <TYPE extends CdmBase> TYPE getSelectionFromDialog(AbstractFilteredCdmResourceSelectionDialog<TYPE> dialog) {

		int result = dialog.open();

		if (result == Window.CANCEL) {

			return null;

		}

		UUID uuid = dialog.getSelectedUuidAndTitleCache().getUuid();

		if(uuid == null){

			return null;

		}

		return dialog.getCdmObjectByUuid(uuid);

	}

	/**

	 * Check if object was created during the life of this dialog. If not,

	 * retrieve it from the CdmStore.

	 *

	 * @param cdmUuid a {@link java.util.UUID} object.

	 * @return a T object.

	 */

	protected T getCdmObjectByUuid(UUID cdmUuid) {

		for (T cdmObject : transientCdmObjects) {

			if (cdmObject.getUuid().equals(cdmUuid)) {

				return cdmObject;

			}

		}

		return getPersistentObject(cdmUuid);

	}

	/**

	 * <p>getPersistentObject</p>

	 *

	 * @param uuid a {@link java.util.UUID} object.

	 * @return a T object.

	 */

	abstract protected T getPersistentObject(UUID uuid);

	/**

	 * <p>isObjectTransient</p>

	 *

	 * @param cdmObject a T object.

	 * @return a boolean.

	 */

	protected boolean isObjectTransient(T cdmObject) {

		return (getPersistentObject(cdmObject.getUuid()) == null);

	}

	/**

	 * <p>getTitle</p>

	 *

	 * @param cdmObject a T object.

	 * @return a {@link java.lang.String} object.

	 */

	protected String getTitle(T cdmObject) {

		if(cdmObject == null){

			return "";

		}

		if (cdmObject instanceof IIdentifiableEntity) {

			return ((IIdentifiableEntity) cdmObject).getTitleCache();

		}

		throw new IllegalArgumentException("Generic method only" +

				" supports cdmObject of type IIdentifiableEntity." +

				" Please implement specific method in subclass.");

	}

	/**

	 * Set the filter input to the Agent's title cache

	 *

	 * @param cdmObject a T object.

	 */

	protected void setPattern(T cdmObject) {

		String pattern = getTitle(cdmObject);

		getSearchField().setText(pattern);

	}

	/* (non-Javadoc)

	* @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog#fillContentProvider(org.eclipse.ui.dialogs.FilteredItemsSelectionDialog.AbstractContentProvider, org.eclipse.ui.dialogs.FilteredItemsSelectionDialog.ItemsFilter, org.eclipse.core.runtime.IProgressMonitor)

	*/

	/** {@inheritDoc} */

	@Override

    protected void fillContentProvider(IProgressMonitor progressMonitor)

		throws CoreException {

		try {

			if(model != null){

			    if (progressMonitor != null){

			        progressMonitor.beginTask("Looking for entities", model.size());

			    }

			    contentProvider.reset();

				Iterator<UuidAndTitleCache<T>> iterator = model.iterator();

				UuidAndTitleCache<T> element;

				while(iterator.hasNext()){

				    element = iterator.next();

				    if (!element.equals(cdmBaseToBeFiltered)){

				        contentProvider.add(element);

				    }

				    if (progressMonitor != null){

    					if (progressMonitor.isCanceled()) {

    						throw new OperationCanceledException();

    					}

    					progressMonitor.worked(1);

				    }

				}

				this.refresh();

			}else{

				MessagingUtils.warn(getClass(), "Model for Filtered Selection is null:" + this.getClass().getSimpleName());

			}

		}

		finally {

		    if (progressMonitor != null) {

                progressMonitor.done();

            }

		}

	}

	/* (non-Javadoc)

	 * @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog#getDialogSettings()

	 */

	/** {@inheritDoc} */

	protected IDialogSettings getDialogSettings() {

		IDialogSettings settings = TaxeditorStorePlugin.getDefault().getDialogSettings().getSection(getSettings());

		if (settings == null) {

			settings = TaxeditorStorePlugin.getDefault().getDialogSettings().addNewSection(getSettings());

		}

		return settings;

	}

	/* (non-Javadoc)

	 * @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog#getElementName(java.lang.Object)

	 */

	/** {@inheritDoc} */

	public String getElementName(Object item) {

		return ((UuidAndTitleCache) item).getTitleCache();

	}

	/* (non-Javadoc)

	 * @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog#getItemsComparator()

	 */

	/** {@inheritDoc} */

	protected Comparator getItemsComparator() {

		return new Comparator<UuidAndTitleCache>() {

			@Override

			public int compare(UuidAndTitleCache entity1,

					UuidAndTitleCache entity2) {

				Collator collator = Collator.getInstance();

				if (entity1.getUuid().equals(entity2.getUuid())){

				    return 0;

				}

				int result = collator.compare(entity1.getTitleCache(), entity2.getTitleCache());

				if (result == 0){

				    result = entity1.getUuid().compareTo(entity2.getUuid());

				}

				return result;

			}

		};

	}

	/**

	 * <p>getSelectedUuidAndTitleCache</p>

	 *

	 * @return a {@link eu.etaxonomy.cdm.model.common.UuidAndTitleCache} object.

	 */

	protected UuidAndTitleCache getSelectedUuidAndTitleCache() {

		Object result = getResult();

		if (result instanceof UuidAndTitleCache){

		    return (UuidAndTitleCache) result;

		}

		return null;

	}

	/**

     * @return

     */

    private Object getResult() {

        StructuredSelection selection = getCurrentSelection();

        return selection.getFirstElement();

    }

    /**

	 * <p>Getter for the field <code>settings</code>.</p>

	 *

	 * @return a {@link java.lang.String} object.

	 */

	public String getSettings()  {

		if(settings == null){

			throw new IllegalStateException("No SETTINGS set.");

		}

		return settings;

	}

	/**

	 * <p>getNewWizardLinkText</p>

	 *

	 * @return a {@link java.lang.String} object.

	 */

	protected abstract String getNewWizardLinkText();

	/**

	 * <p>getNewEntityWizard</p>

	 * @param parameter

	 * @return a {@link eu.etaxonomy.taxeditor.newWizard.AbstractNewEntityWizard} object.

	 */

	protected abstract AbstractNewEntityWizard getNewEntityWizard(String parameter);

	public class FilteredCdmResourceLabelProvider extends LabelProvider {

		@Override

		public String getText(Object element) {

			if (element == null) {

				return null;

			}

			UuidAndTitleCache uuidAndTitleCache = (UuidAndTitleCache) element;

			String titleCache = uuidAndTitleCache.getTitleCache();

			if(PreferencesUtil.getPreferenceStore().getBoolean(IPreferenceKeys.SHOW_ID_IN_ENTITY_SELECTION_DIAOLOG)){

			    titleCache += " ["+uuidAndTitleCache.getId()+"]";

			}

            return titleCache;

		}

	};

	/* (non-Javadoc)

	* @see org.eclipse.ui.dialogs.FilteredItemsSelectionDialog#createExtendedContentArea(org.eclipse.swt.widgets.Composite)

	*/

	/** {@inheritDoc} */

	@Override

    protected Control createExtendedContentArea(Composite parent) {

		String newWizardLinkText = getNewWizardLinkText();

        if(newWizardLinkText != null){

			Link link = new Link(parent, SWT.NONE);

			link.setText(newWizardLinkText);

			link.addSelectionListener(getNewWizardLinkSelectionListener());

			return link;

		}

		return null;

	}

	protected SelectionListener getNewWizardLinkSelectionListener(){

		return new SelectionAdapter() {

			/* (non-Javadoc)

			 * @see org.eclipse.swt.events.SelectionAdapter#widgetSelected(org.eclipse.swt.events.SelectionEvent)

			 */

			@Override

			public void widgetSelected(SelectionEvent e) {

			    AbstractNewEntityWizard wizard = getNewEntityWizard(e.text);

			    if(wizard!=null){

			        wizard.init(null, null);

			        if(wizard.getEntity() != null) {

			            WizardDialog dialog = new WizardDialog(getShell(), wizard);

			            int status = dialog.open();

			            if (status == IStatus.OK) {

			                T entity = (T) wizard.getEntity();

			                refresh();

			                setPattern(entity);

			                if (getConversationHolder() != null){

			                    getConversationHolder().bind();

			                }

			            }

			            //FIXME : Need to make sure this is a stable fix (ticket 3822)

			            if (getConversationHolder() != null){

			                getConversationHolder().commit();

			            }

			        }

			    }

			}

		};

	}

	/**

	 * <p>getConversationHolder</p>

	 *

	 * @return a {@link eu.etaxonomy.cdm.api.conversation.ConversationHolder} object.

	 */

	@Override

	public ConversationHolder getConversationHolder() {

		return conversation;

	}

	/** {@inheritDoc} */

	@Override

	public void update(CdmDataChangeMap changeEvents) {}

	/**

	 * Don't want to add for example a taxon or synonym to itself

	 * so filter the list to remove the taxon in question

	 * (<code>cdmBaseToBeFiltered</code>)

	 * so it is not available in the filtered list.

	 */

	private void filterExcludedObjects() {

		if (model != null && cdmBaseToBeFiltered != null) {

			UuidAndTitleCache uuidAndTitleCacheToRemove = null;

			for (UuidAndTitleCache uuidAndTitleCache : model){

				if ((cdmBaseToBeFiltered.getUuid()).equals(uuidAndTitleCache.getUuid())) {

					uuidAndTitleCacheToRemove = uuidAndTitleCache;

				}

			}

			model.remove(uuidAndTitleCacheToRemove);

		}

	}

}