org.wildfly.security.auth.util

Class SimpleRegexRealmMapper

java.lang.Object

org.wildfly.security.auth.util.SimpleRegexRealmMapper

All Implemented Interfaces:

RealmMapper

Direct Known Subclasses:

MappedRegexRealmMapper

public class SimpleRegexRealmMapper
extends Object
implements RealmMapper

A simple regular expression-based realm mapper. The realm name pattern must contain a single capture group which matches the substring to use as the realm name. If the substring is not matched, the delegate realm mapper is used. If there is no delegate realm mapper, the default realm is used.

Author:

David M. Lloyd

Field Summary

Fields inherited from interface org.wildfly.security.auth.server.RealmMapper

DEFAULT_REALM_MAPPER

Constructor Summary

Constructors

Constructor and Description
SimpleRegexRealmMapper(Pattern realmNamePattern) Construct a new instance.
SimpleRegexRealmMapper(Pattern realmNamePattern, RealmMapper delegate) Construct a new instance.

Method Summary

Modifier and Type	Method and Description
String	getRealmMapping(Principal principal, Evidence evidence) Get the realm mapping.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.wildfly.security.auth.server.RealmMapper

aggregate, aggregate, matching, matchingEvidence, matchingEvidenceType, matchingPrincipal, matchingPrincipalType, single

Constructor Detail

SimpleRegexRealmMapper

public SimpleRegexRealmMapper(Pattern realmNamePattern)

Construct a new instance.

Parameters:

realmNamePattern - the realm name pattern, which must contain at least one capture group (cannot be null)

Throws:

IllegalArgumentException - if the given pattern does not contain a capture group

SimpleRegexRealmMapper

public SimpleRegexRealmMapper(Pattern realmNamePattern,
                              RealmMapper delegate)

Construct a new instance.

Parameters:

realmNamePattern - the realm name pattern, which must contain at least one capture group (cannot be null)

delegate - the delegate mapper to use if the pattern is not matched (cannot be null)

Throws:

IllegalArgumentException - if the given pattern does not contain a capture group

Method Detail

getRealmMapping

public String getRealmMapping(Principal principal,
                              Evidence evidence)

Description copied from interface: RealmMapper

Get the realm mapping. Return null if the default realm should be used.

Specified by:

getRealmMapping in interface RealmMapper

Parameters:

principal - the authentication principal (or null if none is known for this authentication)

evidence - the authentication evidence (or null if none is known for this authentication)

Returns:

the realm, or null if no particular realm matches the authentication information