EDIT

/**

 * 

 */

package eu.etaxonomy.taxeditor.ui.selection;

import org.eclipse.core.runtime.IStatus;

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.Color;

import org.eclipse.swt.widgets.Button;

import org.eclipse.swt.widgets.Composite;

import org.eclipse.swt.widgets.Label;

import org.eclipse.swt.widgets.Shell;

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

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

import eu.etaxonomy.cdm.common.CdmUtils;

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

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

import eu.etaxonomy.taxeditor.model.ImageResources;

import eu.etaxonomy.taxeditor.preference.Resources;

import eu.etaxonomy.taxeditor.store.StoreUtil;

import eu.etaxonomy.taxeditor.ui.element.AbstractCdmFormElement;

import eu.etaxonomy.taxeditor.ui.element.CdmFormFactory;

import eu.etaxonomy.taxeditor.ui.element.CdmPropertyChangeEvent;

import eu.etaxonomy.taxeditor.ui.element.ICdmFormElement;

import eu.etaxonomy.taxeditor.ui.element.IEnableableFormElement;

import eu.etaxonomy.taxeditor.ui.element.IEntityElement;

import eu.etaxonomy.taxeditor.ui.element.ILabeledElement;

import eu.etaxonomy.taxeditor.ui.element.ISelectable;

import eu.etaxonomy.taxeditor.ui.element.ISelectableElement;

import eu.etaxonomy.taxeditor.ui.element.SelectionArbitrator;

/**

 * <p>

 * Abstract AbstractSelectionElement class.

 * </p>

 * 

 * @author n.hoffmann

 * @created Nov 17, 2009

 * @version 1.0

 * @param <T>

 */

