EDIT

/**

* Copyright (C) 2017 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.vaadin.mvp;

import java.util.ArrayList;

import java.util.Arrays;

import java.util.HashSet;

import java.util.List;

import java.util.Map;

import java.util.Set;

import java.util.Stack;

import org.apache.log4j.Level;

import org.apache.log4j.Logger;

import org.vaadin.spring.events.EventScope;

import com.vaadin.data.Validator.InvalidValueException;

import com.vaadin.data.fieldgroup.BeanFieldGroup;

import com.vaadin.data.fieldgroup.FieldGroup.CommitEvent;

import com.vaadin.data.fieldgroup.FieldGroup.CommitException;

import com.vaadin.data.fieldgroup.FieldGroup.CommitHandler;

import com.vaadin.data.fieldgroup.FieldGroup.FieldGroupInvalidValueException;

import com.vaadin.server.AbstractErrorMessage.ContentMode;

import com.vaadin.server.ErrorMessage.ErrorLevel;

import com.vaadin.server.FontAwesome;

import com.vaadin.server.GenericFontIcon;

import com.vaadin.server.UserError;

import com.vaadin.shared.ui.MarginInfo;

import com.vaadin.ui.AbstractComponentContainer;

import com.vaadin.ui.AbstractField;

import com.vaadin.ui.AbstractLayout;

import com.vaadin.ui.AbstractOrderedLayout;

import com.vaadin.ui.Alignment;

import com.vaadin.ui.Button;

import com.vaadin.ui.Button.ClickListener;

import com.vaadin.ui.CheckBox;

import com.vaadin.ui.Component;

import com.vaadin.ui.CssLayout;

import com.vaadin.ui.Field;

import com.vaadin.ui.GridLayout;

import com.vaadin.ui.GridLayout.OutOfBoundsException;

import com.vaadin.ui.GridLayout.OverlapsException;

import com.vaadin.ui.HasComponents;

import com.vaadin.ui.HorizontalLayout;

import com.vaadin.ui.Label;

import com.vaadin.ui.Layout;

import com.vaadin.ui.Layout.MarginHandler;

import com.vaadin.ui.Notification;

import com.vaadin.ui.Notification.Type;

import com.vaadin.ui.PopupDateField;

import com.vaadin.ui.TextField;

import com.vaadin.ui.UI;

import com.vaadin.ui.VerticalLayout;

import com.vaadin.ui.themes.ValoTheme;

import eu.etaxonomy.cdm.database.PermissionDeniedException;

import eu.etaxonomy.cdm.vaadin.component.TextFieldNFix;

import eu.etaxonomy.cdm.vaadin.component.dialog.ContinueAlternativeCancelDialog;

import eu.etaxonomy.cdm.vaadin.event.EditorActionContext;

import eu.etaxonomy.cdm.vaadin.event.EditorActionContextFormat;

import eu.etaxonomy.cdm.vaadin.event.EditorActionContextFormatter;

import eu.etaxonomy.vaadin.component.NestedFieldGroup;

import eu.etaxonomy.vaadin.component.SwitchableTextField;

import eu.etaxonomy.vaadin.event.FieldReplaceEvent;

import eu.etaxonomy.vaadin.mvp.event.EditorDeleteEvent;

import eu.etaxonomy.vaadin.mvp.event.EditorPreSaveEvent;

import eu.etaxonomy.vaadin.mvp.event.EditorSaveEvent;

import eu.etaxonomy.vaadin.ui.view.DoneWithPopupEvent;

import eu.etaxonomy.vaadin.ui.view.DoneWithPopupEvent.Reason;

import eu.etaxonomy.vaadin.util.PropertyIdPath;

/**

 *

 * Optional with a delete button which can be enabled with {@link #withDeleteButton(boolean)}

 *

 * @author a.kohlbecker

 * @since Apr 5, 2017

 *

 */

