/*\
 * Copyright  2006 Klaus Rogall, Hamburg, Germany (klaus.rogall@web.de). All rights reserved.
 * _____________________________________________________________________________________________________________________
 * 
 * This class is "Open Source" as defined by the Open Source Initiative (OSI). You can redistribute it and/or modify it
 * under the terms of the BSD License. The license text is appended to the end of this file.
\*/

package de.klaro.base.util;

import javax.servlet.http.HttpServletRequest;


/**
 * Methoden zur Request-Verarbeitung.
 *
 * @see     java.lang.String
 */

public class Requests extends Object
{

    /* ______________________________________________________________________________________________________________ *\
    \* Konstanten                                                                                                     */


    /* ______________________________________________________________________________________________________________ *\
    \* Klassenvariablen                                                                                               */


    /* ______________________________________________________________________________________________________________ *\
    \* Instanzvariablen                                                                                               */


    /* ______________________________________________________________________________________________________________ *\
    \* Konstruktoren                                                                                                  */


    /**
     * Erzeugt eine Instanz dieser Klasse.
     *
     * Da verhindert werden soll, dass Instanzen dieser Klasse ausserhalb dieser Klasse erzeugt werdem, ist dieser
     * Konstruktor 'private' deklariert.
     */

    private Requests()
    {
        super();
    }


    /* ______________________________________________________________________________________________________________ *\
    \* Instanzmethoden                                                                                                */


    /* ______________________________________________________________________________________________________________ *\
    \* Klassenmethoden                                                                                                */


    /**
     * Liefert die ursprngliche Request-URI.
     * 
     * Die ursprngliche Request-URI ist entweder die gem Servlet-Spezifikation (Kapitel SRV.9.9.1) im
     * Request-Attribut "javax.servlet.error.request_uri" abgelegte URI, oder - wenn dieser nicht existiert - der Wert,
     * der von der Methode getRequestURIgeliefert wird.  
     *
     * @param  request          Der Request
     * @return                  Die urspngliche Request-URI
     */

    public static String getOriginalRequestURI(HttpServletRequest request)
    {
        String requestURI = (String)request.getAttribute("javax.servlet.error.request_uri");
        
        return (requestURI == null)? request.getRequestURI(): requestURI; 
    }
    
    
    /* ______________________________________________________________________________________________________________ *\
    \* Klassen                                                                                                        */

}

/*\
 * _____________________________________________________________________________________________________________________
 * 
 * This software is distributed under the terms of the BSD License:
 * 
 * Copyright  2006 Klaus Rogall, Hamburg, Germany (klaus.rogall@web.de). All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
 * following conditions are met:
 * 
 * - Redistributions of source code must retain the above copyright notice, this list of conditions and the following
 *   disclaimer.
 * - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
 *   disclaimer in the documentation and/or other materials provided with the distribution.
 * - Neither the name of the Klaus Rogall nor the names of its contributors may be used to endorse or promote products
 *   derived from this software without specific prior written permission.
 *   
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 * _____________________________________________________________________________________________________________________
\*/