/**
    * This file Copyright (c) 2012-2018 Magnolia International
    * Ltd.  (http://www.magnolia-cms.com). All rights reserved.
    *
    *
    * This file is dual-licensed under both the Magnolia
    * Network Agreement and the GNU General Public License.
    * You may elect to use one or the other of these licenses.
    *
   * This file is distributed in the hope that it will be
   * useful, but AS-IS and WITHOUT ANY WARRANTY; without even the
   * implied warranty of MERCHANTABILITY or FITNESS FOR A
   * PARTICULAR PURPOSE, TITLE, or NONINFRINGEMENT.
   * Redistribution, except as permitted by whichever of the GPL
   * or MNA you select, is prohibited.
   *
   * 1. For the GPL license (GPL), you can redistribute and/or
   * modify this file under the terms of the GNU General
   * Public License, Version 3, as published by the Free Software
   * Foundation.  You should have received a copy of the GNU
   * General Public License, Version 3 along with this program;
   * if not, write to the Free Software Foundation, Inc., 51
   * Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
   *
   * 2. For the Magnolia Network Agreement (MNA), this file
   * and the accompanying materials are made available under the
   * terms of the MNA which accompanies this distribution, and
   * is available at http://www.magnolia-cms.com/mna.html
   *
   * Any modifications to this file must keep this entire header
   * intact.
   *
   */
  package info.magnolia.ui.contentapp.browser;
  
  import info.magnolia.event.EventBus;
  import info.magnolia.ui.actionbar.ActionbarPresenter;
  import info.magnolia.ui.actionbar.definition.ActionbarDefinition;
  import info.magnolia.ui.actionbar.definition.ActionbarGroupDefinition;
  import info.magnolia.ui.actionbar.definition.ActionbarItemDefinition;
  import info.magnolia.ui.actionbar.definition.ActionbarSectionDefinition;
  import info.magnolia.ui.api.action.ActionDefinition;
  import info.magnolia.ui.api.action.ActionExecutor;
  import info.magnolia.ui.api.app.SubAppContext;
  import info.magnolia.ui.api.app.SubAppEventBus;
  import info.magnolia.ui.api.availability.AvailabilityChecker;
  import info.magnolia.ui.api.availability.AvailabilityDefinition;
  import info.magnolia.ui.api.event.AdmincentralEventBus;
  import info.magnolia.ui.api.location.Location;
  import info.magnolia.ui.api.location.LocationChangedEvent;
  import info.magnolia.ui.contentapp.ContentSubAppView;
  import info.magnolia.ui.framework.app.BaseSubApp;
  import info.magnolia.ui.vaadin.actionbar.ActionPopup;
  import info.magnolia.ui.vaadin.integration.contentconnector.ContentConnector;
  import info.magnolia.ui.workbench.event.ItemRightClickedEvent;
  import info.magnolia.ui.workbench.event.SearchEvent;
  import info.magnolia.ui.workbench.event.SelectionChangedEvent;
  import info.magnolia.ui.workbench.event.ViewTypeChangedEvent;
  import info.magnolia.ui.workbench.search.SearchPresenterDefinition;
  
  import java.util.Arrays;
  import java.util.Iterator;
  import java.util.List;
  import java.util.Set;
  
  import javax.inject.Inject;
  import javax.inject.Named;
  
  import org.apache.commons.lang3.StringUtils;
  import org.slf4j.Logger;
  import org.slf4j.LoggerFactory;
  
  import com.vaadin.ui.MenuBar.MenuItem;
  import com.vaadin.server.ExternalResource;
  
  /**
   * Base implementation of a content subApp. A content subApp displays a collection of data represented inside a {@link info.magnolia.ui.workbench.ContentView} created by the {@link info.magnolia.ui.workbench.WorkbenchPresenter}.
   *
   * <pre>
   *  <p>
   *      This class Provides sensible implementation for services shared by all content subApps.
   *      Out-of-the-box it will handle the following:
   *  </p>
   *
   *  <ul>
   *      <li>location updates when switching views, selecting items or performing searches: see {@link #locationChanged(Location)}
   *      <li>restoring the browser app status when i.e. coming from a bookmark: see {@link #start(Location)}
   *  </ul>
   * In order to perform those tasks this class registers non-overridable handlers for the following events:
   *  <ul>
   *      <li> {@link SelectionChangedEvent}
   *      <li> {@link ViewTypeChangedEvent}
   *      <li> {@link SearchEvent}
   *  </ul>
   * Subclasses can augment the default behavior and perform additional tasks by overriding the following methods:
   *  <ul>
   *      <li>{@link #onSubAppStart()}
   *      <li>{@link #locationChanged(Location)}
   *      <li>{@link #updateActionbar(ActionbarPresenter)}
  *  </ul>
  * </pre>
  *
  *
  * @deprecated since 6.2 - use {@link info.magnolia.ui.contentapp.ContentBrowserSubApp} instead.
  *
  * @see <a href="https://documentation.magnolia-cms.com/display/DOCS62/Upgrading+to+Magnolia+6.2.x">Upgrading to Magnolia 6.2.x</a>
  *
  * @see BrowserPresenter
  * @see info.magnolia.ui.contentapp.ContentSubAppView
  * @see info.magnolia.ui.contentapp.ContentApp
  * @see BrowserLocation
  */
 @Deprecated
 public class BrowserSubApp extends BaseSubApp<ContentSubAppView> {
 
     private static final Logger log = LoggerFactory.getLogger(BrowserSubApp.class);
 
     private final BrowserPresenter browser;
     private final EventBus subAppEventBus;
     private ActionExecutor actionExecutor;
     protected ContentConnector contentConnector;
     private AvailabilityChecker checker;
 
     @Inject
     public BrowserSubApp(ActionExecutor actionExecutor, final SubAppContext subAppContext, final ContentSubAppView view, final BrowserPresenter browser, final @Named(SubAppEventBus.NAME) EventBus subAppEventBus, @Named(AdmincentralEventBus.NAME) EventBus adminCentralEventBus, ContentConnector contentConnector, AvailabilityChecker checker) {
         super(subAppContext, view);
         this.checker = checker;
         if (subAppContext == null || view == null || browser == null || subAppEventBus == null) {
             throw new IllegalArgumentException("Constructor does not allow for null args. Found SubAppContext = " + subAppContext + ", ContentSubAppView = " + view + ", BrowserPresenter = " + browser + ", EventBus = " + subAppEventBus);
         }
         this.browser = browser;
         this.subAppEventBus = subAppEventBus;
         this.actionExecutor = actionExecutor;
         this.contentConnector = contentConnector;
 
 
         /**
          * Would be clearer if we'd track {@link info.magnolia.ui.api.app.AppLifecycleEventType#FOCUSED},
          * but it is not reliable enough (not fired in some essential cases, see issue MGNLUI-2988 for more details).
          * @see <a href="http://jira.magnolia-cms.com/browse/MGNLUI-2988"/>
          */
         adminCentralEventBus.addHandler(LocationChangedEvent.class, new LocationChangedEvent.Handler() {
             @Override
             public void onLocationChanged(LocationChangedEvent event) {
                 /**
                  * If the new location actually points to this sub-app then we refresh it in order to avoid
                  * synchronisation issues caused by the changes in the data-source that were not propagated to
                  * underlying Vaadin containers of the browser.
                  */
                 if (event.getNewLocation().equals(getCurrentLocation())) {
                         restoreBrowser(getCurrentLocation());
                 }
             }
         });
     }
 
     /**
      * Performs some routine tasks needed by all content subapps before the view is displayed.
      * The tasks are:
      * <ul>
      * <li>setting the current location
      * <li>setting the browser view
      * <li>restoring the browser status: see {@link #restoreBrowser(BrowserLocation)}
      * <li>calling {@link #onSubAppStart()} a hook-up method subclasses can override to perform additional work.
      * </ul>
      */
     @Override
     public ContentSubAppView start(final Location location) {
         BrowserLocation l = BrowserLocation.wrap(location);
         super.start(l);
         getView().setContentView(browser.start());
         restoreBrowser(l);
         registerSubAppEventsHandlers(subAppEventBus);
 
         return getView();
     }
 
     /**
      * Restores the browser status based on the information available in the location object. This is used e.g. when starting a subapp based on a
      * bookmark. I.e. given a bookmark containing the following URI fragment
      * <p>
      * {@code
      * #app:myapp:browser;/foo/bar:list
      * }
      * <p>
      * this method will select the path <code>/foo/bar</code> in the workspace used by the app, set the view type as <code>list</code> and finally update the available actions.
      * <p>
      * In case of a search view the URI fragment will look similar to the following one {@code
      * #app:myapp:browser;/:search:qux
      * }
      * <p>
      * then this method will select the root path, set the view type as <code>search</code>, perform a search for "qux" in the workspace used by the app and finally update the available actions.
      *
      * @see BrowserSubApp#updateActionbar(info.magnolia.ui.actionbar.ActionbarPresenter)
      * @see BrowserSubApp#start(Location)
      * @see Location
      */
     protected void restoreBrowser(final BrowserLocation location) {
         String path = location.getNodePath();
         String viewType = location.getViewType();
 
         if (!getBrowser().hasViewType(viewType)) {
             if (!StringUtils.isBlank(viewType)) {
                 log.warn("Unknown view type [{}], returning to default view type.", viewType);
             }
             viewType = getBrowser().getDefaultViewType();
             location.updateViewType(viewType);
             getAppContext().updateSubAppLocation(getSubAppContext(), location);
         }
         String query = location.getQuery();
 
         Object itemId = contentConnector.getItemIdByUrlFragment(path);
 
         // MGNLUI-1475: item might have not been found if path doesn't exist
         if (!contentConnector.canHandleItem(itemId)) {
             itemId = contentConnector.getDefaultItemId();
             BrowserLocation newLocation = getCurrentLocation();
             newLocation.updateNodePath("/");
             getAppContext().updateSubAppLocation(getSubAppContext(), newLocation);
         }
 
         getBrowser().resync(Arrays.asList(itemId), viewType, query);
         updateActionbar(getBrowser().getActionbarPresenter());
     }
 
 
     /**
      * Show the actionPopup for the specified item at the specified coordinates.
      */
     public void showActionPopup(Object itemId, int x, int y) {
 
         // If there's no actionbar configured we don't want to show an empty action popup
         BrowserSubAppDescriptora/ui/contentapp/browser/BrowserSubAppDescriptor.html#BrowserSubAppDescriptor">BrowserSubAppDescriptor subAppDescriptor = (BrowserSubAppDescriptor) getSubAppContext().getSubAppDescriptor();
         ActionbarDefinition actionbarDefinition = subAppDescriptor.getActionbar();
         if (actionbarDefinition == null) {
             return;
         }
 
         ActionPopup actionPopup = browser.getView().getActionPopup();
 
         updateActionPopup(actionPopup);
         actionPopup.open(x, y);
     }
 
     /**
      * Update the items in the actionPopup based on the selected item and the ActionPopup availability configuration.
      * This method can be overriden to implement custom conditions diverging from {@link #updateActionbar(info.magnolia.ui.actionbar.ActionbarPresenter)}.
      */
     private void updateActionPopup(ActionPopup actionPopup) {
 
         actionPopup.removeItems();
 
         BrowserSubAppDescriptora/ui/contentapp/browser/BrowserSubAppDescriptor.html#BrowserSubAppDescriptor">BrowserSubAppDescriptor subAppDescriptor = (BrowserSubAppDescriptor) getSubAppContext().getSubAppDescriptor();
         ActionbarDefinition actionbarDefinition = subAppDescriptor.getActionbar();
         if (actionbarDefinition == null) {
             return;
         }
         List<ActionbarSectionDefinition> sections = actionbarDefinition.getSections();
 
         // Figure out which section to show, only one
         ActionbarSectionDefinition sectionDefinition = getVisibleSection(sections);
 
         // If there no section matched the selection we just hide everything
         if (sectionDefinition == null) {
             return;
         }
 
         // Evaluate availability of each action within the section
         for (final Iterator<ActionbarGroupDefinition> groupDefinitionIterator = sectionDefinition.getGroups().iterator(); groupDefinitionIterator.hasNext();) {
             final ActionbarGroupDefinition groupDefinition = groupDefinitionIterator.next();
             for (ActionbarItemDefinition itemDefinition : groupDefinition.getItems()) {
 
                 final String actionName = itemDefinition.getName();
                 final MenuItem menuItem = addActionPopupItem(subAppDescriptor, itemDefinition);
                 ActionDefinition actionDefinition = actionExecutor.getActionDefinition(actionName);
                 if (actionDefinition != null) {
                     AvailabilityDefinition availability = actionDefinition.getAvailability();
                     menuItem.setEnabled(checker.isAvailable(availability, browser.getSelectedItemIds()));
                 }
             }
 
             // Add group separator.
             if (groupDefinitionIterator.hasNext()) {
                 getBrowser().getView().getActionPopup().addSeparator();
             }
         }
     }
 
     /**
      * Add an additional menu item on the actionPopup.
      */
     private MenuItem addActionPopupItem(BrowserSubAppDescriptor subAppDescriptor, ActionbarItemDefinition itemDefinition) {
         String actionName = itemDefinition.getName();
 
         ActionDefinition action = subAppDescriptor.getActions().get(actionName);
         String label = action.getLabel();
         String iconFontCode = ActionPopup.ICON_FONT_CODE + action.getIcon();
         ExternalResource iconFontResource = new ExternalResource(iconFontCode);
 
         return getBrowser().getView().getActionPopup().addItem(label, iconFontResource, item -> getBrowser().onActionbarItemClicked(actionName));
     }
 
     /**
      * Update the items in the actionbar based on the selected item and the action availability configuration.
      * This method can be overriden to implement custom conditions diverging from {@link #updateActionPopup(info.magnolia.ui.vaadin.actionbar.ActionPopup)}.
      *
      * @see #restoreBrowser(BrowserLocation)
      * @see #locationChanged(Location)
      * @see info.magnolia.ui.actionbar.ActionbarPresenter
      */
     public void updateActionbar(ActionbarPresenter actionbar) {
 
         BrowserSubAppDescriptora/ui/contentapp/browser/BrowserSubAppDescriptor.html#BrowserSubAppDescriptor">BrowserSubAppDescriptor subAppDescriptor = (BrowserSubAppDescriptor) getSubAppContext().getSubAppDescriptor();
         ActionbarDefinition actionbarDefinition = subAppDescriptor.getActionbar();
         if (actionbarDefinition == null) {
             return;
         }
         List<ActionbarSectionDefinition> sections = actionbarDefinition.getSections();
         // Figure out which section to show, only one
         ActionbarSectionDefinition sectionDefinition = getVisibleSection(sections);
 
         // Hide all other sections
         for (ActionbarSectionDefinition section : sections) {
             actionbar.hideSection(section.getName());
         }
 
         if (sectionDefinition != null) {
             // Show our section
             actionbar.showSection(sectionDefinition.getName());
 
             // Evaluate availability of each action within the section
             for (ActionbarGroupDefinition groupDefinition : sectionDefinition.getGroups()) {
                 for (ActionbarItemDefinition itemDefinition : groupDefinition.getItems()) {
 
                     String actionName = itemDefinition.getName();
                     ActionDefinition actionDefinition = actionExecutor.getActionDefinition(actionName);
                     if (actionDefinition != null) {
                         AvailabilityDefinition availability = actionDefinition.getAvailability();
                         if (checker.isAvailable(availability, browser.getSelectedItemIds())) {
                             actionbar.enable(actionName);
                         } else {
                             actionbar.disable(actionName);
                         }
                     } else {
                         log.warn("Action bar expected an action named {}, but no such action is currently configured.", actionName);
                     }
                 }
             }
         }
     }
 
     private ActionbarSectionDefinition getVisibleSection(List<ActionbarSectionDefinition> sections) {
         for (ActionbarSectionDefinition section : sections) {
             if (isSectionVisible(section))
                 return section;
         }
         return null;
     }
 
     private boolean isSectionVisible(ActionbarSectionDefinition section) {
         return checker.isAvailable(section.getAvailability(), browser.getSelectedItemIds());
     }
 
     protected final BrowserPresenter getBrowser() {
         return browser;
     }
 
     /**
      * The default implementation selects the path in the current workspace and updates the available actions in the actionbar.
      */
     @Override
     public void locationChanged(final Location location) {
         super.locationChanged(location);
         restoreBrowser(BrowserLocation.wrap(location));
     }
 
     /**
      * Wraps the current DefaultLocation in a {@link BrowserLocation}. Providing getter and setters for used parameters.
      */
     @Override
     public BrowserLocation getCurrentLocation() {
         return BrowserLocation.wrap(super.getCurrentLocation());
     }
 
     /*
      * Registers general purpose handlers for the following events:
      * <ul>
      * <li> {@link ItemSelectedEvent}
      * <li> {@link ViewTypeChangedEvent}
      * <li> {@link SearchEvent}
      * </ul>
      */
     private void registerSubAppEventsHandlers(final EventBus subAppEventBus) {
         final ActionbarPresenter actionbar = getBrowser().getActionbarPresenter();
         subAppEventBus.addHandler(SelectionChangedEvent.class, new SelectionChangedEvent.Handler() {
 
             @Override
             public void onSelectionChanged(SelectionChangedEvent event) {
                 handleSelectionChange(event.getItemIds(), actionbar);
             }
         });
 
         subAppEventBus.addHandler(ItemRightClickedEvent.class, new ItemRightClickedEvent.Handler() {
 
             @Override
             public void onItemRightClicked(ItemRightClickedEvent event) {
                 showActionPopup(event.getItemId(), event.getClickX(), event.getClickY());
             }
         });
 
         subAppEventBus.addHandler(ViewTypeChangedEvent.class, new ViewTypeChangedEvent.Handler() {
 
             @Override
             public void onViewChanged(ViewTypeChangedEvent event) {
                 BrowserLocation location = getCurrentLocation();
                 // remove search term from fragment when switching back
                 if (location.getViewType().equals(SearchPresenterDefinition.VIEW_TYPE)
                         && !event.getViewType().equals(SearchPresenterDefinition.VIEW_TYPE)) {
                     location.updateQuery("");
                 }
                 location.updateViewType(event.getViewType());
                 getAppContext().updateSubAppLocation(getSubAppContext(), location);
                 updateActionbar(actionbar);
             }
         });
 
         subAppEventBus.addHandler(SearchEvent.class, new SearchEvent.Handler() {
 
             @Override
             public void onSearch(SearchEvent event) {
                 BrowserLocation location = getCurrentLocation();
                 if (StringUtils.isNotBlank(event.getSearchExpression())) {
                     location.updateViewType(SearchPresenterDefinition.VIEW_TYPE);
                 }
                 location.updateQuery(event.getSearchExpression());
                 getAppContext().updateSubAppLocation(getSubAppContext(), location);
                 updateActionbar(actionbar);
             }
         });
     }
 
     private void handleSelectionChange(Set<Object> selectionIds, ActionbarPresenter actionbar) {
         BrowserLocation location = getCurrentLocation();
         applySelectionToLocation(location, selectionIds.isEmpty() ? contentConnector.getDefaultItemId() : selectionIds.iterator().next());
         getAppContext().updateSubAppLocation(getSubAppContext(), location);
         updateActionbar(actionbar);
 
     }
 
     protected void applySelectionToLocation(BrowserLocation location, Object selectedId) {
         location.updateNodePath("");
         if (!contentConnector.canHandleItem(selectedId)) {
             // nothing is selected at the moment
         } else {
             location.updateNodePath(contentConnector.getItemUrlFragment(selectedId));
         }
     }
 }