org.wildfly.security.evidence

Interface Evidence

All Known Subinterfaces:

AlgorithmEvidence

All Known Implementing Classes:

BearerTokenEvidence, PasswordGuessEvidence, X509PeerCertificateChainEvidence

public interface Evidence

A piece of evidence which may be used for credential verification.

Author:

David M. Lloyd, Darran Lofthouse

Method Summary

Modifier and Type	Method and Description
default <E extends Evidence,R> R	castAndApply(Class<E> evidenceType, Function<E,R> function) Cast this evidence type and apply a function if the type matches.
default <E extends Evidence,R> R	castAndApply(Class<E> evidenceType, String algorithmName, Function<E,R> function) Cast this evidence type and apply a function if the type matches.
default <E extends Evidence> E	castAs(Class<E> evidenceType) Cast this evidence type if the type matches.
default <E extends Evidence> E	castAs(Class<E> evidenceType, String algorithmName) Cast this evidence type if the type and algorithm matches.
default Principal	getPrincipal() Get the Principal which can be derived from this evidence, this can be null if there is no derived Principal.

Method Detail

getPrincipal

default Principal getPrincipal()

Get the Principal which can be derived from this evidence, this can be null if there is no derived Principal.

Returns:

the Principal which can be derived from this evidence, this can be null if there is no derived Principal.

castAs

default <E extends Evidence> E castAs(Class<E> evidenceType,
                                      String algorithmName)

Cast this evidence type if the type and algorithm matches.

Type Parameters:

E - the evidence type

Parameters:

evidenceType - the evidence type class to check

algorithmName - the name of the algorithm or null if any algorithm is acceptable

Returns:

the evidence cast as the target type, or null if the evidence does not match the criteria

castAs

default <E extends Evidence> E castAs(Class<E> evidenceType)

Cast this evidence type if the type matches.

Type Parameters:

E - the evidence type

Parameters:

evidenceType - the evidence type class to check

Returns:

the evidence cast as the target type, or null if the evidence does not match the criteria

castAndApply

default <E extends Evidence,R> R castAndApply(Class<E> evidenceType,
                                              String algorithmName,
                                              Function<E,R> function)

Cast this evidence type and apply a function if the type matches.

Type Parameters:

E - the evidence type

R - the return type

Parameters:

evidenceType - the evidence type class to check

algorithmName - the name of the algorithm or null if any algorithm is acceptable

function - the function to apply

Returns:

the result of the function, or null if the evidence is not of the given type

castAndApply

default <E extends Evidence,R> R castAndApply(Class<E> evidenceType,
                                              Function<E,R> function)

Cast this evidence type and apply a function if the type matches.

Type Parameters:

E - the evidence type

R - the return type

Parameters:

evidenceType - the evidence type class to check

function - the function to apply

Returns:

the result of the function, or null if the evidence is not of the given type