org.springframework.security.web.authentication
Interface AuthenticationFailureHandler

All Known Implementing Classes:

ExceptionMappingAuthenticationFailureHandler, SimpleUrlAuthenticationFailureHandler

public interface AuthenticationFailureHandler

Strategy used to handle a failed authentication attempt.

Typical behaviour might be to redirect the user to the authentication page (in the case of a form login) to allow them to try again. More sophisticated logic might be implemented depending on the type of the exception. For example, a CredentialsExpiredException might cause a redirect to a web controller which allowed the user to change their password.

Since:

3.0

Version:

$Id: AuthenticationFailureHandler.java 3652 2009-05-11 05:35:20Z ltaylor $

Author:

Luke Taylor

Method Summary

void	onAuthenticationFailure(HttpServletRequest request, HttpServletResponse response, AuthenticationException exception) Called when an authentication attempt fails.

Method Detail

onAuthenticationFailure

void onAuthenticationFailure(HttpServletRequest request,
                             HttpServletResponse response,
                             AuthenticationException exception)
                             throws IOException,
                                    ServletException

Called when an authentication attempt fails.

Parameters:

request - the request during which the authentication attempt occurred.

response - the response.

exception - the exception which was thrown to reject the authentication request.

Throws:

IOException

ServletException