org.springframework.security.web.savedrequest
Interface RequestCache

All Known Implementing Classes:
HttpSessionRequestCache, NullRequestCache

public interface RequestCache

Implements "saved request" logic, allowing a single request to be retrieved and restarted after redirecting to an authentication mechanism.

Since:
3.0
Version:
$Id$
Author:
Luke Taylor

Method Summary
 HttpServletRequest getMatchingRequest(HttpServletRequest request, HttpServletResponse response)
          Returns a wrapper around the saved request, if it matches the current request.
 SavedRequest getRequest(HttpServletRequest request, HttpServletResponse response)
          Returns the saved request, leaving it cached.
 void removeRequest(HttpServletRequest request, HttpServletResponse response)
          Removes the cached request
 void saveRequest(HttpServletRequest request, HttpServletResponse response)
          Caches the current request for later retrieval, once authentication has taken place.
 

Method Detail

saveRequest

void saveRequest(HttpServletRequest request,
                 HttpServletResponse response)
Caches the current request for later retrieval, once authentication has taken place. Used by ExceptionTranslationFilter.

Parameters:
request - the request to be stored

getRequest

SavedRequest getRequest(HttpServletRequest request,
                        HttpServletResponse response)
Returns the saved request, leaving it cached.

Parameters:
currentRequest - the current
Returns:
the saved request which was previously cached, or null if there is none.

getMatchingRequest

HttpServletRequest getMatchingRequest(HttpServletRequest request,
                                      HttpServletResponse response)
Returns a wrapper around the saved request, if it matches the current request. The saved request should be removed from the cache.

Parameters:
request -
response -
Returns:
the wrapped save request, if it matches the original, or null if there is no cached request or it doesn't match.

removeRequest

void removeRequest(HttpServletRequest request,
                   HttpServletResponse response)
Removes the cached request

Parameters:
currentRequest -


Copyright © 2004-2009 SpringSource, Inc. All Rights Reserved.