public abstract class AbstractSelectionElement<T> extends

		AbstractCdmFormElement implements SelectionListener,

		IEnableableFormElement, ISelectableElement, IEntityElement<T>,

		ILabeledElement, IConversationEnabled, ISelectable {

	/**

	 * bitmask to set

	 */

	public static final int NOTHING = 0; // 000

	public static final int EDITABLE = 1 << 0; // 001

	public static final int DELETABLE = 1 << 1; // 010

	public static final int SELECTABLE = 1 << 2; // 100

	public static final int ALL = (int) Math.pow(2, 3); // 111

	protected T entity;

	protected Label label;

	protected Label text;

	protected Button button_selection;

	private SelectionArbitrator selectionArbitrator;

	protected Button button_edit;

	private final String labelString;

	private Composite selectableComposite;

	private Button button_remove;

	private final boolean isEditable;

	private final boolean isDeletable;

	private final ConversationHolder conversation;

	/**

	 * <p>

	 * Constructor for AbstractSelectionElement.

	 * </p>

	 * 

	 * @param formFactory

	 *            a {@link eu.etaxonomy.taxeditor.ui.element.CdmFormFactory}

	 *            object.

	 * @param conversation

	 *            TODO

	 * @param parentElement

	 *            a {@link eu.etaxonomy.taxeditor.ui.element.ICdmFormElement}

	 *            object.

	 * @param labelString

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

	 * @param entity

	 *            a T object.

	 * @param isEditable

	 *            a boolean.

	 * @param isSelectable

	 *            a boolean.

	 * @param isDeletable

	 *            a boolean.

	 * @param style

	 *            a int.

	 * @param <T>

	 *            a T object.

	 */

	public AbstractSelectionElement(CdmFormFactory formFactory,

			ConversationHolder conversation, ICdmFormElement parentElement,

			String labelString, T entity, int mode, int style) {

		super(formFactory, parentElement);

		this.isEditable = (mode & EDITABLE) == EDITABLE;

		this.isDeletable = (mode & DELETABLE) == DELETABLE;

		this.labelString = labelString;

		this.conversation = conversation;

		if (((mode & SELECTABLE) == SELECTABLE)

				&& formFactory.getSelectionProvider() != null) {

			selectionArbitrator = formFactory.createSelectionArbitrator(this);

		}

		createControls(getLayoutComposite(), SWT.NULL);

		setEntity(entity);

	}

	private void createControls(Composite parent, int style) {

		label = formFactory.createLabel(getLayoutComposite(), labelString,

				SWT.NULL);

		addControl(label);

		selectableComposite = formFactory.createComposite(getLayoutComposite());

		int columns = 2;

		if (isEditable) {

			columns += 1;

		}

		if (isDeletable) {

			columns += 1;

		}

		selectableComposite.setLayout(CdmFormFactory.LAYOUT(columns, false));

		selectableComposite.setLayoutData(CdmFormFactory.FILL_HORIZONTALLY());

		addControl(selectableComposite);

		text = formFactory.createLabel(selectableComposite, null, SWT.WRAP);

		addControl(text);

		text.setLayoutData(CdmFormFactory.FILL_HORIZONTALLY());

		text.setBackground(StoreUtil

				.getColor(Resources.COLOR_TEXT_DISABLED_BACKGROUND));

		button_selection = formFactory.createButton(selectableComposite, null,

				SWT.PUSH);

		button_selection.setImage(ImageResources

				.getImage(ImageResources.BROWSE_ICON));

		button_selection.setToolTipText("Browse existing");

		addControl(button_selection);

		button_selection.addSelectionListener(this);

		if (isEditable) {

			button_edit = formFactory.createButton(selectableComposite, null,

					SWT.PUSH);

			button_edit.setImage(ImageResources

					.getImage(ImageResources.EDIT_ICON));

			button_edit.setToolTipText("Edit");

			addControl(button_edit);

			button_edit.addSelectionListener(new EditListener(this));

		}

		if (isDeletable) {

			button_remove = formFactory.createButton(selectableComposite, null,

					SWT.PUSH);

			button_remove.setImage(ImageResources

					.getImage(ImageResources.TRASH_ICON));

			button_remove.setToolTipText("Remove");

			addControl(button_remove);

			button_remove.addSelectionListener(new DeleteListener(this));

		}

	}

	/**

	 * Return the selected object

	 * 

	 * @return a T object.

	 */

	public T getSelection() {

		return entity;

	}

	/*

	 * (non-Javadoc)

	 * 

	 * @see

	 * eu.etaxonomy.taxeditor.forms.IEnableableFormElement#setEnabled(boolean)

	 */

	/** {@inheritDoc} */

	@Override

	public void setEnabled(boolean enabled) {

		button_selection.setEnabled(enabled);

		if (isEditable) {

			button_edit.setEnabled(enabled && entity != null);

		}

	}

	/**

	 * <p>

	 * setSelectionInternal

	 * </p>

	 * 

	 * @param selection

	 *            a T object.

	 */

	protected void setSelectionInternal(T selection) {

		if (selection != null && !selection.equals(this.entity)) {

			setEntity(selection);

			firePropertyChangeEvent(new CdmPropertyChangeEvent(this, null));

		}

	}

	/**

	 * <p>

	 * Setter for the field <code>entity</code>.

	 * </p>

	 * 

	 * @param selection

	 *            a T object.

	 */

	public void setEntity(T selection) {

		this.entity = selection;

		updateElement();

	}

	/**

	 * Updates this elements view

	 */

	protected void updateElement() {

		String title = CdmUtils.Nz(getTitle());

		// we have to duplicate ampersands otherwise they are treated as

		// mnenomic (see Label.setText() documentation)

		title = title.replace("&", "&&");

		text.setText(title); // title can be null

		if (isEditable) {

			button_edit.setEnabled(entity != null);

		}

	}

	/**

	 * <p>

	 * updateFromWizard

	 * </p>

	 */

	protected void updateFromWizard() {

		updateElement();

		firePropertyChangeEvent(new CdmPropertyChangeEvent(this, null));

	}

	/**

	 * <p>

	 * getTitle

	 * </p>

	 * 

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

	 */

	protected String getTitle() {

		if (entity != null && entity instanceof IIdentifiableEntity) {

			return ((IIdentifiableEntity) entity).getTitleCache();

		}

		return "";

	}

	/** {@inheritDoc} */

	@Override

	public void setSelected(boolean selected) {

		setBackground(selected ? SELECTED : getPersistentBackground());

	}

	/*

	 * (non-Javadoc)

	 * 

	 * @see eu.etaxonomy.taxeditor.forms.IEntityElement#getEntity()

	 */

	/**

	 * <p>

	 * Getter for the field <code>entity</code>.

	 * </p>

	 * 

	 * @return a T object.

	 */

	@Override

	public T getEntity() {

		return entity;

	}

	/*

	 * (non-Javadoc)

	 * 

	 * @see eu.etaxonomy.taxeditor.forms.section.cdmdetail.ISelectableElement#

	 * getSelectionArbitrator()

	 */

	/**

	 * <p>

	 * Getter for the field <code>selectionArbitrator</code>.

	 * </p>

	 * 

	 * @return a {@link eu.etaxonomy.taxeditor.ui.element.SelectionArbitrator}

	 *         object.

	 */

	@Override

	public SelectionArbitrator getSelectionArbitrator() {

		return selectionArbitrator;

	}

	/**

	 * Convenient access to current shell

	 * 

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

	 */

	protected Shell getShell() {

		return getLayoutComposite().getShell();

	}

	/** {@inheritDoc} */

	@Override

	public void setIrrelevant(boolean irrelevant) {

		String colorId = irrelevant ? Resources.COLOR_COMPOSITE_IRRELEVANT

				: Resources.COLOR_TEXT_DISABLED_BACKGROUND;

		Color color = StoreUtil.getColor(colorId);

		text.setBackground(color);

	}

	private class DeleteListener extends SelectionAdapter {

		private final AbstractSelectionElement<T> selectionElement;

		public DeleteListener(AbstractSelectionElement<T> selectionElement) {

			this.selectionElement = selectionElement;

		}

		@Override

		public void widgetSelected(SelectionEvent e) {

			setEntity(null);

			firePropertyChangeEvent(new CdmPropertyChangeEvent(

					selectionElement, null));

		}

	}

	private class EditListener extends SelectionAdapter {

		private final AbstractSelectionElement<T> selectionElement;

		public EditListener(AbstractSelectionElement<T> selectionElement) {

			this.selectionElement = selectionElement;

		}

		/** {@inheritDoc} */

		@Override

		public void widgetSelected(SelectionEvent e) {

			WizardDialog dialog = new WizardDialog(selectionElement.getShell(),

					new EditFromSelectionWizard(selectionElement));

			if (dialog.open() == IStatus.OK) {

				selectionElement.updateFromWizard();

			}

		}

	}

	// not used

	/** {@inheritDoc} */

	@Override

	public void widgetDefaultSelected(SelectionEvent e) {

	}

	/**

	 * <p>

	 * getConversationHolder

	 * </p>

	 * 

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

	 *         object.

	 */

	@Override

	public ConversationHolder getConversationHolder() {

		return conversation;

	}

	/** {@inheritDoc} */

	@Override

	public void setBackground(Color color) {

		label.setBackground(color);

	}

	/** {@inheritDoc} */

	@Override

	public void setLabel(String labelString) {

		if (label != null) {

			label.setText(labelString);

		}

	}

	/**

	 * <p>

	 * Getter for the field <code>label</code>.

	 * </p>

	 * 

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

	 */

	@Override

	public String getLabel() {

		if (label != null) {

			return label.getText();

		}

		return null;

	}

	/** {@inheritDoc} */

	@Override

	public void update(CdmDataChangeMap changeEvents) {

	}

}