net.shibboleth.idp.authn.context

Class AuthenticationErrorContext

java.lang.Object

org.opensaml.messaging.context.BaseContext

net.shibboleth.idp.authn.context.AuthenticationErrorContext

All Implemented Interfaces:

Iterable<org.opensaml.messaging.context.BaseContext>

public class AuthenticationErrorContext
extends org.opensaml.messaging.context.BaseContext

A BaseContext, usually attached to AuthenticationContext, that holds information about authentication failures.

The login process is particularly prone to requiring detailed error information to provide appropriate user feedback and auditing, and this context tracks errors that occur and preserves detailed information about the kind of errors encountered in multi-part authentication flows.

Nested Class Summary

Nested classes/interfaces inherited from class org.opensaml.messaging.context.BaseContext

org.opensaml.messaging.context.BaseContext.ContextSetNoRemoveIteratorDecorator

Field Summary

Fields

Modifier and Type	Field and Description
private Collection<String>	classifiedErrors Error conditions detected through classified error messages.
private List<Exception>	exceptions Ordered list of exceptions encountered.

Constructor Summary

Constructors

Constructor and Description
AuthenticationErrorContext() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	addException(Exception e) Add an exception to the list.
Collection<String>	getClassifiedErrors() Get a mutable collection of error "tokens" associated with the context.
List<Exception>	getExceptions() Get an immutable list of the exceptions encountered.
boolean	isClassifiedError(String error) Check for the presence of a particular error condition in the context.

Methods inherited from class org.opensaml.messaging.context.BaseContext

addSubcontext, addSubcontext, clearSubcontexts, containsSubcontext, createSubcontext, getParent, getSubcontext, getSubcontext, getSubcontext, getSubcontext, isAutoCreateSubcontexts, iterator, removeSubcontext, removeSubcontext, setAutoCreateSubcontexts, setParent

Methods inherited from class java.lang.Object

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

Field Detail

exceptions

@Nonnull
@NonnullElements
private List<Exception> exceptions

Ordered list of exceptions encountered.

classifiedErrors

private Collection<String> classifiedErrors

Error conditions detected through classified error messages.

Constructor Detail

AuthenticationErrorContext

public AuthenticationErrorContext()

Constructor.

Method Detail

getExceptions

@Nonnull
@NonnullElements
@Unmodifiable
public List<Exception> getExceptions()

Get an immutable list of the exceptions encountered.

Returns:

immutable list of exceptions

addException

public void addException(@Nonnull
                Exception e)

Add an exception to the list.

Parameters:

e - exception to add

getClassifiedErrors

@Nonnull
@NonnullElements
@Live
public Collection<String> getClassifiedErrors()

Get a mutable collection of error "tokens" associated with the context.

Returns:

mutable collection of error strings

isClassifiedError

public boolean isClassifiedError(@Nonnull@NotEmpty
                        String error)

Check for the presence of a particular error condition in the context.

Parameters:

error - the condition to check for

Returns:

true iff the context contains the error condition specified