public abstract class AbstractPopupEditor<DTO extends Object, P extends AbstractEditorPresenter<DTO, ? extends ApplicationView>>

    extends AbstractPopupView<P> {

    /**

     *

     */

    private static final String READ_ONLY_MESSAGE_TEXT = "The editor is in read-only mode. Your authorities are not sufficient to edit this data.";

    public static final Logger logger = Logger.getLogger(AbstractPopupEditor.class);

    private BeanFieldGroup<DTO> fieldGroup;

    private VerticalLayout mainLayout;

    private Layout fieldLayout;

    private HorizontalLayout buttonLayout;

    private Button save;

    private Button cancel;

    private Button delete;

    private CssLayout toolBar = new CssLayout();

    private CssLayout toolBarButtonGroup = new CssLayout();

    private Label contextBreadcrumbsLabel = new Label();

    private Label statusMessageLabel = new Label();

    Set<String> statusMessages = new HashSet<>();

    private GridLayout _gridLayoutCache;

    private boolean isBeanLoaded;

    private Stack<EditorActionContext> context = new Stack<EditorActionContext>();

    private boolean isContextUpdated;

    private boolean isAdvancedMode = false;

    protected List<Component> advancedModeComponents = new ArrayList<>();

    private Button advancedModeButton;

    private EditorFormConfigurator<? extends AbstractPopupEditor<DTO, P>> editorComponentsConfigurator;

    public AbstractPopupEditor(Layout layout, Class<DTO> dtoType) {

        mainLayout = new VerticalLayout();

        // IMPORTANT: mainLayout must be set to full size otherwise the

        // popup window may have problems with automatic resizing of its

        // content.

        mainLayout.setSizeFull();

        setCompositionRoot(mainLayout);

        fieldGroup = new BeanFieldGroup<>(dtoType);

        fieldGroup.addCommitHandler(new SaveHandler());

        toolBar.addStyleName(ValoTheme.WINDOW_TOP_TOOLBAR);

        toolBar.setWidth(100, Unit.PERCENTAGE);

        contextBreadcrumbsLabel.setId("context-breadcrumbs");

        contextBreadcrumbsLabel.setWidthUndefined();

        contextBreadcrumbsLabel.setContentMode(com.vaadin.shared.ui.label.ContentMode.HTML);

        toolBar.addComponent(contextBreadcrumbsLabel);

        toolBarButtonGroup.addStyleName(ValoTheme.LAYOUT_COMPONENT_GROUP);

        toolBarButtonGroup.setWidthUndefined();

        toolBar.addComponent(toolBarButtonGroup);

        toolBar.setVisible(false);

        fieldLayout = layout;

        fieldLayout.setWidthUndefined();

        if(fieldLayout instanceof AbstractOrderedLayout){

            ((AbstractOrderedLayout)fieldLayout).setSpacing(true);

        }

        if(MarginHandler.class.isAssignableFrom(fieldLayout.getClass())){

            ((MarginHandler)fieldLayout).setMargin(new MarginInfo(false, true, true, true));

        }

        buttonLayout = new HorizontalLayout();

        buttonLayout.setStyleName(ValoTheme.WINDOW_BOTTOM_TOOLBAR);

        buttonLayout.setWidth(100, Unit.PERCENTAGE);

        buttonLayout.setSpacing(true);

        save = new Button("Save", FontAwesome.SAVE);

        save.setStyleName(ValoTheme.BUTTON_PRIMARY);

        save.addClickListener(e -> save());

        cancel = new Button("Cancel", FontAwesome.REMOVE);

        cancel.addClickListener(e -> cancelEditorDialog());

        delete = new Button("Delete", FontAwesome.TRASH);

        delete.setStyleName(ValoTheme.BUTTON_DANGER);

        delete.addClickListener(e -> delete());

        delete.setVisible(false);

        buttonLayout.addComponents(delete, save, cancel);

        // delete is initially invisible, let save take all space

        buttonLayout.setExpandRatio(save, 1);

        buttonLayout.setComponentAlignment(delete, Alignment.TOP_RIGHT);

        buttonLayout.setComponentAlignment(save, Alignment.TOP_RIGHT);

        buttonLayout.setComponentAlignment(cancel, Alignment.TOP_RIGHT);

        statusMessageLabel.setWidthUndefined();

        mainLayout.addComponents(toolBar, fieldLayout, statusMessageLabel, buttonLayout);

        mainLayout.setComponentAlignment(statusMessageLabel, Alignment.BOTTOM_RIGHT);

        mainLayout.setComponentAlignment(toolBar, Alignment.TOP_RIGHT);

        updateToolBarVisibility();

    }

    protected VerticalLayout getMainLayout() {

        return mainLayout;

    }

    protected Layout getFieldLayout() {

        return fieldLayout;

    }

    /**

     * @return

     */

    private GridLayout gridLayout() {

        if(_gridLayoutCache == null){

            if(fieldLayout instanceof GridLayout){

                _gridLayoutCache = (GridLayout)fieldLayout;

            } else {

                throw new RuntimeException("The fieldlayout of this editor is not a GridLayout");

            }

        }

        return _gridLayoutCache;

    }

    @Override

    public void setReadOnly(boolean readOnly) {

        super.setReadOnly(readOnly);

        if(readOnly){

            statusMessageLabel.setValue(READ_ONLY_MESSAGE_TEXT);

            statusMessageLabel.addStyleName(ValoTheme.LABEL_COLORED);

        } else {

            statusMessageLabel.setValue(null);

        }

        statusMessageLabel.setVisible(readOnly);

        save.setVisible(!readOnly);

        delete.setVisible(!readOnly);

        cancel.setCaption(readOnly ? "Close" : "Cancel");

        recursiveReadonly(readOnly, (AbstractComponentContainer)getFieldLayout());

    }

    /**

     * @param readOnly

     * @param layout

     */

    protected void recursiveReadonly(boolean readOnly, AbstractComponentContainer layout) {

        for(Component c : layout){

            c.setReadOnly(readOnly);

            if(c instanceof AbstractComponentContainer){

                recursiveReadonly(readOnly, (AbstractComponentContainer)c);

            }

        }

    }

    /**

     * @return

     * @return

     */

    protected AbstractLayout getToolBar() {

        return toolBar;

    }

    /**

     * @return

     * @return

     */

    protected void toolBarAdd(Component c) {

        toolBar.addComponent(c, toolBar.getComponentIndex(toolBarButtonGroup) - 1);

        updateToolBarVisibility();

    }

    /**

     * @return

     * @return

     */

    protected void toolBarButtonGroupAdd(Component c) {

        toolBarButtonGroup.addComponent(c);

        updateToolBarVisibility();

    }

    /**

     * @return

     * @return

     */

    protected void toolBarButtonGroupRemove(Component c) {

        toolBarButtonGroup.removeComponent(c);

        updateToolBarVisibility();

    }

    /**

     *

     */

    private void updateToolBarVisibility() {

        boolean showToolbar = toolBarButtonGroup.getComponentCount() + toolBar.getComponentCount() > 1;

        toolBar.setVisible(toolBarButtonGroup.getComponentCount() + toolBar.getComponentCount() > 1);

        if(!showToolbar){

            mainLayout.setMargin(new MarginInfo(true, false, false, false));

        } else {

            mainLayout.setMargin(false);

        }

    }

    /**

     * The top tool-bar is initially invisible.

     *

     * @param visible

     */

    protected void setToolBarVisible(boolean visible){

        toolBar.setVisible(true);

    }

    /**

     * @return the isAdvancedMode

     */

    public boolean isAdvancedMode() {

        return isAdvancedMode;

    }

    /**

     * @param isAdvancedMode the isAdvancedMode to set

     */

    public void setAdvancedMode(boolean isAdvancedMode) {

        this.isAdvancedMode = isAdvancedMode;

        advancedModeComponents.forEach(c -> c.setVisible(isAdvancedMode));

    }

    public void setAdvancedModeEnabled(boolean activate){

        if(activate && advancedModeButton == null){

            advancedModeButton = new Button(FontAwesome.WRENCH); // FontAwesome.FLASK

            advancedModeButton.setIconAlternateText("Advanced mode");

            advancedModeButton.addStyleName(ValoTheme.BUTTON_TINY);

            toolBarButtonGroupAdd(advancedModeButton);

            advancedModeButton.addClickListener(e -> {

                setAdvancedMode(!isAdvancedMode);

                }

            );

        } else if(advancedModeButton != null) {

            toolBarButtonGroupRemove(advancedModeButton);

            advancedModeButton = null;

        }

    }

    public void registerAdvancedModeComponents(Component ... c){

        advancedModeComponents.addAll(Arrays.asList(c));

    }

    // ------------------------ event handler ------------------------ //

    private class SaveHandler implements CommitHandler {

        private static final long serialVersionUID = 2047223089707080659L;

        @Override

        public void preCommit(CommitEvent commitEvent) throws CommitException {

            logger.debug("preCommit(), publishing EditorPreSaveEvent");

            // notify the presenter to start a transaction

            viewEventBus.publish(this, new EditorPreSaveEvent<DTO>(AbstractPopupEditor.this, getBean()));

        }

        @Override

        public void postCommit(CommitEvent commitEvent) throws CommitException {

            try {

                if(logger.isTraceEnabled()){

                    logger.trace("postCommit() publishing EditorSaveEvent for " + getBean().toString());

                }

                // notify the presenter to persist the bean and to commit the transaction

                viewEventBus.publish(this, new EditorSaveEvent<DTO>(AbstractPopupEditor.this, getBean()));

                if(logger.isTraceEnabled()){

                    logger.trace("postCommit() publishing DoneWithPopupEvent");

                }

                // notify the NavigationManagerBean to close the window and to dispose the view

                viewEventBus.publish(EventScope.UI, this, new DoneWithPopupEvent(AbstractPopupEditor.this, Reason.SAVE));

            } catch (Exception e) {

                logger.error(e);

                throw new CommitException("Failed to store data to backend", e);

            }

        }

    }

    protected void addCommitHandler(CommitHandler commitHandler) {

        fieldGroup.addCommitHandler(commitHandler);

    }

    protected void cancelEditorDialog(){

        if(fieldGroup.isModified()){

            ContinueAlternativeCancelDialog editorModifiedDialog = new ContinueAlternativeCancelDialog(

                    "Cancel editor",

                    "<p>The editor has been modified.<br>Do you want to save your changes or discard them?<p>",

                    "Discard",

                    "Save");

            ClickListener saveListener = e -> {editorModifiedDialog.close(); save();};

            ClickListener discardListener = e -> {editorModifiedDialog.close(); cancel();};

            ClickListener cancelListener = e -> editorModifiedDialog.close();

            editorModifiedDialog.addAlternativeClickListener(saveListener);

            editorModifiedDialog.addContinueClickListener(discardListener);

            editorModifiedDialog.addCancelClickListener(cancelListener);

            UI.getCurrent().addWindow(editorModifiedDialog);

        } else {

            cancel();

        }

    }

    /**

     * Cancel editing and discard all modifications.

     */

    @Override

    public void cancel() {

        fieldGroup.discard();

        viewEventBus.publish(EventScope.UI, this, new DoneWithPopupEvent(this, Reason.CANCEL));

    }

    /**

     * @return

     */

    private void delete() {

        viewEventBus.publish(this, new EditorDeleteEvent<DTO>(this, fieldGroup.getItemDataSource().getBean()));

        viewEventBus.publish(EventScope.UI, this, new DoneWithPopupEvent(this, Reason.DELETE));

    }

    /**

     * Save the changes made in the editor.

     */

    private void save() {

        try {

            fieldGroup.commit();

        } catch (CommitException e) {

            fieldGroup.getFields().forEach(f -> ((AbstractField<?>)f).setValidationVisible(true));

            Throwable cause = e.getCause();

            while(cause != null) {

                if(cause instanceof FieldGroupInvalidValueException){

                    FieldGroupInvalidValueException invalidValueException = (FieldGroupInvalidValueException)cause;

                    updateFieldNotifications(invalidValueException.getInvalidFields());

                    int invalidFieldsCount = invalidValueException.getInvalidFields().size();

                    Notification.show("The entered data in " + invalidFieldsCount + " field" + (invalidFieldsCount > 1 ? "s": "") + " is incomplete or invalid.");

                    break;

                } else if(cause instanceof PermissionDeniedException){

                    PermissionDeniedException permissionDeniedException = (PermissionDeniedException)cause;

                    Notification.show("Permission denied", permissionDeniedException.getMessage(), Type.ERROR_MESSAGE);

                    break;

                }

                cause = cause.getCause();

            }

            if(cause == null){

                // no known exception type found

                throw new PopupEditorException("Error saving popup editor", this, e);

            }

        }

    }

    /**

     * @param invalidFields

     */

    private void updateFieldNotifications(Map<Field<?>, InvalidValueException> invalidFields) {

        for(Field<?> f : invalidFields.keySet()){

            if(f instanceof AbstractField){

                String message = invalidFields.get(f).getHtmlMessage();

                ((AbstractField)f).setComponentError(new UserError(message, ContentMode.HTML, ErrorLevel.ERROR));

            }

        }

    }

    // ------------------------ field adding methods ------------------------ //

    protected TextField addTextField(String caption, String propertyId) {

        return addField(new TextFieldNFix(caption), propertyId);

    }

    protected TextField addTextField(String caption, String propertyId, int column1, int row1,

            int column2, int row2)

            throws OverlapsException, OutOfBoundsException {

        return addField(new TextFieldNFix(caption), propertyId, column1, row1, column2, row2);

    }

    protected TextField addTextField(String caption, String propertyId, int column, int row)

            throws OverlapsException, OutOfBoundsException {

        return addField(new TextFieldNFix(caption), propertyId, column, row);

    }

    protected SwitchableTextField addSwitchableTextField(String caption, String textPropertyId, String switchPropertyId, int column1, int row1,

            int column2, int row2)

            throws OverlapsException, OutOfBoundsException {

        SwitchableTextField field = new SwitchableTextField(caption);

        field.bindTo(fieldGroup, textPropertyId, switchPropertyId);

        addComponent(field, column1, row1, column2, row2);

        return field;

    }

    protected SwitchableTextField addSwitchableTextField(String caption, String textPropertyId, String switchPropertyId, int column, int row)

            throws OverlapsException, OutOfBoundsException {

        SwitchableTextField field = new SwitchableTextField(caption);

        field.bindTo(fieldGroup, textPropertyId, switchPropertyId);

        addComponent(field, column, row);

        return field;

    }

    protected PopupDateField addDateField(String caption, String propertyId) {

        return addField(new PopupDateField(caption), propertyId);

    }

    protected CheckBox addCheckBox(String caption, String propertyId) {

        return addField(new CheckBox(caption), propertyId);

    }

    protected CheckBox addCheckBox(String caption, String propertyId, int column, int row){

        return addField(new CheckBox(caption), propertyId, column, row);

    }

    protected <T extends Field> T addField(T field, String propertyId) {

        fieldGroup.bind(field, propertyId);

        if(NestedFieldGroup.class.isAssignableFrom(field.getClass())){

            ((NestedFieldGroup)field).registerParentFieldGroup(fieldGroup);

        }

        addComponent(field);

        return field;

    }

    /**

     * Can only be used if the <code>fieldlayout</code> is a GridLayout.

     *

     * @param field

     *            the field to be added, not <code>null</code>.

     * @param propertyId

     * @param column

     *            the column index, starting from 0.

     * @param row

     *            the row index, starting from 0.

     * @throws OverlapsException

     *             if the new component overlaps with any of the components

     *             already in the grid.

     * @throws OutOfBoundsException

     *             if the cell is outside the grid area.

     */

    protected <T extends Field> T addField(T field, String propertyId, int column, int row)

            throws OverlapsException, OutOfBoundsException {

        fieldGroup.bind(field, propertyId);

        if(NestedFieldGroup.class.isAssignableFrom(field.getClass())){

            ((NestedFieldGroup)field).registerParentFieldGroup(fieldGroup);

        }

        addComponent(field, column, row);

        return field;

    }

    /**

     * Can only be used if the <code>fieldlayout</code> is a GridLayout.

     *

     * @param field

     * @param propertyId

     * @param column1

     * @param row1

     * @param column2

     * @param row2

     * @return

     * @throws OverlapsException

     * @throws OutOfBoundsException

     */

    protected <T extends Field> T addField(T field, String propertyId, int column1, int row1,

            int column2, int row2)

            throws OverlapsException, OutOfBoundsException {

        if(propertyId != null){

            fieldGroup.bind(field, propertyId);

            if(NestedFieldGroup.class.isAssignableFrom(field.getClass())){

                ((NestedFieldGroup)field).registerParentFieldGroup(fieldGroup);

            }

        }

        addComponent(field, column1, row1, column2, row2);

        return field;

    }

    protected Field<?> getField(Object propertyId){

        return fieldGroup.getField(propertyId);

    }

    public PropertyIdPath boundPropertyIdPath(Field<?> field){

        PropertyIdPath propertyIdPath = null;

        Object propertyId = fieldGroup.getPropertyId(field);

        if(propertyId == null){

            // not found in the editor field group. Maybe the field is bound to a nested fieldgroup?

            // 1. find the NestedFieldGroup implementations from the field up to the editor

            logger.setLevel(Level.DEBUG);

            PropertyIdPath nestedPropertyIds = new PropertyIdPath();

            Field parentField = field;

            HasComponents parentComponent = parentField.getParent();

            logger.debug("field: " + parentField.getClass().getSimpleName());

            while(parentComponent != null){

                logger.debug("parentComponent: " + parentComponent.getClass().getSimpleName());

                if(NestedFieldGroup.class.isAssignableFrom(parentComponent.getClass()) && AbstractField.class.isAssignableFrom(parentComponent.getClass())){

                    Object propId = ((NestedFieldGroup)parentComponent).getFieldGroup().getPropertyId(parentField);

                    if(propId != null){

                        logger.debug("propId: " + propId.toString());

                        nestedPropertyIds.addParent(propId);

                    }

                    logger.debug("parentField: " + parentField.getClass().getSimpleName());

                    parentField = (Field)parentComponent;

                } else if(parentComponent == this) {

                    // we reached the editor itself

                    Object propId = fieldGroup.getPropertyId(parentField);

                    if(propId != null){

                        logger.debug("propId: " + propId.toString());

                        nestedPropertyIds.addParent(propId);

                    }

                    propertyIdPath = nestedPropertyIds;

                    break;

                }

                parentComponent = parentComponent.getParent();

            }

            // 2. check the NestedFieldGroup binding the field is direct or indirect child component of the editor

//            NO lONGER NEEDED

//            parentComponent = parentField.getParent(); // get component containing the last parent field found

//            while(true){

//                if(parentComponent == getFieldLayout()){

//                    propertyIdPath = nestedPropertyIds;

//                    break;

//                }

//                parentComponent = parentComponent.getParent();

//            }

        } else {

            propertyIdPath = new PropertyIdPath(propertyId);

        }

        return propertyIdPath;

    }

    protected void addComponent(Component component) {

        fieldLayout.addComponent(component);

        applyDefaultComponentStyles(component);

    }

    protected void bindField(Field field, String propertyId){

        fieldGroup.bind(field, propertyId);

    }

    protected void unbindField(Field field){

        fieldGroup.unbind(field);

    }

    /**

     * @param component

     */

    public void applyDefaultComponentStyles(Component component) {

        component.addStyleName(getDefaultComponentStyles());

    }

    protected abstract String getDefaultComponentStyles();

    /**

     * Can only be used if the <code>fieldlayout</code> is a GridLayout.

     * <p>

     * Adds the component to the grid in cells column1,row1 (NortWest corner of

     * the area.) End coordinates (SouthEast corner of the area) are the same as

     * column1,row1. The coordinates are zero-based. Component width and height

     * is 1.

     *

     * @param component

     *            the component to be added, not <code>null</code>.

     * @param column

     *            the column index, starting from 0.

     * @param row

     *            the row index, starting from 0.

     * @throws OverlapsException

     *             if the new component overlaps with any of the components

     *             already in the grid.

     * @throws OutOfBoundsException

     *             if the cell is outside the grid area.

     */

    public void addComponent(Component component, int column, int row)

            throws OverlapsException, OutOfBoundsException {

        applyDefaultComponentStyles(component);

        gridLayout().addComponent(component, column, row, column, row);

    }

    /**

     * Can only be used if the <code>fieldlayout</code> is a GridLayout.

     * <p>

     * Adds a component to the grid in the specified area. The area is defined

     * by specifying the upper left corner (column1, row1) and the lower right

     * corner (column2, row2) of the area. The coordinates are zero-based.

     * </p>

     *

     * <p>

     * If the area overlaps with any of the existing components already present

     * in the grid, the operation will fail and an {@link OverlapsException} is

     * thrown.

     * </p>

     *

     * @param component

     *            the component to be added, not <code>null</code>.

     * @param column1

     *            the column of the upper left corner of the area <code>c</code>

     *            is supposed to occupy. The leftmost column has index 0.

     * @param row1

     *            the row of the upper left corner of the area <code>c</code> is

     *            supposed to occupy. The topmost row has index 0.

     * @param column2

     *            the column of the lower right corner of the area

     *            <code>c</code> is supposed to occupy.

     * @param row2

     *            the row of the lower right corner of the area <code>c</code>

     *            is supposed to occupy.

     * @throws OverlapsException

     *             if the new component overlaps with any of the components

     *             already in the grid.

     * @throws OutOfBoundsException

     *             if the cells are outside the grid area.

     */

    public void addComponent(Component component, int column1, int row1,

            int column2, int row2)

            throws OverlapsException, OutOfBoundsException {

        applyDefaultComponentStyles(component);

        gridLayout().addComponent(component, column1, row1, column2, row2);

    }

    public void setSaveButtonEnabled(boolean enabled){

        save.setEnabled(enabled);

    }

    public void withDeleteButton(boolean withDelete){

        if(withDelete){

            buttonLayout.setExpandRatio(save, 0);

            buttonLayout.setExpandRatio(delete, 1);

        } else {

            buttonLayout.setExpandRatio(save, 1);

            buttonLayout.setExpandRatio(delete, 0);

        }

        delete.setVisible(withDelete);

    }

    public boolean addStatusMessage(String message){

        boolean returnVal = statusMessages.add(message);

        updateStatusLabel();

        return returnVal;

    }

    public boolean removeStatusMessage(String message){

        boolean returnVal = statusMessages.remove(message);

        updateStatusLabel();

        return returnVal;

    }

    /**

     *

     */

    private void updateStatusLabel() {

        String text = "";

        for(String s : statusMessages){

            text += s + " ";

        }

        statusMessageLabel.setValue(text);

        statusMessageLabel.setVisible(!text.isEmpty());

        statusMessageLabel.addStyleName(ValoTheme.LABEL_COLORED);

    }

    private void updateContextBreadcrumbs() {

        List<EditorActionContext> contextInfo = new ArrayList<>(getEditorActionContext());

        String breadcrumbs = "";

        EditorActionContextFormatter formatter = new EditorActionContextFormatter();

        GenericFontIcon operationPrefixIcon = new GenericFontIcon("IcoMoon", 0xe902);

        GenericFontIcon operationSuffxIcon = new GenericFontIcon("IcoMoon", 0xe901);

        int cnt = 0;

        for(EditorActionContext cntxt : contextInfo){

            cnt++;

            boolean isLast = cnt == contextInfo.size();

            boolean isFirst = cnt == 1;

            boolean doClass = false; // will be removed in future

            boolean classNameForMissingPropertyPath = true; // !doClass;

            boolean doProperties = true;

            boolean doCreateOrNew = !isFirst;

            String contextmarkup = formatter.format(

                    cntxt,

                    new EditorActionContextFormat(doClass, doProperties, classNameForMissingPropertyPath, doCreateOrNew,

                            EditorActionContextFormat.TargetInfoType.FIELD_CAPTION, (isLast ? "active" : ""))

                    );

//            if(!isLast){

//                contextmarkup += " " + FontAwesome.ANGLE_RIGHT.getHtml() + " ";

//            }

            if(isLast){

                contextmarkup = "<li><span class=\"crumb active\">" + contextmarkup + "</span></li>";

            } else {

                contextmarkup = "<li><span class=\"crumb\">" + contextmarkup + "</span></li>";

            }

            breadcrumbs += contextmarkup;

        }

        contextBreadcrumbsLabel.setValue("<ul class=\"breadcrumbs\">" + breadcrumbs + "</ul>");

    }

    // ------------------------ data binding ------------------------ //

    protected void bindDesign(Component component) {

        fieldLayout.removeAllComponents();

        fieldGroup.bindMemberFields(component);

        fieldLayout.addComponent(component);

    }

    public final void loadInEditor(Object identifier) {

        DTO beanToEdit = getPresenter().loadBeanById(identifier);

        fieldGroup.setItemDataSource(beanToEdit);

        afterItemDataSourceSet();

        getPresenter().onViewFormReady(beanToEdit);

        updateContextBreadcrumbs();

        isBeanLoaded = true;

    }

    /**

     * Passes the beanInstantiator to the presenter method {@link AbstractEditorPresenter#setBeanInstantiator(BeanInstantiator)}

     *

     * @param beanInstantiator

     */

    public final void setBeanInstantiator(BeanInstantiator<DTO> beanInstantiator) {

        if(AbstractCdmEditorPresenter.class.isAssignableFrom(getPresenter().getClass())){

            ((CdmEditorPresenterBase)getPresenter()).setBeanInstantiator(beanInstantiator);

        } else {

            throw new RuntimeException("BeanInstantiator can only be set for popup editors with a peresenter of the type CdmEditorPresenterBase");

        }

    }

    /**

     * Returns the bean contained in the itemDatasource of the fieldGroup.

     *

     * @return

     */

    public DTO getBean() {

        if(fieldGroup.getItemDataSource() != null){

            return fieldGroup.getItemDataSource().getBean();

        }

        return null;

    }

    /**

     * @return true once the bean has been loaded indicating that all fields have

     *   been setup configured so that the editor is ready for use.

     */

    public boolean isBeanLoaded() {

        return isBeanLoaded;

    }

    /**

     * This method should only be used by the presenter of this view

     *

     * @param bean

     */

    protected void updateItemDataSource(DTO bean) {

        fieldGroup.getItemDataSource().setBean(bean);

    }

    /**

     * This method is called after setting the item data source whereby the

     * {@link FieldGroup#configureField(Field<?> field)} method will be called.

     * In this method all fields are set to default states defined for the fieldGroup.

     * <p>

     * You can now implement this method if you need to modify the state or value of individual fields.

     */

    protected void afterItemDataSourceSet() {

        if(editorComponentsConfigurator != null){

            editorComponentsConfigurator.updateComponentStates(this);

        }

    }

    // ------------------------ issue related temporary solutions --------------------- //

    /**

     * Publicly accessible equivalent to getPreseneter(), needed for

     * managing the presenter listeners.

     * <p>

     * TODO: refactor the presenter listeners management to get rid of this method

     *

     * @return

     * @deprecated marked deprecated to emphasize on the special character of this method