Javadoc on ProviderManager.authenticate clarification

Fixes gh-3722
This commit is contained in:
hmolsen 2016-03-02 20:39:28 +01:00 committed by Rob Winch
parent db81977a1a
commit b248eae416
1 changed files with 9 additions and 3 deletions

View File

@ -136,9 +136,15 @@ public class ProviderManager implements AuthenticationManager, MessageSourceAwar
* attempted with that <code>AuthenticationProvider</code>.
* <p>
* If more than one <code>AuthenticationProvider</code> supports the passed
* <code>Authentication</code> object, only the first
* <code>AuthenticationProvider</code> tried will determine the result. No subsequent
* <code>AuthenticationProvider</code>s will be tried.
* <code>Authentication</code> object, the first one able to successfully
* authenticate the <code>Authentication</code> object determines the
* <code>result</code>, overriding any possible <code>AuthenticationException</code>
* thrown by earlier supporting <code>AuthenticationProvider</code>s.
* On successful authentication, no subsequent <code>AuthenticationProvider</code>s
* will be tried.
* If authentication was not successful by any supporting
* <code>AuthenticationProvider</code> the last thrown
* <code>AuthenticationException</code> will be rethrown.
*
* @param authentication the authentication request object.
*