public class FirstSuccessfulStrategy extends AbstractAuthenticationStrategy
AuthenticationStrategy
implementation that only accepts the account data from
the first successfully consulted Realm and ignores all subsequent realms. This is slightly
different behavior than AtLeastOneSuccessfulStrategy
, so please review both to see
which one meets your needs better.AtLeastOneSuccessfulAuthenticationStrategy
Constructor and Description |
---|
FirstSuccessfulStrategy() |
Modifier and Type | Method and Description |
---|---|
AuthenticationInfo |
beforeAllAttempts(Collection<? extends Realm> realms,
AuthenticationToken token)
Returns
null immediately, relying on this class's merge implementation to return
only the first info object it encounters, ignoring all subsequent ones. |
protected AuthenticationInfo |
merge(AuthenticationInfo info,
AuthenticationInfo aggregate)
Returns the specified
aggregate instance if is non null and valid (that is, has principals and they are
not empty) immediately, or, if it is null or not valid, the info argument is returned instead. |
afterAllAttempts, afterAttempt, beforeAttempt
public FirstSuccessfulStrategy()
public AuthenticationInfo beforeAllAttempts(Collection<? extends Realm> realms, AuthenticationToken token) throws AuthenticationException
null
immediately, relying on this class's merge
implementation to return
only the first info
object it encounters, ignoring all subsequent ones.beforeAllAttempts
in interface AuthenticationStrategy
beforeAllAttempts
in class AbstractAuthenticationStrategy
realms
- the Realms that will be consulted during the authentication process for the specified token.token
- the Principal/Credential representation to be used during authentication for a corresponding subject.AuthenticationException
- if the strategy implementation does not wish the Authentication attempt to execute.protected AuthenticationInfo merge(AuthenticationInfo info, AuthenticationInfo aggregate)
aggregate
instance if is non null and valid (that is, has principals and they are
not empty) immediately, or, if it is null or not valid, the info
argument is returned instead.
This logic ensures that the first valid info encountered is the one retained and all subsequent ones are ignored,
since this strategy mandates that only the info from the first successfully authenticated realm be used.merge
in class AbstractAuthenticationStrategy
Copyright © 2004–2017 The Apache Software Foundation. All rights reserved.