jodd.servlet.DispatcherUtil Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jodd-all Show documentation
Show all versions of jodd-all Show documentation
Jodd bundle - all classes in one jar
// Copyright (c) 2003-present, Jodd Team (http://jodd.org)
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
//
// 1. Redistributions of source code must retain the above copyright notice,
// this list of conditions and the following disclaimer.
//
// 2. 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.
//
// 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 HOLDER 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.
package jodd.servlet;
import jodd.util.StringPool;
import javax.servlet.RequestDispatcher;
import javax.servlet.ServletContext;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
/**
* Request utilities for path, uri, query strings etc..
*/
public class DispatcherUtil {
// ---------------------------------------------------------------- include
/**
* Include page which path is relative to the current HTTP request.
*/
public static boolean include(final ServletRequest request, final ServletResponse response, final String page) throws IOException, ServletException {
RequestDispatcher dispatcher = request.getRequestDispatcher(page);
if (dispatcher != null) {
dispatcher.include(request, response);
return true;
}
return false;
}
/**
* Include named resource.
*/
public static boolean includeNamed(final HttpServletRequest request, final ServletResponse response, final String resource) throws IOException, ServletException {
return includeNamed(request.getServletContext(), request, response, resource);
}
/**
* Include named resource.
*/
public static boolean includeNamed(final ServletContext context, final ServletRequest request, final ServletResponse response, final String page) throws IOException, ServletException {
RequestDispatcher dispatcher = context.getNamedDispatcher(page);
if (dispatcher != null) {
dispatcher.include(request, response);
return true;
}
return false;
}
/**
* Include page which path relative to the root of the ServletContext.
*/
public static boolean includeAbsolute(final HttpServletRequest request, final HttpServletResponse response, final String page) throws IOException, ServletException {
return includeAbsolute(request.getServletContext(), request, response, page);
}
/**
* Include page which path relative to the root of the ServletContext.
*/
public static boolean includeAbsolute(final ServletContext context, final ServletRequest request, final HttpServletResponse response, final String page) throws IOException, ServletException {
RequestDispatcher dispatcher = context.getRequestDispatcher(page);
if (dispatcher != null) {
dispatcher.include(request, response);
return true;
}
return false;
}
// ---------------------------------------------------------------- forward
/**
* Forward to page which path is relative to the current HTTP request.
*/
public static boolean forward(final ServletRequest request, final ServletResponse response, final String page) throws IOException, ServletException {
RequestDispatcher dispatcher = request.getRequestDispatcher(page);
if (dispatcher != null) {
dispatcher.forward(request, response);
return true;
}
return false;
}
/**
* Forward to named resource.
*/
public static boolean forwardNamed(final HttpServletRequest request, final ServletResponse response, final String resource) throws IOException, ServletException {
return forwardNamed(request.getServletContext(), request, response, resource);
}
/**
* Forward to named resource.
*/
public static boolean forwardNamed(final ServletContext context, final ServletRequest request, final ServletResponse response, final String resource) throws IOException, ServletException {
RequestDispatcher dispatcher = context.getNamedDispatcher(resource);
if (dispatcher != null) {
dispatcher.forward(request, response);
return true;
}
return false;
}
/**
* Forward to page path relative to the root of the ServletContext.
*/
public static boolean forwardAbsolute(final HttpServletRequest request, final ServletResponse response, final String page) throws IOException, ServletException {
return forwardAbsolute(request.getServletContext(), request, response, page);
}
/**
* Forward to page path relative to the root of the ServletContext.
*/
public static boolean forwardAbsolute(final ServletContext context, final ServletRequest request, final ServletResponse response, final String resource) throws IOException, ServletException {
RequestDispatcher dispatcher = context.getRequestDispatcher(resource);
if (dispatcher != null) {
dispatcher.forward(request, response);
return true;
}
return false;
}
// ---------------------------------------------------------------- redirect
/**
* Performs redirection (302) to specified url.
*/
public static void redirect(final HttpServletRequest request, final HttpServletResponse response, String url) throws IOException {
if (url.startsWith(StringPool.SLASH)) {
url = ServletUtil.getContextPath(request) + url;
}
response.sendRedirect(response.encodeRedirectURL(url));
}
/**
* Performs permanent redirection (301) to specified url.
*/
public static void redirectPermanent(final HttpServletRequest request, final HttpServletResponse response, String url) {
if (url.startsWith(StringPool.SLASH)) {
url = ServletUtil.getContextPath(request) + url;
}
response.setStatus(HttpServletResponse.SC_MOVED_PERMANENTLY);
response.setHeader("Location", url);
}
// ---------------------------------------------------------------- full urls
/**
* Returns full URL: uri + query string, including the context path.
*/
public static String getFullUrl(final HttpServletRequest request) {
String url = request.getRequestURI();
String query = request.getQueryString();
if ((query != null) && (query.length() != 0)) {
url += '?' + query;
}
return url;
}
/**
* Returns url, without context path, convenient for request dispatcher.
*/
public static String getUrl(final HttpServletRequest request) {
String servletPath = request.getServletPath();
String query = request.getQueryString();
if ((query != null) && (query.length() != 0)) {
servletPath += '?' + query;
}
return servletPath;
}
// ---------------------------------------------------------------- include
public static final String INCLUDE_REQUEST_URI = "javax.servlet.include.request_uri";
public static final String INCLUDE_CONTEXT_PATH = "javax.servlet.include.context_path";
public static final String INCLUDE_SERVLET_PATH = "javax.servlet.include.servlet_path";
public static final String INCLUDE_PATH_INFO = "javax.servlet.include.path_info";
public static final String INCLUDE_QUERY_STRING = "javax.servlet.include.query_string";
public static String getIncludeRequestUri(final HttpServletRequest request) {
return (String) request.getAttribute(INCLUDE_REQUEST_URI);
}
public static String getIncludeContextPath(final HttpServletRequest request) {
return (String) request.getAttribute(INCLUDE_CONTEXT_PATH);
}
public static String getIncludeServletPath(final HttpServletRequest request) {
return (String) request.getAttribute(INCLUDE_SERVLET_PATH);
}
public static String getIncludePathInfo(final HttpServletRequest request) {
return (String) request.getAttribute(INCLUDE_PATH_INFO);
}
public static String getIncludeQueryString(final HttpServletRequest request) {
return (String) request.getAttribute(INCLUDE_QUERY_STRING);
}
// ---------------------------------------------------------------- forward
public static final String FORWARD_REQUEST_URI = "javax.servlet.forward.request_uri";
public static final String FORWARD_CONTEXT_PATH = "javax.servlet.forward.context_path";
public static final String FORWARD_SERVLET_PATH = "javax.servlet.forward.servlet_path";
public static final String FORWARD_PATH_INFO = "javax.servlet.forward.path_info";
public static final String FORWARD_QUERY_STRING = "javax.servlet.forward.query_string";
public static String getForwardRequestUri(final HttpServletRequest request) {
return (String) request.getAttribute(FORWARD_REQUEST_URI);
}
public static String getForwardContextPath(final HttpServletRequest request) {
return (String) request.getAttribute(FORWARD_CONTEXT_PATH);
}
public static String getForwardServletPath(final HttpServletRequest request) {
return (String) request.getAttribute(FORWARD_SERVLET_PATH);
}
public static String getForwardPathInfo(final HttpServletRequest request) {
return (String) request.getAttribute(FORWARD_PATH_INFO);
}
public static String getForwardQueryString(final HttpServletRequest request) {
return (String) request.getAttribute(FORWARD_QUERY_STRING);
}
// ---------------------------------------------------------------- misc
/**
* Returns true if current page is included.
*/
public static boolean isPageIncluded(final HttpServletRequest request, final HttpServletResponse response) {
return (response.isCommitted() || (getIncludeServletPath(request) != null));
}
/**
* Returns true if request is a top-level one, i.e. previously
* not included or forwarded.
*/
public static boolean isTopLevelRequest(final HttpServletRequest request) {
return (getForwardRequestUri(request) == null) && (getIncludeRequestUri(request) == null);
}
// ---------------------------------------------------------------- smarter info
/**
* Returns the base (top-level) uri.
*/
public static String getBaseRequestUri(final HttpServletRequest request) {
String result = getForwardRequestUri(request);
if (result == null) {
result = request.getRequestURI();
}
return result;
}
/**
* Get current request uri.
*/
public static String getRequestUri(final HttpServletRequest request) {
String result = getIncludeRequestUri(request);
if (result == null) {
result = request.getRequestURI();
}
return result;
}
public static String getBaseContextPath(final HttpServletRequest request) {
String result = getForwardContextPath(request);
if (result == null) {
result = ServletUtil.getContextPath(request);
}
return result;
}
public static String getContextPath(final HttpServletRequest request) {
String result = getIncludeContextPath(request);
if (result == null) {
result = ServletUtil.getContextPath(request);
}
return result;
}
public static String getBaseServletPath(final HttpServletRequest request) {
String result = getForwardServletPath(request);
if (result == null) {
result = request.getServletPath();
}
return result;
}
public static String getServletPath(final HttpServletRequest request) {
String result = getIncludeServletPath(request);
if (result == null) {
result = request.getServletPath();
}
return result;
}
public static String getBasePathInfo(final HttpServletRequest request) {
String result = getForwardPathInfo(request);
if (result == null) {
result = request.getPathInfo();
}
return result;
}
public static String getPathInfo(final HttpServletRequest request) {
String result = getIncludePathInfo(request);
if (result == null) {
result = request.getPathInfo();
}
return result;
}
public static String getBaseQueryString(final HttpServletRequest request) {
String result = getForwardQueryString(request);
if (result == null) {
result = request.getQueryString();
}
return result;
}
public static String getQueryString(final HttpServletRequest request) {
String result = getIncludeQueryString(request);
if (result == null) {
result = request.getQueryString();
}
return result;
}
}