/* * Copyright (c) 2015 Ziver * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package wa.server.page.struct; import java.util.*; /** * A class representing a navigation hierarchy/tree for a web application. * * Created by Ziver on 2015-04-02. */ public class WANavigation implements Iterable{ private static final String NAVIGATION_URL_KEY = "i"; private static int nextId = 0; private static HashMap navMap = new HashMap(); private final int id; private String url; private String name; private int weight; private WANavigation parentNav; private ArrayList subNav; private Object resource; private WANavigation(String name) { this.id = nextId++; this.navMap.put(this.id, this); this.url = "?"+NAVIGATION_URL_KEY+"="+this.id; this.name = name; this.subNav = new ArrayList<>(); } public List getSubNavs() { return subNav; } /** * Will create a new sub-nav if it does not already exist or return a existing one. */ public WANavigation createSubNav(String name) { WANavigation nav = getSubNav(name); if(nav != null) return nav; nav = new WANavigation(name); nav.setParentNav(this); subNav.add(nav); sortSubNavs(); return nav; } /** * Searches for and returns the specified sub-nav or returns null if it was not found. */ private WANavigation getSubNav(String name) { for(WANavigation nav : subNav) { if(nav.equals(name)) return nav; } return null; } private void sortSubNavs(){ Collections.sort(subNav, new Comparator() { @Override public int compare(WANavigation o1, WANavigation o2) { if (o1.weight == o2.weight) return o1.name.compareToIgnoreCase(o2.name); return o1.weight - o2.weight; } }); } @Override public Iterator iterator() { return subNav.iterator(); } public String getName(){ return name; } public String getUrl(){ return url; } private void setParentNav(WANavigation nav){ this.parentNav = nav; } /** * Assign a resource object specific to this navigation object. * This can be used if target page needs some additional information. */ public void setResource(Object obj){ resource = obj; } public Object getResource(){ return resource; } /** * Sets the weight of this navigation object. The weight is * used for deciding the order the parent will sort all sub navigation. * Lower values will be at the top of sub-nav list. */ public void setWeight(int weightOrder){ this.weight = weightOrder; if(parentNav != null) parentNav.sortSubNavs(); } @Override public boolean equals(Object o){ if(o instanceof String) return this.name.equals(o); return this == o || (o != null && this.id == (((WANavigation)o).id)); } /** * Will create a clone of the navigation tree with some request instance specific information */ public NavInstance createNavInstance(Map request){ return createNavInstance(getBreadcrumb(request)); } private NavInstance createNavInstance(List activeList){ NavInstance instance = new NavInstance(this); instance.setActive(activeList.contains(this)); for (WANavigation nav : subNav) instance.addSubNav(nav.createNavInstance(activeList)); return instance; } public static WANavigation createRootNav(){ return new WANavigation(null); } public static WANavigation getRootNav(Map request) { List breadcrumb = getBreadcrumb(request); if (!breadcrumb.isEmpty()) return breadcrumb.get(0); return null; } /** * @return the specific WANavigation object requested by client */ public static WANavigation getNavigation(Map request) { if(request.containsKey(NAVIGATION_URL_KEY)) return navMap.get(Integer.parseInt(request.get(NAVIGATION_URL_KEY))); return null; } /** * @param request A map of all url parameters sent from client * @return a List of WANavigation objects depicting the navigation hierarchy for the * requested page from the client. First entry will be the root navigation object. */ public static List getBreadcrumb(Map request) { LinkedList list = new LinkedList(); WANavigation current = getNavigation(request); if (current != null){ while(current != null){ list.addFirst(current); current = current.parentNav; } } return list; } public static class NavInstance{ private WANavigation nav; private boolean active; private ArrayList subNavs; protected NavInstance(WANavigation nav){ this.nav = nav; this.subNavs = new ArrayList<>(); } protected void setActive(boolean active){ this.active = active; } protected void addSubNav(NavInstance subNav){ subNavs.add(subNav); } public boolean isActive(){ return active; } public List getSubNavs() { return subNavs; } // Mirror getters from WANavigation public String getName(){ return nav.getName(); } public String getUrl(){ return nav.getUrl(); } public Object getResource(){ return nav.getResource(); } public boolean equals(Object o){ if (o instanceof WANavigation) return nav.equals(o); else if (o instanceof NavInstance) return nav.equals(((NavInstance) o).nav); return false; } } }