org.apache.wicket.request.http.handler.RedirectRequestHandler Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.wicket.request.http.handler;
import javax.servlet.http.HttpServletResponse;
import org.apache.wicket.request.IRequestCycle;
import org.apache.wicket.request.IRequestHandler;
import org.apache.wicket.request.http.WebResponse;
/**
* A request handler that redirects to the given url.
*
* the url should be one of the following:
*
* - Fully qualified "http://foo.com/bar"
* - Relative to the Wicket filter/servlet, e.g. "?wicket:interface=foo", "mounted_page"
* - Absolute within your web application's context root, e.g. "/foo.html"
*
*
* @author igor.vaynberg
* @author jcompagner
*/
public class RedirectRequestHandler implements IRequestHandler
{
private final String redirectUrl;
private final int status;
/**
* @param redirectUrl
* URL to redirect to.
*/
public RedirectRequestHandler(final String redirectUrl)
{
this(redirectUrl, HttpServletResponse.SC_MOVED_TEMPORARILY);
}
/**
* @param redirectUrl
* URL to redirect to.
* @param status
* 301 (Moved permanently) or 302 (Moved temporarily)
*/
public RedirectRequestHandler(final String redirectUrl, final int status)
{
if ((status != HttpServletResponse.SC_MOVED_PERMANENTLY) &&
(status != HttpServletResponse.SC_MOVED_TEMPORARILY) &&
(status != HttpServletResponse.SC_SEE_OTHER))
{
throw new IllegalStateException("Status must be either 301, 302 or 303, but was: " + status);
}
this.redirectUrl = redirectUrl;
this.status = status;
}
/**
* @return redirect url
*/
public String getRedirectUrl()
{
return redirectUrl;
}
/**
* @return http redirect status code
*/
public int getStatus()
{
return status;
}
/** {@inheritDoc} */
public void detach(final IRequestCycle requestCycle)
{
}
/** {@inheritDoc} */
public void respond(final IRequestCycle requestCycle)
{
final String location;
final String url = getRedirectUrl();
if (url.charAt(0) == '/')
{
// context-absolute url
location = requestCycle.getUrlRenderer().renderContextRelativeUrl(url);
}
else
{
// if relative url, servlet container will translate to absolute as
// per the servlet spec
// if absolute url still do the same
location = url;
}
WebResponse response = (WebResponse)requestCycle.getResponse();
if (status == HttpServletResponse.SC_MOVED_TEMPORARILY)
{
response.sendRedirect(location);
}
else
{
response.setStatus(status);
response.setHeader("Location", location);
}
}
}