jpa/plugins/org.eclipse.jpt.ui/src/org/eclipse/jpt/ui/internal/details/PersistentAttributeDetailsPage.java - dali/webtools.dali - Git at Google

 /*******************************************************************************
  * Copyright (c) 2006, 2008 Oracle. All rights reserved.
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v1.0, which accompanies this distribution
  * and is available at http://www.eclipse.org/legal/epl-v10.html.
  *
  * Contributors:
  *     Oracle - initial API and implementation
  ******************************************************************************/
 package org.eclipse.jpt.ui.internal.details;

 import java.util.Collection;
 import java.util.HashMap;
 import java.util.ListIterator;
 import java.util.Map;
 import org.eclipse.jface.viewers.ComboViewer;
 import org.eclipse.jface.viewers.IBaseLabelProvider;
 import org.eclipse.jface.viewers.IContentProvider;
 import org.eclipse.jface.viewers.ISelectionChangedListener;
 import org.eclipse.jface.viewers.IStructuredContentProvider;
 import org.eclipse.jface.viewers.LabelProvider;
 import org.eclipse.jface.viewers.SelectionChangedEvent;
 import org.eclipse.jface.viewers.StructuredSelection;
 import org.eclipse.jface.viewers.Viewer;
 import org.eclipse.jpt.core.context.AttributeMapping;
 import org.eclipse.jpt.core.context.PersistentAttribute;
 import org.eclipse.jpt.ui.JpaPlatformUi;
 import org.eclipse.jpt.ui.JpaUiFactory;
 import org.eclipse.jpt.ui.JptUiPlugin;
 import org.eclipse.jpt.ui.details.JpaComposite;
 import org.eclipse.jpt.ui.internal.JptUiMessages;
 import org.eclipse.jpt.ui.internal.Tracing;
 import org.eclipse.jpt.ui.internal.platform.JpaPlatformUiRegistry;
 import org.eclipse.jpt.ui.internal.platform.base.BaseJpaPlatformUi;
 import org.eclipse.jpt.ui.java.details.AttributeMappingUiProvider;
 import org.eclipse.jpt.utility.internal.CollectionTools;
 import org.eclipse.jpt.utility.internal.Filter;
 import org.eclipse.jpt.utility.internal.model.value.FilteringPropertyValueModel;
 import org.eclipse.jpt.utility.internal.model.value.PropertyAspectAdapter;
 import org.eclipse.jpt.utility.internal.model.value.PropertyValueModel;
 import org.eclipse.swt.SWT;
 import org.eclipse.swt.widgets.Composite;
 import org.eclipse.swt.widgets.Label;
 import org.eclipse.ui.part.PageBook;
 import org.eclipse.ui.views.properties.tabbed.TabbedPropertySheetWidgetFactory;

 /**
  * The abstract definition of the details page responsible to show the
  * information for an persistent attribute.
  *
  * @see PersistentAttribute
  *
  * @version 2.0
  * @since 1.0
  */
 @SuppressWarnings("nls")
 public abstract class PersistentAttributeDetailsPage<T extends PersistentAttribute> extends AbstractJpaDetailsPage<T>
 {
 	private JpaComposite<AttributeMapping> currentMappingComposite;
 	private String currentMappingKey;
 	private ComboViewer mappingCombo;
 	private Map<String, JpaComposite<AttributeMapping>> mappingComposites;
 	private PageBook mappingPageBook;

 	/**
 	 * Creates a new <code>PersistentAttributeDetailsPage</code>.
 	 *
 	 * @param parent The parent container
 	 * @param widgetFactory The factory used to create various common widgets
 	 */
 	protected PersistentAttributeDetailsPage(Composite parent,
                                             TabbedPropertySheetWidgetFactory widgetFactory) {

 		super(parent, widgetFactory);
 	}

 	/*
 	 * (non-Javadoc)
 	 */
 	@Override
 	protected void addPropertyNames(Collection<String> propertyNames) {
 		super.addPropertyNames(propertyNames);
 		propertyNames.add(PersistentAttribute.DEFAULT_MAPPING_PROPERTY);
 		propertyNames.add(PersistentAttribute.SPECIFIED_MAPPING_PROPERTY);
 	}

 	protected AttributeMappingUiProvider<? extends AttributeMapping> attributeMappingUiProvider(String key) {
 		for (ListIterator<AttributeMappingUiProvider<? extends AttributeMapping>> i = attributeMappingUiProviders(); i.hasNext(); ) {
 			AttributeMappingUiProvider<? extends AttributeMapping> provider = i.next();
 			if (provider.attributeMappingKey() == key) {
 				return provider;
 			}
 		}
 		throw new IllegalArgumentException("Unsupported attribute mapping UI provider key: ");
 	}

 	protected abstract ListIterator<AttributeMappingUiProvider<? extends AttributeMapping>>
 		attributeMappingUiProviders();

 	protected abstract AttributeMappingUiProvider<? extends AttributeMapping>[]
 		attributeMappingUiProvidersFor(PersistentAttribute persistentAttribute);

 	private IContentProvider buildContentProvider() {
 		return new IStructuredContentProvider() {
 			public void dispose() {
 				// do nothing
 			}

 			public Object[] getElements(Object inputElement) {
 				if (inputElement == null) {
 					return new Object[0];
 				}
 				return attributeMappingUiProvidersFor((PersistentAttribute) inputElement);
 			}

 			public void inputChanged(Viewer viewer, Object oldInput, Object newInput) {
 				// do nothing
 			}
 		};
 	}

 	private PropertyAspectAdapter<PersistentAttribute, AttributeMapping> buildGenericMappingHolder() {
 		return new PropertyAspectAdapter<PersistentAttribute, AttributeMapping>(
 			getSubjectHolder(),
 			PersistentAttribute.DEFAULT_MAPPING_PROPERTY,
 			PersistentAttribute.SPECIFIED_MAPPING_PROPERTY)
 		{
 			@Override
 			protected AttributeMapping buildValue_() {
 				return subject.getMapping();
 			}
 		};
 	}

 	private IBaseLabelProvider buildLabelProvider() {
 		return new LabelProvider() {
 			@Override
 			public String getText(Object element) {
 				return ((AttributeMappingUiProvider<?>) element).label();
 			}
 		};
 	}

 	protected ComboViewer buildMappingCombo(Composite parent) {

 		this.mappingCombo = buildCComboViewer(parent, buildLabelProvider());
 		this.mappingCombo.getCCombo().setVisibleItemCount(Integer.MAX_VALUE);
 		this.mappingCombo.setContentProvider(buildContentProvider());
 		this.mappingCombo.addSelectionChangedListener(buildMappingComboModifyListener());
 		return this.mappingCombo;
 	}

 	private ISelectionChangedListener buildMappingComboModifyListener() {
 		return new ISelectionChangedListener() {
 			public void selectionChanged(SelectionChangedEvent e) {
 				mappingChanged(e);
 			}
 		};
 	}

 	@SuppressWarnings("unchecked")
 	protected JpaComposite<AttributeMapping> buildMappingComposite(PageBook pageBook,
 	                                                                 String key) {

 		AttributeMappingUiProvider<AttributeMapping> uiProvider = (AttributeMappingUiProvider<AttributeMapping>) mappingUIProvider(key);

 		return uiProvider.buildAttributeMappingComposite(
 			jpaUiFactory(),
 			buildMappingHolder(key),
 			pageBook,
 			getFormWidgetFactory()
 		);
 	}

 	private Filter<AttributeMapping> buildMappingFilter(final String key) {
 		return new Filter<AttributeMapping>() {
 			public boolean accept(AttributeMapping value) {
 				return (value == null) || key.equals(value.getKey());
 			}
 		};
 	}

 	private PropertyValueModel<AttributeMapping> buildMappingHolder(final String key) {
 		return new FilteringPropertyValueModel<AttributeMapping>(
 			buildGenericMappingHolder(),
 			buildMappingFilter(key)
 		);
 	}

 	protected Label buildMappingLabel(Composite parent) {
 		return buildLabel(parent, JptUiMessages.PersistentAttributePage_mapAs);
 	}

 	protected PageBook buildMappingPageBook(Composite parent) {
 		this.mappingPageBook = new PageBook(parent, SWT.NONE);
 		return this.mappingPageBook;
 	}

 	protected abstract AttributeMappingUiProvider<? extends AttributeMapping>
 		defaultAttributeMappingUiProvider(String key);

 	protected abstract ListIterator<AttributeMappingUiProvider<? extends AttributeMapping>>
 		defaultAttributeMappingUiProviders();

 	/*
 	 * (non-Javadoc)
 	 */
 	@Override
 	protected void doDispose() {
 		log(Tracing.UI_DETAILS_VIEW, "PersistentAttributeDetailsPage.doDispose()");

 		if (this.currentMappingComposite != null) {
 			this.currentMappingComposite.dispose();
 			this.currentMappingComposite = null;
 		}

 //		for (IJpaComposite<IAttributeMapping> composite : this.mappingComposites.values()) {
 //			try {
 //				composite.dispose();
 //			}
 //			catch (Exception e) {
 //				JptUiPlugin.log(e);
 //			}
 //		}

 		this.mappingComposites.clear();
 		super.doDispose();
 	}

 	/*
 	 * (non-Javadoc)
 	 */
 	@Override
 	protected void doPopulate() {
 		super.doPopulate();
 		populateMappingComboAndPage();
 	}

 	/*
 	 * (non-Javadoc)
 	 */
 	@Override
 	protected void initialize() {
 		super.initialize();
 		this.mappingComposites = new HashMap<String, JpaComposite<AttributeMapping>>();
 	}

 	protected JpaPlatformUi jpaPlatformUi() {
 		String platformId = subject().jpaProject().jpaPlatform().getId();
 		return JpaPlatformUiRegistry.instance().jpaPlatform(platformId);
 	}

 	protected JpaUiFactory jpaUiFactory() {
 		// TODO: Remove the type cast, used for testing
 		return ((BaseJpaPlatformUi) jpaPlatformUi()).getJpaUiFactory();
 	}

 	/*
 	 * (non-Javadoc)
 	 */
 	@Override
 	protected void log(String flag, String message) {
 		super.log(flag, message);

 		if (Tracing.UI_DETAILS_VIEW.equals(flag) &&
 		    Tracing.booleanDebugOption(Tracing.UI_DETAILS_VIEW))
 		{
 			Tracing.log(message);
 		}
 	}

 	private void mappingChanged(SelectionChangedEvent event) {
 		if (event.getSelection() instanceof StructuredSelection) {
 			AttributeMappingUiProvider<?> provider = (AttributeMappingUiProvider<?>) ((StructuredSelection) event.getSelection()).getFirstElement();
 			String key = (CollectionTools.contains(defaultAttributeMappingUiProviders(), provider) ? null : provider.attributeMappingKey());
 			this.subject().setSpecifiedMappingKey(key);
 		}
 	}

 	private JpaComposite<AttributeMapping> mappingCompositeFor(String key) {
 		JpaComposite<AttributeMapping> composite = this.mappingComposites.get(key);
 		if (composite != null) {
 			return composite;
 		}

 		composite = buildMappingComposite(this.mappingPageBook, key);

 		if (composite != null) {
 			this.mappingComposites.put(key, composite);
 		}

 		return composite;
 	}

 	private AttributeMappingUiProvider<? extends AttributeMapping> mappingUIProvider(String key) {

 		if (this.subject().getMapping() == null ||
 		    this.subject().getMapping().isDefault()) {

 			return defaultAttributeMappingUiProvider(key);
 		}

 		return attributeMappingUiProvider(key);
 	}

 	private void populateMapAsCombo() {
 		if (this.subject() != this.mappingCombo.getInput()) {
 			this.mappingCombo.setInput(this.subject());
 		}
 		if (this.subject() != null) {
 			if (this.subject().getMapping() == null || this.subject().getMapping().isDefault()) {
 				this.mappingCombo.setSelection(new StructuredSelection(this.mappingCombo.getElementAt(0)));
 			}
 			else {
 				AttributeMappingUiProvider<? extends AttributeMapping> provider = attributeMappingUiProvider(this.subject().mappingKey());
 				if (provider != null && ! provider.equals(((StructuredSelection) this.mappingCombo.getSelection()).getFirstElement())) {
 					this.mappingCombo.setSelection(new StructuredSelection(provider));
 				}
 			}
 		}
 	}

 	private void populateMappingComboAndPage() {
 		populateMapAsCombo();
 		updateMappingPage();
 	}

 	private void populateMappingPage(String mappingKey) {

 		// Nothing to update
 		if (this.currentMappingKey == mappingKey) {
 			return;
 		}
 		// Dispose the existing mapping pane
 		else if (this.currentMappingComposite != null) {
 			this.log(
 				Tracing.UI_DETAILS_VIEW,
 				"PersistentAttributeDetailsPage.populateMappingPage() disposing of current page: " + this.currentMappingKey
 			);

 			try {
 				this.currentMappingComposite.dispose();
 				this.currentMappingComposite = null;
 			}
 			catch (Exception e) {
 				JptUiPlugin.log(e);
 			}
 		}

 		this.currentMappingKey = mappingKey;

 		// Change the current mapping pane with the new one
 		if (this.currentMappingKey != null) {
 			this.currentMappingComposite = mappingCompositeFor(mappingKey);

 			try {
 				this.log(
 					Tracing.UI_DETAILS_VIEW,
 					"PersistentAttributeDetailsPage.populateMappingPage() populating new page: " + this.currentMappingKey
 				);

 				this.currentMappingComposite.populate();
 				this.mappingPageBook.showPage(this.currentMappingComposite.getControl());
 				this.repaintDetailsView(this.mappingPageBook);
 			}
 			catch (Exception e) {
 				JptUiPlugin.log(e);

 				this.log(
 					Tracing.UI_DETAILS_VIEW,
 					"PersistentAttributeDetailsPage.populateMappingPage() error encountered"
 				);

 				// An error was encountered either during the population, dispose it
 				try {
 					this.currentMappingComposite.dispose();
 				}
 				catch (Exception exception) {
 					JptUiPlugin.log(e);
 				}

 				this.mappingComposites.remove(this.currentMappingComposite);
 				this.currentMappingComposite = null;

 				// Show an error message
 				// TODO: Replace the blank label with the error page
 				this.mappingPageBook.showPage(new Label(this.mappingPageBook, SWT.NULL));
 			}
 		}
 		else {
 			this.log(
 				Tracing.UI_DETAILS_VIEW,
 				"PersistentAttributeDetailsPage.populateMappingPage() no page to show"
 			);

 			this.mappingPageBook.showPage(new Label(this.mappingPageBook, SWT.NULL));
 		}
 	}

 	/*
 	 * (non-Javadoc)
 	 */
 	@Override
 	protected void propertyChanged(String propertyName) {
 		super.propertyChanged(propertyName);

 		if (propertyName == PersistentAttribute.DEFAULT_MAPPING_PROPERTY ||
 		    propertyName == PersistentAttribute.SPECIFIED_MAPPING_PROPERTY) {

 			populateMappingComboAndPage();
 		}
 	}

 	/*
 	 * (non-Javadoc)
 	 */
 	@Override
 	protected boolean repopulateWithNullSubject() {
 		return false;
 	}

 //TODO focus??
 //	public boolean setFocus() {
 //		super.setFocus();
 //		return mappingCombo.getCombo().setFocus();
 //	}

 	private void updateMappingPage() {
 		AttributeMapping mapping = (this.subject() != null) ? this.subject().getMapping() : null;
 		populateMappingPage(mapping == null ? null : mapping.getKey());
 	}
 }
	/*******************************************************************************
	* Copyright (c) 2006, 2008 Oracle. All rights reserved.
	* This program and the accompanying materials are made available under the
	* terms of the Eclipse Public License v1.0, which accompanies this distribution
	* and is available at http://www.eclipse.org/legal/epl-v10.html.
	*
	* Contributors:
	* Oracle - initial API and implementation
	******************************************************************************/
	package org.eclipse.jpt.ui.internal.details;

	import java.util.Collection;
	import java.util.HashMap;
	import java.util.ListIterator;
	import java.util.Map;
	import org.eclipse.jface.viewers.ComboViewer;
	import org.eclipse.jface.viewers.IBaseLabelProvider;
	import org.eclipse.jface.viewers.IContentProvider;
	import org.eclipse.jface.viewers.ISelectionChangedListener;
	import org.eclipse.jface.viewers.IStructuredContentProvider;
	import org.eclipse.jface.viewers.LabelProvider;
	import org.eclipse.jface.viewers.SelectionChangedEvent;
	import org.eclipse.jface.viewers.StructuredSelection;
	import org.eclipse.jface.viewers.Viewer;
	import org.eclipse.jpt.core.context.AttributeMapping;
	import org.eclipse.jpt.core.context.PersistentAttribute;
	import org.eclipse.jpt.ui.JpaPlatformUi;
	import org.eclipse.jpt.ui.JpaUiFactory;
	import org.eclipse.jpt.ui.JptUiPlugin;
	import org.eclipse.jpt.ui.details.JpaComposite;
	import org.eclipse.jpt.ui.internal.JptUiMessages;
	import org.eclipse.jpt.ui.internal.Tracing;
	import org.eclipse.jpt.ui.internal.platform.JpaPlatformUiRegistry;
	import org.eclipse.jpt.ui.internal.platform.base.BaseJpaPlatformUi;
	import org.eclipse.jpt.ui.java.details.AttributeMappingUiProvider;
	import org.eclipse.jpt.utility.internal.CollectionTools;
	import org.eclipse.jpt.utility.internal.Filter;
	import org.eclipse.jpt.utility.internal.model.value.FilteringPropertyValueModel;
	import org.eclipse.jpt.utility.internal.model.value.PropertyAspectAdapter;
	import org.eclipse.jpt.utility.internal.model.value.PropertyValueModel;
	import org.eclipse.swt.SWT;
	import org.eclipse.swt.widgets.Composite;
	import org.eclipse.swt.widgets.Label;
	import org.eclipse.ui.part.PageBook;
	import org.eclipse.ui.views.properties.tabbed.TabbedPropertySheetWidgetFactory;

	/**
	* The abstract definition of the details page responsible to show the
	* information for an persistent attribute.
	*
	* @see PersistentAttribute
	*
	* @version 2.0
	* @since 1.0
	*/
	@SuppressWarnings("nls")
	public abstract class PersistentAttributeDetailsPage<T extends PersistentAttribute> extends AbstractJpaDetailsPage<T>
	{
	private JpaComposite<AttributeMapping> currentMappingComposite;
	private String currentMappingKey;
	private ComboViewer mappingCombo;
	private Map<String, JpaComposite<AttributeMapping>> mappingComposites;
	private PageBook mappingPageBook;

	/**
	* Creates a new <code>PersistentAttributeDetailsPage</code>.
	*
	* @param parent The parent container
	* @param widgetFactory The factory used to create various common widgets
	*/
	protected PersistentAttributeDetailsPage(Composite parent,
	TabbedPropertySheetWidgetFactory widgetFactory) {

	super(parent, widgetFactory);
	}

	/*
	* (non-Javadoc)
	*/
	@Override
	protected void addPropertyNames(Collection<String> propertyNames) {
	super.addPropertyNames(propertyNames);
	propertyNames.add(PersistentAttribute.DEFAULT_MAPPING_PROPERTY);
	propertyNames.add(PersistentAttribute.SPECIFIED_MAPPING_PROPERTY);
	}

	protected AttributeMappingUiProvider<? extends AttributeMapping> attributeMappingUiProvider(String key) {
	for (ListIterator<AttributeMappingUiProvider<? extends AttributeMapping>> i = attributeMappingUiProviders(); i.hasNext(); ) {
	AttributeMappingUiProvider<? extends AttributeMapping> provider = i.next();
	if (provider.attributeMappingKey() == key) {
	return provider;
	}
	}
	throw new IllegalArgumentException("Unsupported attribute mapping UI provider key: ");
	}

	protected abstract ListIterator<AttributeMappingUiProvider<? extends AttributeMapping>>
	attributeMappingUiProviders();

	protected abstract AttributeMappingUiProvider<? extends AttributeMapping>[]
	attributeMappingUiProvidersFor(PersistentAttribute persistentAttribute);

	private IContentProvider buildContentProvider() {
	return new IStructuredContentProvider() {
	public void dispose() {
	// do nothing
	}

	public Object[] getElements(Object inputElement) {
	if (inputElement == null) {
	return new Object[0];
	}
	return attributeMappingUiProvidersFor((PersistentAttribute) inputElement);
	}

	public void inputChanged(Viewer viewer, Object oldInput, Object newInput) {
	// do nothing
	}
	};
	}

	private PropertyAspectAdapter<PersistentAttribute, AttributeMapping> buildGenericMappingHolder() {
	return new PropertyAspectAdapter<PersistentAttribute, AttributeMapping>(
	getSubjectHolder(),
	PersistentAttribute.DEFAULT_MAPPING_PROPERTY,
	PersistentAttribute.SPECIFIED_MAPPING_PROPERTY)
	{
	@Override
	protected AttributeMapping buildValue_() {
	return subject.getMapping();
	}
	};
	}

	private IBaseLabelProvider buildLabelProvider() {
	return new LabelProvider() {
	@Override
	public String getText(Object element) {
	return ((AttributeMappingUiProvider<?>) element).label();
	}
	};
	}

	protected ComboViewer buildMappingCombo(Composite parent) {

	this.mappingCombo = buildCComboViewer(parent, buildLabelProvider());
	this.mappingCombo.getCCombo().setVisibleItemCount(Integer.MAX_VALUE);
	this.mappingCombo.setContentProvider(buildContentProvider());
	this.mappingCombo.addSelectionChangedListener(buildMappingComboModifyListener());
	return this.mappingCombo;
	}

	private ISelectionChangedListener buildMappingComboModifyListener() {
	return new ISelectionChangedListener() {
	public void selectionChanged(SelectionChangedEvent e) {
	mappingChanged(e);
	}
	};
	}

	@SuppressWarnings("unchecked")
	protected JpaComposite<AttributeMapping> buildMappingComposite(PageBook pageBook,
	String key) {

	AttributeMappingUiProvider<AttributeMapping> uiProvider = (AttributeMappingUiProvider<AttributeMapping>) mappingUIProvider(key);

	return uiProvider.buildAttributeMappingComposite(
	jpaUiFactory(),
	buildMappingHolder(key),
	pageBook,
	getFormWidgetFactory()
	);
	}

	private Filter<AttributeMapping> buildMappingFilter(final String key) {
	return new Filter<AttributeMapping>() {
	public boolean accept(AttributeMapping value) {
	return (value == null) \|\| key.equals(value.getKey());
	}
	};
	}

	private PropertyValueModel<AttributeMapping> buildMappingHolder(final String key) {
	return new FilteringPropertyValueModel<AttributeMapping>(
	buildGenericMappingHolder(),
	buildMappingFilter(key)
	);
	}

	protected Label buildMappingLabel(Composite parent) {
	return buildLabel(parent, JptUiMessages.PersistentAttributePage_mapAs);
	}

	protected PageBook buildMappingPageBook(Composite parent) {
	this.mappingPageBook = new PageBook(parent, SWT.NONE);
	return this.mappingPageBook;
	}

	protected abstract AttributeMappingUiProvider<? extends AttributeMapping>
	defaultAttributeMappingUiProvider(String key);

	protected abstract ListIterator<AttributeMappingUiProvider<? extends AttributeMapping>>
	defaultAttributeMappingUiProviders();

	/*
	* (non-Javadoc)
	*/
	@Override
	protected void doDispose() {
	log(Tracing.UI_DETAILS_VIEW, "PersistentAttributeDetailsPage.doDispose()");

	if (this.currentMappingComposite != null) {
	this.currentMappingComposite.dispose();
	this.currentMappingComposite = null;
	}

	// for (IJpaComposite<IAttributeMapping> composite : this.mappingComposites.values()) {
	// try {
	// composite.dispose();
	// }
	// catch (Exception e) {
	// JptUiPlugin.log(e);
	// }
	// }

	this.mappingComposites.clear();
	super.doDispose();
	}

	/*
	* (non-Javadoc)
	*/
	@Override
	protected void doPopulate() {
	super.doPopulate();
	populateMappingComboAndPage();
	}

	/*
	* (non-Javadoc)
	*/
	@Override
	protected void initialize() {
	super.initialize();
	this.mappingComposites = new HashMap<String, JpaComposite<AttributeMapping>>();
	}

	protected JpaPlatformUi jpaPlatformUi() {
	String platformId = subject().jpaProject().jpaPlatform().getId();
	return JpaPlatformUiRegistry.instance().jpaPlatform(platformId);
	}

	protected JpaUiFactory jpaUiFactory() {
	// TODO: Remove the type cast, used for testing
	return ((BaseJpaPlatformUi) jpaPlatformUi()).getJpaUiFactory();
	}

	/*
	* (non-Javadoc)
	*/
	@Override
	protected void log(String flag, String message) {
	super.log(flag, message);

	if (Tracing.UI_DETAILS_VIEW.equals(flag) &&
	Tracing.booleanDebugOption(Tracing.UI_DETAILS_VIEW))
	{
	Tracing.log(message);
	}
	}

	private void mappingChanged(SelectionChangedEvent event) {
	if (event.getSelection() instanceof StructuredSelection) {
	AttributeMappingUiProvider<?> provider = (AttributeMappingUiProvider<?>) ((StructuredSelection) event.getSelection()).getFirstElement();
	String key = (CollectionTools.contains(defaultAttributeMappingUiProviders(), provider) ? null : provider.attributeMappingKey());
	this.subject().setSpecifiedMappingKey(key);
	}
	}

	private JpaComposite<AttributeMapping> mappingCompositeFor(String key) {
	JpaComposite<AttributeMapping> composite = this.mappingComposites.get(key);
	if (composite != null) {
	return composite;
	}

	composite = buildMappingComposite(this.mappingPageBook, key);

	if (composite != null) {
	this.mappingComposites.put(key, composite);
	}

	return composite;
	}

	private AttributeMappingUiProvider<? extends AttributeMapping> mappingUIProvider(String key) {

	if (this.subject().getMapping() == null \|\|
	this.subject().getMapping().isDefault()) {

	return defaultAttributeMappingUiProvider(key);
	}

	return attributeMappingUiProvider(key);
	}

	private void populateMapAsCombo() {
	if (this.subject() != this.mappingCombo.getInput()) {
	this.mappingCombo.setInput(this.subject());
	}
	if (this.subject() != null) {
	if (this.subject().getMapping() == null \|\| this.subject().getMapping().isDefault()) {
	this.mappingCombo.setSelection(new StructuredSelection(this.mappingCombo.getElementAt(0)));
	}
	else {
	AttributeMappingUiProvider<? extends AttributeMapping> provider = attributeMappingUiProvider(this.subject().mappingKey());
	if (provider != null && ! provider.equals(((StructuredSelection) this.mappingCombo.getSelection()).getFirstElement())) {
	this.mappingCombo.setSelection(new StructuredSelection(provider));
	}
	}
	}
	}

	private void populateMappingComboAndPage() {
	populateMapAsCombo();
	updateMappingPage();
	}

	private void populateMappingPage(String mappingKey) {

	// Nothing to update
	if (this.currentMappingKey == mappingKey) {
	return;
	}
	// Dispose the existing mapping pane
	else if (this.currentMappingComposite != null) {
	this.log(
	Tracing.UI_DETAILS_VIEW,
	"PersistentAttributeDetailsPage.populateMappingPage() disposing of current page: " + this.currentMappingKey
	);

	try {
	this.currentMappingComposite.dispose();
	this.currentMappingComposite = null;
	}
	catch (Exception e) {
	JptUiPlugin.log(e);
	}
	}

	this.currentMappingKey = mappingKey;

	// Change the current mapping pane with the new one
	if (this.currentMappingKey != null) {
	this.currentMappingComposite = mappingCompositeFor(mappingKey);

	try {
	this.log(
	Tracing.UI_DETAILS_VIEW,
	"PersistentAttributeDetailsPage.populateMappingPage() populating new page: " + this.currentMappingKey
	);

	this.currentMappingComposite.populate();
	this.mappingPageBook.showPage(this.currentMappingComposite.getControl());
	this.repaintDetailsView(this.mappingPageBook);
	}
	catch (Exception e) {
	JptUiPlugin.log(e);

	this.log(
	Tracing.UI_DETAILS_VIEW,
	"PersistentAttributeDetailsPage.populateMappingPage() error encountered"
	);

	// An error was encountered either during the population, dispose it
	try {
	this.currentMappingComposite.dispose();
	}
	catch (Exception exception) {
	JptUiPlugin.log(e);
	}

	this.mappingComposites.remove(this.currentMappingComposite);
	this.currentMappingComposite = null;

	// Show an error message
	// TODO: Replace the blank label with the error page
	this.mappingPageBook.showPage(new Label(this.mappingPageBook, SWT.NULL));
	}
	}
	else {
	this.log(
	Tracing.UI_DETAILS_VIEW,
	"PersistentAttributeDetailsPage.populateMappingPage() no page to show"
	);

	this.mappingPageBook.showPage(new Label(this.mappingPageBook, SWT.NULL));
	}
	}

	/*
	* (non-Javadoc)
	*/
	@Override
	protected void propertyChanged(String propertyName) {
	super.propertyChanged(propertyName);

	if (propertyName == PersistentAttribute.DEFAULT_MAPPING_PROPERTY \|\|
	propertyName == PersistentAttribute.SPECIFIED_MAPPING_PROPERTY) {

	populateMappingComboAndPage();
	}
	}

	/*
	* (non-Javadoc)
	*/
	@Override
	protected boolean repopulateWithNullSubject() {
	return false;
	}

	//TODO focus??
	// public boolean setFocus() {
	// super.setFocus();
	// return mappingCombo.getCombo().setFocus();
	// }

	private void updateMappingPage() {
	AttributeMapping mapping = (this.subject() != null) ? this.subject().getMapping() : null;
	populateMappingPage(mapping == null ? null : mapping.getKey());
	}
	}