/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License (the "License").
 * You may not use this file except in compliance with the License.
 *
 * See LICENSE.txt included in this distribution for the specific
 * language governing permissions and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at LICENSE.txt.
 * If applicable, add the following below this CDDL HEADER, with the
 * fields enclosed by brackets "[]" replaced with your own identifying
 * information: Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 */

/*
 * Copyright (c) 2011 Jens Elkner.
 * Copyright (c) 2011, Oracle and/or its affiliates. All rights reserved.
 */
package org.opensolaris.opengrok.web;

import java.util.Map;
import java.util.TreeMap;

/**
 * URL Prefixes usually tied to a certain servlet.
 *
 * @author  Jens Elkner
 * @version $Revision$
 */
public enum Prefix {
    /** unknown prefix */
    UNKNOWN(""),
    /** a cross reference */
    XREF_P("/xref"),
    /** show more lines. If a search result set for a file matches more lines
     * than a given limit (default: 10), only the first <i>limit</i> lines gets
     * shown as well as an "[all ...]" link, which can be used to show all 
     * matching lines. The servlet path of this link starts with this prefix. */
    MORE_P("/more"),
    /** diff to previous version (link prefix) */
    DIFF_P("/diff"),
    /** show the history for a file (link prefix) */
    HIST_L("/history"),
    /** RSS XML Feed of latest changes (link prefix) */
    RSS_P("/rss"),
    /** Download file (link prefix) */
    RAW_P("/raw"),
    /** full blown search from main page or top bar (link prefix) */
    SEARCH_P("/search"),
    /** search from cross reference, can lead to direct match (which opens
     * directly) or to a matches Summary page */
    SEARCH_R("/s"),
    /** opensearch description page */
    SEARCH_O("/opensearch"),
    /** related source file or directory not found/unavailable/ignored */
    NOT_FOUND("/enoent"),
    /** misc error occurred */
    ERROR("/error"),
    /** fetch annotations for the request path */
    JSON_A("/json/annotate")
    ;
    private String prefix;
    private Prefix(String prefix) {
        this.prefix = prefix;
    }

    /**
     * Get the string used as prefix.
     * @return the prefix
     */
    @Override
    public String toString() {
        return prefix;
    }

    // should be sufficient for now
    private static Map<String, Prefix> lookupTable;
    static {
        lookupTable = new TreeMap<String, Prefix>();
        for (Prefix p : Prefix.values()) {
            lookupTable.put(p.toString(), p);
        }
    }

    /**
     * Get the prefix of the given path.
     * @param servletPath  path to check
     * @return {@link Prefix#UNKNOWN} if <var>path</var> is {@code null} or has
     *  no or unknown prefix, the corresponding prefix otherwise.
     * @see #toString()
     */
    public static Prefix get(String servletPath) {
        if (servletPath == null || servletPath.length() < 3
            || servletPath.charAt(0) != '/')
        {
            return UNKNOWN;
        }
        int idx = servletPath.indexOf('/', 1);
        String pathPrefix = (idx == -1) ?
                servletPath : servletPath.substring(0, idx);
        Prefix p = lookupTable.get(pathPrefix);
        return p == null ? UNKNOWN : p;
    }
}