bundles/org.eclipse.emf.ecp.view.unset/src/org/eclipse/emf/ecp/view/internal/unset/UnsetService.java - emfclient/org.eclipse.emf.ecp.core - Git at Google

 /*******************************************************************************
  * Copyright (c) 2011-2013 EclipseSource Muenchen GmbH and others.
  *
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License 2.0
  * which accompanies this distribution, and is available at
  * https://www.eclipse.org/legal/epl-2.0/
  *
  * SPDX-License-Identifier: EPL-2.0
  *
  * Contributors:
  * Johannes Faltermeier - initial API and implementation
  ******************************************************************************/
 package org.eclipse.emf.ecp.view.internal.unset;

 import java.util.LinkedHashMap;
 import java.util.LinkedHashSet;
 import java.util.Map;
 import java.util.Set;

 import org.eclipse.core.databinding.observable.IObserving;
 import org.eclipse.core.databinding.observable.value.IObservableValue;
 import org.eclipse.core.runtime.IStatus;
 import org.eclipse.emf.common.notify.Notification;
 import org.eclipse.emf.common.util.EList;
 import org.eclipse.emf.common.util.TreeIterator;
 import org.eclipse.emf.ecore.EObject;
 import org.eclipse.emf.ecore.EStructuralFeature;
 import org.eclipse.emf.ecp.view.spi.context.ViewModelContext;
 import org.eclipse.emf.ecp.view.spi.context.ViewModelService;
 import org.eclipse.emf.ecp.view.spi.model.ModelChangeListener;
 import org.eclipse.emf.ecp.view.spi.model.ModelChangeNotification;
 import org.eclipse.emf.ecp.view.spi.model.VControl;
 import org.eclipse.emf.ecp.view.spi.model.VElement;
 import org.eclipse.emf.ecp.view.spi.model.VViewPackage;
 import org.eclipse.emfforms.spi.common.report.AbstractReport;
 import org.eclipse.emfforms.spi.common.report.ReportService;
 import org.eclipse.emfforms.spi.core.services.databinding.DatabindingFailedException;
 import org.eclipse.emfforms.spi.core.services.databinding.DatabindingFailedReport;
 import org.eclipse.emfforms.spi.core.services.databinding.EMFFormsDatabinding;
 import org.eclipse.emfforms.spi.core.services.view.EMFFormsContextListener;
 import org.eclipse.emfforms.spi.core.services.view.EMFFormsViewContext;

 /**
  * Unset service that, once instantiated, synchronizes the visible state of a
  * view and its children with the affected EStructuralFeature(s), i.e.
  * setting/unsetting the value(s).
  *
  * @author jfaltermeier
  *
  */
 public class UnsetService implements ViewModelService, EMFFormsContextListener {

 	private static final String DOMAIN_MODEL_NULL_EXCEPTION = "Domain model must not be null."; //$NON-NLS-1$
 	private static final String VIEW_MODEL_NULL_EXCEPTION = "View model must not be null."; //$NON-NLS-1$

 	private ViewModelContext context;
 	private ModelChangeListener viewChangeListener;

 	private final Map<EObject, Set<FeatureWrapper>> objectToFeatureMap;
 	private final Map<FeatureWrapper, Set<VControl>> settingToControlMap;

 	/**
 	 * During init all controls that are hidden, either direct or by being
 	 * contained by a hidden parent, are collected here.
 	 */
 	private final Set<VControl> hiddenControlsDuringInit;
 	private ReportService reportService;
 	private EMFFormsDatabinding emfFormsDatabinding;

 	/**
 	 * Default constructor for the unset service.
 	 */
 	public UnsetService() {
 		objectToFeatureMap = new LinkedHashMap<EObject, Set<FeatureWrapper>>();
 		settingToControlMap = new LinkedHashMap<FeatureWrapper, Set<VControl>>();
 		hiddenControlsDuringInit = new LinkedHashSet<VControl>();
 	}

 	/**
 	 * {@inheritDoc}
 	 *
 	 * @see org.eclipse.emf.ecp.view.spi.context.ViewModelService#instantiate(org.eclipse.emf.ecp.view.spi.context.ViewModelContext)
 	 */
 	@Override
 	public void instantiate(ViewModelContext context) {
 		this.context = context;
 		reportService = context.getService(ReportService.class);
 		emfFormsDatabinding = context.getService(EMFFormsDatabinding.class);
 		this.context.registerEMFFormsContextListener(this);
 	}

 	private void initMaps(VElement view, boolean parentInvisible) {
 		if (!view.isVisible() || parentInvisible) {
 			if (view instanceof VControl) {
 				hiddenControlsDuringInit.add((VControl) view);
 			}
 			parentInvisible = true;
 		}

 		if (view instanceof VControl) {
 			addControlToMap((VControl) view);
 		} else {
 			final EList<EObject> children = view.eContents();
 			for (final EObject child : children) {
 				if (child == null) {
 					continue;
 				}

 				if (child instanceof VElement) {
 					initMaps((VElement) child, parentInvisible);
 				}
 			}
 		}
 	}

 	private void unsetInitialHiddenControls() {
 		for (final VControl control : hiddenControlsDuringInit) {
 			removeControlFromMapAndUnsetIfNeeded(control);
 		}
 	}

 	private void addControlToMap(VControl control) {
 		if (control.getDomainModelReference() == null) {
 			reportService.report(
 				new AbstractReport(String.format("The provided control [%1$s] has no defined DMR.", control), //$NON-NLS-1$
 					IStatus.INFO));
 			return;
 		}
 		IObservableValue observableValue;
 		try {
 			observableValue = emfFormsDatabinding
 				.getObservableValue(control.getDomainModelReference(), context.getDomainModel());
 		} catch (final DatabindingFailedException ex) {
 			reportService.report(new DatabindingFailedReport(ex));
 			return;
 		}
 		final EStructuralFeature structuralFeature = (EStructuralFeature) observableValue.getValueType();
 		final EObject eObject = (EObject) ((IObserving) observableValue).getObserved();
 		observableValue.dispose();
 		if (!objectToFeatureMap.containsKey(eObject)) {
 			objectToFeatureMap
 				.put(eObject, new LinkedHashSet<FeatureWrapper>());
 		}
 		final Set<FeatureWrapper> features = objectToFeatureMap.get(eObject);
 		FeatureWrapper wrapper = null;
 		for (final FeatureWrapper w : features) {
 			if (w.isWrapperFor(structuralFeature)) {
 				wrapper = w;
 				break;
 			}
 		}
 		if (wrapper == null) {
 			wrapper = new FeatureWrapper(structuralFeature);
 			features.add(wrapper);
 		}

 		if (!settingToControlMap.containsKey(wrapper)) {
 			settingToControlMap.put(wrapper, new LinkedHashSet<VControl>());
 		}
 		settingToControlMap.get(wrapper).add(control);
 	}

 	private void removeControlFromMapAndUnsetIfNeeded(VControl control) {
 		IObservableValue observableValue;
 		try {
 			observableValue = emfFormsDatabinding
 				.getObservableValue(control.getDomainModelReference(), context.getDomainModel());
 		} catch (final DatabindingFailedException ex) {
 			reportService.report(new DatabindingFailedReport(ex));
 			return;
 		}
 		final EStructuralFeature structuralFeature = (EStructuralFeature) observableValue.getValueType();
 		final EObject eObject = (EObject) ((IObserving) observableValue).getObserved();
 		observableValue.dispose();
 		final Set<FeatureWrapper> wrappers = objectToFeatureMap
 			.get(eObject);
 		FeatureWrapper wrapper = null;
 		if (wrappers == null) {
 			return;
 		}
 		for (final FeatureWrapper w : wrappers) {
 			if (w.isWrapperFor(structuralFeature)) {
 				wrapper = w;
 			}
 		}

 		final Set<VControl> visibleControls = settingToControlMap
 			.get(wrapper);
 		visibleControls.remove(control);
 		if (visibleControls.isEmpty() && eObject != null) {
 			eObject.eUnset(structuralFeature);
 		}
 	}

 	/**
 	 * The given element just became visible.
 	 * If it is a control add it to the map.
 	 * If it is a container check if children became visible
 	 *
 	 * @param element
 	 */
 	private void show(VElement element) {
 		if (element instanceof VControl) {
 			addControlToMap((VControl) element);
 			return;
 		}

 		final EList<EObject> children = element.eContents();
 		for (final EObject child : children) {
 			if (child == null) {
 				continue;
 			}
 			if (child instanceof VElement) {
 				final VElement childElement = (VElement) child;
 				if (childElement.isVisible()) {
 					show(childElement);
 				}
 			}
 		}
 	}

 	/**
 	 * The given element just became invisible.
 	 * If it is a control remove it from map and unset if needed.
 	 * If it is a container hide all child controls.
 	 *
 	 *
 	 * @param element
 	 */
 	private void hide(VElement element) {
 		if (element instanceof VControl) {
 			removeControlFromMapAndUnsetIfNeeded((VControl) element);
 			return;
 		}

 		final TreeIterator<EObject> iterator = element.eAllContents();
 		while (iterator.hasNext()) {
 			final EObject object = iterator.next();
 			if (object == null) {
 				continue;
 			}
 			if (object instanceof VControl) {
 				removeControlFromMapAndUnsetIfNeeded((VControl) object);
 			}
 		}
 	}

 	/**
 	 * {@inheritDoc}
 	 *
 	 * @see org.eclipse.emf.ecp.view.spi.context.ViewModelService#dispose()
 	 */
 	@Override
 	public void dispose() {
 		context.unregisterEMFFormsContextListener(this);
 		context.unregisterViewChangeListener(viewChangeListener);
 	}

 	/**
 	 * {@inheritDoc}
 	 *
 	 * @see org.eclipse.emf.ecp.view.spi.context.ViewModelService#getPriority()
 	 */
 	@Override
 	public int getPriority() {
 		return 5;
 	}

 	/**
 	 * Class wrapping an {@link EStructuralFeature} as a dedicated object that
 	 * can be used as key.
 	 *
 	 * @author jfaltermeier
 	 *
 	 */
 	private class FeatureWrapper {

 		private final EStructuralFeature feature;

 		/**
 		 * Default constructor.
 		 *
 		 * @param feature
 		 *            the feature to wrap
 		 */
 		FeatureWrapper(EStructuralFeature feature) {
 			this.feature = feature;
 		}

 		/**
 		 * Whether this wrapper is mapped to the given feature.
 		 *
 		 * @param featureToCompare
 		 * @return <code>true</code> if equals
 		 */
 		public boolean isWrapperFor(EStructuralFeature featureToCompare) {
 			return feature.equals(featureToCompare);
 		}

 	}

 	/**
 	 * {@inheritDoc}
 	 *
 	 * @see org.eclipse.emfforms.spi.core.services.view.EMFFormsContextListener#childContextAdded(org.eclipse.emf.ecp.view.spi.model.VElement,
 	 *      org.eclipse.emfforms.spi.core.services.view.EMFFormsViewContext)
 	 */
 	@Override
 	public void childContextAdded(VElement parentElement, EMFFormsViewContext childContext) {
 		// intentionally left empty
 	}

 	/**
 	 * {@inheritDoc}
 	 *
 	 * @see org.eclipse.emfforms.spi.core.services.view.EMFFormsContextListener#childContextDisposed(org.eclipse.emfforms.spi.core.services.view.EMFFormsViewContext)
 	 */
 	@Override
 	public void childContextDisposed(EMFFormsViewContext childContext) {
 		// intentionally left empty
 	}

 	/**
 	 * {@inheritDoc}
 	 *
 	 * @see org.eclipse.emfforms.spi.core.services.view.EMFFormsContextListener#contextInitialised()
 	 */
 	@Override
 	public void contextInitialised() {

 		viewChangeListener = new ModelChangeListener() {
 			@Override
 			public void notifyChange(ModelChangeNotification notification) {
 				if (notification.getStructuralFeature() == VViewPackage.eINSTANCE.getElement_Visible()) {
 					final EObject notifier = notification.getNotifier();
 					final Notification rawNotification = notification.getRawNotification();
 					if (rawNotification.getNewBooleanValue()) {
 						// isVisible set to true
 						show((VElement) notifier);
 						return;
 					}
 					// isVisible set to false
 					hide((VElement) notifier);

 				}
 			}
 		};
 		context.registerViewChangeListener(viewChangeListener);

 		final VElement view = context.getViewModel();
 		if (view == null) {
 			throw new IllegalStateException(VIEW_MODEL_NULL_EXCEPTION);
 		}

 		final EObject domainModel = context.getDomainModel();
 		if (domainModel == null) {
 			throw new IllegalStateException(DOMAIN_MODEL_NULL_EXCEPTION);
 		}

 		initMaps(view, false);
 		unsetInitialHiddenControls();
 	}

 	/**
 	 * {@inheritDoc}
 	 *
 	 * @see org.eclipse.emfforms.spi.core.services.view.EMFFormsContextListener#contextDispose()
 	 */
 	@Override
 	public void contextDispose() {
 		// intentionally left empty
 	}

 }
	/*******************************************************************************
	* Copyright (c) 2011-2013 EclipseSource Muenchen GmbH and others.
	*
	* All rights reserved. This program and the accompanying materials
	* are made available under the terms of the Eclipse Public License 2.0
	* which accompanies this distribution, and is available at
	* https://www.eclipse.org/legal/epl-2.0/
	*
	* SPDX-License-Identifier: EPL-2.0
	*
	* Contributors:
	* Johannes Faltermeier - initial API and implementation
	******************************************************************************/
	package org.eclipse.emf.ecp.view.internal.unset;

	import java.util.LinkedHashMap;
	import java.util.LinkedHashSet;
	import java.util.Map;
	import java.util.Set;

	import org.eclipse.core.databinding.observable.IObserving;
	import org.eclipse.core.databinding.observable.value.IObservableValue;
	import org.eclipse.core.runtime.IStatus;
	import org.eclipse.emf.common.notify.Notification;
	import org.eclipse.emf.common.util.EList;
	import org.eclipse.emf.common.util.TreeIterator;
	import org.eclipse.emf.ecore.EObject;
	import org.eclipse.emf.ecore.EStructuralFeature;
	import org.eclipse.emf.ecp.view.spi.context.ViewModelContext;
	import org.eclipse.emf.ecp.view.spi.context.ViewModelService;
	import org.eclipse.emf.ecp.view.spi.model.ModelChangeListener;
	import org.eclipse.emf.ecp.view.spi.model.ModelChangeNotification;
	import org.eclipse.emf.ecp.view.spi.model.VControl;
	import org.eclipse.emf.ecp.view.spi.model.VElement;
	import org.eclipse.emf.ecp.view.spi.model.VViewPackage;
	import org.eclipse.emfforms.spi.common.report.AbstractReport;
	import org.eclipse.emfforms.spi.common.report.ReportService;
	import org.eclipse.emfforms.spi.core.services.databinding.DatabindingFailedException;
	import org.eclipse.emfforms.spi.core.services.databinding.DatabindingFailedReport;
	import org.eclipse.emfforms.spi.core.services.databinding.EMFFormsDatabinding;
	import org.eclipse.emfforms.spi.core.services.view.EMFFormsContextListener;
	import org.eclipse.emfforms.spi.core.services.view.EMFFormsViewContext;

	/**
	* Unset service that, once instantiated, synchronizes the visible state of a
	* view and its children with the affected EStructuralFeature(s), i.e.
	* setting/unsetting the value(s).
	*
	* @author jfaltermeier
	*
	*/
	public class UnsetService implements ViewModelService, EMFFormsContextListener {

	private static final String DOMAIN_MODEL_NULL_EXCEPTION = "Domain model must not be null."; //$NON-NLS-1$
	private static final String VIEW_MODEL_NULL_EXCEPTION = "View model must not be null."; //$NON-NLS-1$

	private ViewModelContext context;
	private ModelChangeListener viewChangeListener;

	private final Map<EObject, Set<FeatureWrapper>> objectToFeatureMap;
	private final Map<FeatureWrapper, Set<VControl>> settingToControlMap;

	/**
	* During init all controls that are hidden, either direct or by being
	* contained by a hidden parent, are collected here.
	*/
	private final Set<VControl> hiddenControlsDuringInit;
	private ReportService reportService;
	private EMFFormsDatabinding emfFormsDatabinding;

	/**
	* Default constructor for the unset service.
	*/
	public UnsetService() {
	objectToFeatureMap = new LinkedHashMap<EObject, Set<FeatureWrapper>>();
	settingToControlMap = new LinkedHashMap<FeatureWrapper, Set<VControl>>();
	hiddenControlsDuringInit = new LinkedHashSet<VControl>();
	}

	/**
	* {@inheritDoc}
	*
	* @see org.eclipse.emf.ecp.view.spi.context.ViewModelService#instantiate(org.eclipse.emf.ecp.view.spi.context.ViewModelContext)
	*/
	@Override
	public void instantiate(ViewModelContext context) {
	this.context = context;
	reportService = context.getService(ReportService.class);
	emfFormsDatabinding = context.getService(EMFFormsDatabinding.class);
	this.context.registerEMFFormsContextListener(this);
	}

	private void initMaps(VElement view, boolean parentInvisible) {
	if (!view.isVisible() \|\| parentInvisible) {
	if (view instanceof VControl) {
	hiddenControlsDuringInit.add((VControl) view);
	}
	parentInvisible = true;
	}

	if (view instanceof VControl) {
	addControlToMap((VControl) view);
	} else {
	final EList<EObject> children = view.eContents();
	for (final EObject child : children) {
	if (child == null) {
	continue;
	}

	if (child instanceof VElement) {
	initMaps((VElement) child, parentInvisible);
	}
	}
	}
	}

	private void unsetInitialHiddenControls() {
	for (final VControl control : hiddenControlsDuringInit) {
	removeControlFromMapAndUnsetIfNeeded(control);
	}
	}

	private void addControlToMap(VControl control) {
	if (control.getDomainModelReference() == null) {
	reportService.report(
	new AbstractReport(String.format("The provided control [%1$s] has no defined DMR.", control), //$NON-NLS-1$
	IStatus.INFO));
	return;
	}
	IObservableValue observableValue;
	try {
	observableValue = emfFormsDatabinding
	.getObservableValue(control.getDomainModelReference(), context.getDomainModel());
	} catch (final DatabindingFailedException ex) {
	reportService.report(new DatabindingFailedReport(ex));
	return;
	}
	final EStructuralFeature structuralFeature = (EStructuralFeature) observableValue.getValueType();
	final EObject eObject = (EObject) ((IObserving) observableValue).getObserved();
	observableValue.dispose();
	if (!objectToFeatureMap.containsKey(eObject)) {
	objectToFeatureMap
	.put(eObject, new LinkedHashSet<FeatureWrapper>());
	}
	final Set<FeatureWrapper> features = objectToFeatureMap.get(eObject);
	FeatureWrapper wrapper = null;
	for (final FeatureWrapper w : features) {
	if (w.isWrapperFor(structuralFeature)) {
	wrapper = w;
	break;
	}
	}
	if (wrapper == null) {
	wrapper = new FeatureWrapper(structuralFeature);
	features.add(wrapper);
	}

	if (!settingToControlMap.containsKey(wrapper)) {
	settingToControlMap.put(wrapper, new LinkedHashSet<VControl>());
	}
	settingToControlMap.get(wrapper).add(control);
	}

	private void removeControlFromMapAndUnsetIfNeeded(VControl control) {
	IObservableValue observableValue;
	try {
	observableValue = emfFormsDatabinding
	.getObservableValue(control.getDomainModelReference(), context.getDomainModel());
	} catch (final DatabindingFailedException ex) {
	reportService.report(new DatabindingFailedReport(ex));
	return;
	}
	final EStructuralFeature structuralFeature = (EStructuralFeature) observableValue.getValueType();
	final EObject eObject = (EObject) ((IObserving) observableValue).getObserved();
	observableValue.dispose();
	final Set<FeatureWrapper> wrappers = objectToFeatureMap
	.get(eObject);
	FeatureWrapper wrapper = null;
	if (wrappers == null) {
	return;
	}
	for (final FeatureWrapper w : wrappers) {
	if (w.isWrapperFor(structuralFeature)) {
	wrapper = w;
	}
	}

	final Set<VControl> visibleControls = settingToControlMap
	.get(wrapper);
	visibleControls.remove(control);
	if (visibleControls.isEmpty() && eObject != null) {
	eObject.eUnset(structuralFeature);
	}
	}

	/**
	* The given element just became visible.
	* If it is a control add it to the map.
	* If it is a container check if children became visible
	*
	* @param element
	*/
	private void show(VElement element) {
	if (element instanceof VControl) {
	addControlToMap((VControl) element);
	return;
	}

	final EList<EObject> children = element.eContents();
	for (final EObject child : children) {
	if (child == null) {
	continue;
	}
	if (child instanceof VElement) {
	final VElement childElement = (VElement) child;
	if (childElement.isVisible()) {
	show(childElement);
	}
	}
	}
	}

	/**
	* The given element just became invisible.
	* If it is a control remove it from map and unset if needed.
	* If it is a container hide all child controls.
	*
	*
	* @param element
	*/
	private void hide(VElement element) {
	if (element instanceof VControl) {
	removeControlFromMapAndUnsetIfNeeded((VControl) element);
	return;
	}

	final TreeIterator<EObject> iterator = element.eAllContents();
	while (iterator.hasNext()) {
	final EObject object = iterator.next();
	if (object == null) {
	continue;
	}
	if (object instanceof VControl) {
	removeControlFromMapAndUnsetIfNeeded((VControl) object);
	}
	}
	}

	/**
	* {@inheritDoc}
	*
	* @see org.eclipse.emf.ecp.view.spi.context.ViewModelService#dispose()
	*/
	@Override
	public void dispose() {
	context.unregisterEMFFormsContextListener(this);
	context.unregisterViewChangeListener(viewChangeListener);
	}

	/**
	* {@inheritDoc}
	*
	* @see org.eclipse.emf.ecp.view.spi.context.ViewModelService#getPriority()
	*/
	@Override
	public int getPriority() {
	return 5;
	}

	/**
	* Class wrapping an {@link EStructuralFeature} as a dedicated object that
	* can be used as key.
	*
	* @author jfaltermeier
	*
	*/
	private class FeatureWrapper {

	private final EStructuralFeature feature;

	/**
	* Default constructor.
	*
	* @param feature
	* the feature to wrap
	*/
	FeatureWrapper(EStructuralFeature feature) {
	this.feature = feature;
	}

	/**
	* Whether this wrapper is mapped to the given feature.
	*
	* @param featureToCompare
	* @return <code>true</code> if equals
	*/
	public boolean isWrapperFor(EStructuralFeature featureToCompare) {
	return feature.equals(featureToCompare);
	}

	}

	/**
	* {@inheritDoc}
	*
	* @see org.eclipse.emfforms.spi.core.services.view.EMFFormsContextListener#childContextAdded(org.eclipse.emf.ecp.view.spi.model.VElement,
	* org.eclipse.emfforms.spi.core.services.view.EMFFormsViewContext)
	*/
	@Override
	public void childContextAdded(VElement parentElement, EMFFormsViewContext childContext) {
	// intentionally left empty
	}

	/**
	* {@inheritDoc}
	*
	* @see org.eclipse.emfforms.spi.core.services.view.EMFFormsContextListener#childContextDisposed(org.eclipse.emfforms.spi.core.services.view.EMFFormsViewContext)
	*/
	@Override
	public void childContextDisposed(EMFFormsViewContext childContext) {
	// intentionally left empty
	}

	/**
	* {@inheritDoc}
	*
	* @see org.eclipse.emfforms.spi.core.services.view.EMFFormsContextListener#contextInitialised()
	*/
	@Override
	public void contextInitialised() {

	viewChangeListener = new ModelChangeListener() {
	@Override
	public void notifyChange(ModelChangeNotification notification) {
	if (notification.getStructuralFeature() == VViewPackage.eINSTANCE.getElement_Visible()) {
	final EObject notifier = notification.getNotifier();
	final Notification rawNotification = notification.getRawNotification();
	if (rawNotification.getNewBooleanValue()) {
	// isVisible set to true
	show((VElement) notifier);
	return;
	}
	// isVisible set to false
	hide((VElement) notifier);

	}
	}
	};
	context.registerViewChangeListener(viewChangeListener);

	final VElement view = context.getViewModel();
	if (view == null) {
	throw new IllegalStateException(VIEW_MODEL_NULL_EXCEPTION);
	}

	final EObject domainModel = context.getDomainModel();
	if (domainModel == null) {
	throw new IllegalStateException(DOMAIN_MODEL_NULL_EXCEPTION);
	}

	initMaps(view, false);
	unsetInitialHiddenControls();
	}

	/**
	* {@inheritDoc}
	*
	* @see org.eclipse.emfforms.spi.core.services.view.EMFFormsContextListener#contextDispose()
	*/
	@Override
	public void contextDispose() {
	// intentionally left empty
	}

	}