org.springframework.web.servlet.view
Class RedirectView

java.lang.Object
  org.springframework.context.support.ApplicationObjectSupport
      org.springframework.web.context.support.WebApplicationObjectSupport
          org.springframework.web.servlet.view.AbstractView
              org.springframework.web.servlet.view.AbstractUrlBasedView
                  org.springframework.web.servlet.view.RedirectView

All Implemented Interfaces:

ApplicationContextAware, BeanNameAware, View

public class RedirectView

extends AbstractUrlBasedView

View that redirects to an internal or external URL, exposing all model attributes as HTTP query parameters.

A URL for this view is supposed to be a HTTP redirect URL, i.e. suitable for HttpServletResponse's sendRedirect method.

Version:

$Id: RedirectView.java,v 1.7 2004/03/18 02:46:11 trisberg Exp $

Author:

Rod Johnson, Juergen Hoeller

See Also:

HttpServletResponse.sendRedirect(java.lang.String)

Field Summary

static java.lang.String

DEFAULT_ENCODING_SCHEME

Fields inherited from class org.springframework.web.servlet.view.AbstractView

DEFAULT_CONTENT_TYPE

Fields inherited from class org.springframework.context.support.ApplicationObjectSupport

logger

Constructor Summary

RedirectView()
Constructor for use as a bean.

RedirectView(java.lang.String url)
Create a new RedirectView with the given URL.

RedirectView(java.lang.String url, boolean contextRelative)
Create a new RedirectView with the given URL.

Method Summary

protected void	appendQueryProperties(java.lang.StringBuffer targetUrl, java.util.Map model, java.lang.String encodingScheme) Append query properties to the redirect URL.
protected java.util.Map	queryProperties(java.util.Map model) Determine name-value pairs for query strings, which will be stringified, URL-encoded and formatted by buildRedirectUrl.
protected void	renderMergedOutputModel(java.util.Map model, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Convert model to request parameters and redirect to the given URL.
void	setContextRelative(boolean contextRelative) Set whether to interpret the given URL as relative to the current ServletContext, i.e. as relative to the web application root.
void	setEncodingScheme(java.lang.String encodingScheme) Set the encoding scheme for this view.

Methods inherited from class org.springframework.web.servlet.view.AbstractUrlBasedView

getUrl, initApplicationContext, setUrl

Methods inherited from class org.springframework.web.servlet.view.AbstractView

addStaticAttribute, getBeanName, getContentType, getStaticAttributes, render, setAttributes, setAttributesCSV, setAttributesMap, setBeanName, setContentType, setRequestContextAttribute

Methods inherited from class org.springframework.web.context.support.WebApplicationObjectSupport

getServletContext, getTempDir, getWebApplicationContext

Methods inherited from class org.springframework.context.support.ApplicationObjectSupport

getApplicationContext, getMessageSourceAccessor, requiredContextClass, setApplicationContext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_ENCODING_SCHEME

public static final java.lang.String DEFAULT_ENCODING_SCHEME

See Also:

Constant Field Values

Constructor Detail

RedirectView

public RedirectView()

Constructor for use as a bean.

RedirectView

public RedirectView(java.lang.String url)

Create a new RedirectView with the given URL.

Parameters:

url - the URL to redirect to

RedirectView

public RedirectView(java.lang.String url,
                    boolean contextRelative)

Create a new RedirectView with the given URL.

Parameters:

url - the URL to redirect to

contextRelative - whether to interpret the given URL as relative to the current ServletContext

Method Detail

setContextRelative

public void setContextRelative(boolean contextRelative)

Set whether to interpret the given URL as relative to the current ServletContext, i.e. as relative to the web application root.

Default is false: The URL will be intepreted as absolute, i.e. taken as-is. If true, the context path will be prepended to the URL.

See Also:

HttpServletRequest.getContextPath()

setEncodingScheme

public void setEncodingScheme(java.lang.String encodingScheme)

Set the encoding scheme for this view.

renderMergedOutputModel

protected void renderMergedOutputModel(java.util.Map model,
                                       javax.servlet.http.HttpServletRequest request,
                                       javax.servlet.http.HttpServletResponse response)
                                throws java.io.IOException

Convert model to request parameters and redirect to the given URL.

Specified by:

renderMergedOutputModel in class AbstractView

Parameters:

model - combined output Map, with dynamic values taking precedence over static attributes

request - current HTTP request

response - current HTTP response

Throws:

java.io.IOException

See Also:

appendQueryProperties(java.lang.StringBuffer, java.util.Map, java.lang.String)

appendQueryProperties

protected void appendQueryProperties(java.lang.StringBuffer targetUrl,
                                     java.util.Map model,
                                     java.lang.String encodingScheme)
                              throws java.io.UnsupportedEncodingException

Append query properties to the redirect URL. Stringifies, URL-encodes and formats model attributes as query properties.

Parameters:

targetUrl - the StringBuffer to append the properties to

model - Map that contains model attributes

encodingScheme - the encoding scheme to use

Throws:

java.io.UnsupportedEncodingException - if string encoding failed

See Also:

queryProperties(java.util.Map)

queryProperties

protected java.util.Map queryProperties(java.util.Map model)

Determine name-value pairs for query strings, which will be stringified, URL-encoded and formatted by buildRedirectUrl.

This implementation returns all model elements as-is.

See Also:

appendQueryProperties(java.lang.StringBuffer, java.util.Map, java.lang.String)