/**
* Copyright 2005-2014 Restlet
*
* The contents of this file are subject to the terms of one of the following
* open source licenses: Apache 2.0 or or EPL 1.0 (the "Licenses"). You can
* select the license that you prefer but you may not use this file except in
* compliance with one of these Licenses.
*
* You can obtain a copy of the Apache 2.0 license at
* http://www.opensource.org/licenses/apache-2.0
*
* You can obtain a copy of the EPL 1.0 license at
* http://www.opensource.org/licenses/eclipse-1.0
*
* See the Licenses for the specific language governing permissions and
* limitations under the Licenses.
*
* Alternatively, you can obtain a royalty free commercial license with less
* limitations, transferable or non-transferable, directly at
* http://restlet.com/products/restlet-framework
*
* Restlet is a registered trademark of Restlet S.A.S.
*/
package org.restlet.ext.jaxrs;
import javax.ws.rs.core.UriInfo;
/**
* This {@link UriInfo} extension returns {@link javax.ws.rs.core.UriBuilder}s
* which contains the "file" extension given by the request. This extension will
* also be available, if the path will be changed (e.g. replaced, removed or
* matrix parameters added). For further information see
* {@link ExtendedUriBuilder#extension(String)},
* {@link ExtendedUriBuilder#extensionLanguage(String)} and
* {@link ExtendedUriBuilder#extensionMedia(String)}. You could get it in the
* same way as the default UriInfo, that measn annotate a field of this type
* with @{@link javax.ws.rs.core.Context}.
*
* @author Stephan Koops
* @see UriInfo
*/
public interface ExtendedUriInfo extends UriInfo {
/**
* Get the absolute path of the request in the form of an
* {@link ExtendedUriBuilder}. This includes everything preceding the path
* (host, port etc) but excludes query parameters. It also includes the
* extension of the current request.
*
* @return an ExtendedUriBuilder initialized with the absolute path of the
* request and an extension according to the current chosen media
* type.
* @throws java.lang.IllegalStateException
* if called outside the scope of a request
* @see UriInfo#getAbsolutePathBuilder()
*/
ExtendedUriBuilder getAbsolutePathBuilder();
/**
* Get the base URI of the application in the form of an
* {@link ExtendedUriBuilder}. It also includes the extension of the current
* request.
*
* @return a UriBuilder initialized with the base URI of the application and
* an extension according to the current chosen media type.
* @see UriInfo#getBaseUriBuilder()
*/
ExtendedUriBuilder getBaseUriBuilder();
/**
* Get the absolute request URI in the form of an {@link ExtendedUriBuilder}
* . It also includes the extension of the current request.
*
* @return a UriBuilder initialized with the absolute request URI and an
* extension according to the current chosen media type
* @throws java.lang.IllegalStateException
* if called outside the scope of a request
*/
ExtendedUriBuilder getRequestUriBuilder();
}