// Copyright (c) 2003-2007, Jodd Team (jodd.sf.net). All Rights Reserved.
package jodd.servlet;
import jodd.servlet.filter.CharArrayResponseWrapper;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.ServletException;
import javax.servlet.RequestDispatcher;
import javax.servlet.ServletContext;
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(ServletRequest request, ServletResponse response, 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(HttpServletRequest request, ServletResponse response, String resource) throws IOException, ServletException {
return includeNamed(request.getSession().getServletContext(), request, response, resource);
}
/**
* Include named resource.
*/
public static boolean includeNamed(ServletContext context, ServletRequest request, ServletResponse response, 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(HttpServletRequest request, HttpServletResponse response, String page) throws IOException, ServletException {
return includeAbsolute(request.getSession().getServletContext(), request, response, page);
}
/**
* Include page which path relative to the root of the ServletContext.
*/
public static boolean includeAbsolute(ServletContext context, ServletRequest request, HttpServletResponse response, String page) throws IOException, ServletException {
RequestDispatcher dispatcher = context.getRequestDispatcher(page);
if (dispatcher != null) {
dispatcher.include(request, response);
return true;
}
return false;
}
// ---------------------------------------------------------------- wrap
public static CharArrayResponseWrapper wrap(ServletRequest request, HttpServletResponse response, String page) throws IOException, ServletException {
CharArrayResponseWrapper wrapper = new CharArrayResponseWrapper(response);
include(request, wrapper, page);
return wrapper;
}
public static CharArrayResponseWrapper wrapNamed(HttpServletRequest request, HttpServletResponse response, String resource) throws IOException, ServletException {
CharArrayResponseWrapper wrapper = new CharArrayResponseWrapper(response);
includeNamed(request, wrapper, resource);
return wrapper;
}
public static CharArrayResponseWrapper wrapNamed(ServletContext context, HttpServletRequest request, HttpServletResponse response, String resource) throws IOException, ServletException {
CharArrayResponseWrapper wrapper = new CharArrayResponseWrapper(response);
includeNamed(context, request, wrapper, resource);
return wrapper;
}
public static CharArrayResponseWrapper wrapAbsolute(HttpServletRequest request, HttpServletResponse response, String page) throws IOException, ServletException {
CharArrayResponseWrapper wrapper = new CharArrayResponseWrapper(response);
includeAbsolute(request, wrapper, page);
return wrapper;
}
public static CharArrayResponseWrapper wrapAbsolute(ServletContext context, ServletRequest request, HttpServletResponse response, String page) throws IOException, ServletException {
CharArrayResponseWrapper wrapper = new CharArrayResponseWrapper(response);
includeAbsolute(context, request, wrapper, page);
return wrapper;
}
// ---------------------------------------------------------------- forward
/**
* Forward to page which path is relative to the current HTTP request.
*/
public static boolean forward(ServletRequest request, ServletResponse response, 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(HttpServletRequest request, ServletResponse response, String resource) throws IOException, ServletException {
return forwardNamed(request.getSession().getServletContext(), request, response, resource);
}
/**
* Forward to named resource.
*/
public static boolean forwardNamed(ServletContext context, ServletRequest request, ServletResponse response, 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(HttpServletRequest request, ServletResponse response, String page) throws IOException, ServletException {
return forwardAbsolute(request.getSession().getServletContext(), request, response, page);
}
/**
* Forward to page path relative to the root of the ServletContext.
*/
public static boolean forwardAbsolute(ServletContext context, ServletRequest request, ServletResponse response, String resource) throws IOException, ServletException {
RequestDispatcher dispatcher = context.getRequestDispatcher(resource);
if (dispatcher != null) {
dispatcher.forward(request, response);
return true;
}
return false;
}
// ---------------------------------------------------------------- redirect
/**
* Performs redirection to specified page.
*/
public static void redirect(HttpServletRequest request, HttpServletResponse response, String url) throws IOException {
if (url.startsWith("/") == true) {
url = request.getContextPath() + url;
}
response.sendRedirect(response.encodeRedirectURL(url));
}
// ---------------------------------------------------------------- action path
/**
* Returns full action path: uri + query string.
*/
public static String getActionPath(HttpServletRequest request) {
return makeActionPath(request.getRequestURI(), request.getQueryString());
}
/**
* Builds action path from uri and query.
*/
public static String makeActionPath(String uri, String query) {
if ((query != null) && (query.length() != 0)) {
uri += '?' + query;
}
return uri;
}
// ---------------------------------------------------------------- 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(HttpServletRequest request) {
return (String) request.getAttribute(INCLUDE_REQUEST_URI);
}
public static String getIncludeContextPath(HttpServletRequest request) {
return (String) request.getAttribute(INCLUDE_CONTEXT_PATH);
}
public static String getIncludeServletPath(HttpServletRequest request) {
return (String) request.getAttribute(INCLUDE_SERVLET_PATH);
}
public static String getIncludePathInfo(HttpServletRequest request) {
return (String) request.getAttribute(INCLUDE_PATH_INFO);
}
public static String getIncludeQueryString(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(HttpServletRequest request) {
return (String) request.getAttribute(FORWARD_REQUEST_URI);
}
public static String getForwardContextPath(HttpServletRequest request) {
return (String) request.getAttribute(FORWARD_CONTEXT_PATH);
}
public static String getForwardServletPath(HttpServletRequest request) {
return (String) request.getAttribute(FORWARD_SERVLET_PATH);
}
public static String getForwardPathInfo(HttpServletRequest request) {
return (String) request.getAttribute(FORWARD_PATH_INFO);
}
public static String getForwardQueryString(HttpServletRequest request) {
return (String) request.getAttribute(FORWARD_QUERY_STRING);
}
// ---------------------------------------------------------------- misc
/**
* Returns <code>true</code> if current page is included.
*/
public static boolean isPageIncluded(HttpServletRequest request, HttpServletResponse response) {
return (response.isCommitted() || (getIncludeServletPath(request) != null));
}
/**
* Returns <code>true</code> if request is a top-level one, i.e. previously
* not included or forwarded.
*/
public static boolean isTopLevelRequest(HttpServletRequest request) {
return (getForwardRequestUri(request) == null) && (getIncludeRequestUri(request) == null);
}
// ---------------------------------------------------------------- smarter info
/**
* Returns the base (top-level) uri.
*/
public static String getBaseRequestUri(HttpServletRequest request) {
String result = getForwardRequestUri(request);
if (result == null) {
result = request.getRequestURI();
}
return result;
}
/**
* Get current request uri.
*/
public static String getRequestUri(HttpServletRequest request) {
String result = getIncludeRequestUri(request);
if (result == null) {
result = request.getRequestURI();
}
return result;
}
public static String getBaseContextPath(HttpServletRequest request) {
String result = getForwardContextPath(request);
if (result == null) {
result = request.getContextPath();
}
return result;
}
public static String getContextPath(HttpServletRequest request) {
String result = getIncludeContextPath(request);
if (result == null) {
result = request.getContextPath();
}
return result;
}
public static String getBaseServletPath(HttpServletRequest request) {
String result = getForwardServletPath(request);
if (result == null) {
result = request.getServletPath();
}
return result;
}
public static String getServletPath(HttpServletRequest request) {
String result = getIncludeServletPath(request);
if (result == null) {
result = request.getServletPath();
}
return result;
}
public static String getBasePathInfo(HttpServletRequest request) {
String result = getForwardPathInfo(request);
if (result == null) {
result = request.getPathInfo();
}
return result;
}
public static String getPathInfo(HttpServletRequest request) {
String result = getIncludePathInfo(request);
if (result == null) {
result = request.getPathInfo();
}
return result;
}
public static String getBaseQueryString(HttpServletRequest request) {
String result = getForwardQueryString(request);
if (result == null) {
result = request.getQueryString();
}
return result;
}
public static String getQueryString(HttpServletRequest request) {
String result = getIncludeQueryString(request);
if (result == null) {
result = request.getQueryString();
}
return result;
}
}
|