net.shibboleth.idp.profile.spring.relyingparty.metadata

Class AbstractMetadataProviderParser

java.lang.Object

org.springframework.beans.factory.xml.AbstractBeanDefinitionParser

org.springframework.beans.factory.xml.AbstractSingleBeanDefinitionParser

net.shibboleth.idp.profile.spring.relyingparty.metadata.AbstractMetadataProviderParser

All Implemented Interfaces:

org.springframework.beans.factory.xml.BeanDefinitionParser

Direct Known Subclasses:

AbstractDynamicMetadataProviderParser, AbstractReloadingMetadataProviderParser, ChainingMetadataProviderParser, InlineMetadataProviderParser

public abstract class AbstractMetadataProviderParser
extends org.springframework.beans.factory.xml.AbstractSingleBeanDefinitionParser

Parser for the MetadataProviderType in the urn:mace:shibboleth:2.0:metadata namespace. This also handles the ambivalence of where the <MetadataProvider> can be found. If it is found inside a <RelyingPartyGroup> or a <ChainingMetadataPRovider> then we just emit a MetadataResolver of the correct type and the outer parsers will deal with the rest. If we are the top most element then we need to summon up a RelyingPartyMetadataProvider and inject what we would usually create into that.

Field Summary

Fields

Modifier and Type	Field and Description
static QName	CHAINING_PROVIDER_ELEMENT_NAME ChainingMetadataProviderElement name.
private org.slf4j.Logger	log Logger.
static QName	METADATA_FILTER_ELEMENT_NAME MetadataFilter Element name.
static String	METADATA_NAMESPACE Namespace for Metadata.
static QName	RELYING_PARTY_GROUP_ELEMENT_NAME RelyingPartyGroup Element name.
static String	RP_NAMESPACE Namespace for RelyingParty.
static String	SECURITY_NAMESPACE Namespace for Security.
static QName	TRUST_ENGINE_ELEMENT_NAME TrustEngine element name.

Fields inherited from class org.springframework.beans.factory.xml.AbstractBeanDefinitionParser

ID_ATTRIBUTE, NAME_ATTRIBUTE

Constructor Summary

Constructors

Constructor and Description
AbstractMetadataProviderParser()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doNativeParse(Element element, org.springframework.beans.factory.xml.ParserContext parserContext, org.springframework.beans.factory.support.BeanDefinitionBuilder builder) Parse the element into the provider builder.
protected void	doParse(Element element, org.springframework.beans.factory.xml.ParserContext parserContext, org.springframework.beans.factory.support.BeanDefinitionBuilder builder)
protected Class<? extends MetadataResolver>	getBeanClass(Element element)
protected abstract Class<? extends MetadataResolver>	getNativeBeanClass(Element element) Return the real class implement by this type.
private boolean	isPresentNotChaining(Element element, String attribute) Handle attributes which are inappropriate for specific implementations.
private boolean	isTopMost(Element element) Is this the element at the top of the file? Yes, if it has no parent or if the parent is a RelyingPartyGroup.
private void	processPredicateOptions(Element element, org.springframework.beans.factory.xml.ParserContext parserContext, org.springframework.beans.factory.support.BeanDefinitionBuilder builder) Process predicate-related options.

Methods inherited from class org.springframework.beans.factory.xml.AbstractSingleBeanDefinitionParser

doParse, getBeanClassName, getParentName, parseInternal

Methods inherited from class org.springframework.beans.factory.xml.AbstractBeanDefinitionParser

parse, postProcessComponentDefinition, registerBeanDefinition, resolveId, shouldFireEvents, shouldGenerateId, shouldGenerateIdAsFallback, shouldParseNameAsAliases

Methods inherited from class java.lang.Object

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

Field Detail

SECURITY_NAMESPACE

public static final String SECURITY_NAMESPACE

Namespace for Security.

See Also:

Constant Field Values

RP_NAMESPACE

public static final String RP_NAMESPACE

Namespace for RelyingParty.

See Also:

Constant Field Values

METADATA_NAMESPACE

public static final String METADATA_NAMESPACE

Namespace for Metadata.

See Also:

Constant Field Values

METADATA_FILTER_ELEMENT_NAME

public static final QName METADATA_FILTER_ELEMENT_NAME

MetadataFilter Element name.

CHAINING_PROVIDER_ELEMENT_NAME

public static final QName CHAINING_PROVIDER_ELEMENT_NAME

ChainingMetadataProviderElement name.

RELYING_PARTY_GROUP_ELEMENT_NAME

public static final QName RELYING_PARTY_GROUP_ELEMENT_NAME

RelyingPartyGroup Element name.

TRUST_ENGINE_ELEMENT_NAME

public static final QName TRUST_ENGINE_ELEMENT_NAME

TrustEngine element name.

log

private final org.slf4j.Logger log

Logger.

Constructor Detail

AbstractMetadataProviderParser

public AbstractMetadataProviderParser()

Method Detail

isPresentNotChaining

private boolean isPresentNotChaining(@Nonnull
                           Element element,
                           @Nonnull
                           String attribute)

Handle attributes which are inappropriate for specific implementations. The chaining metadata provider cannot have "requireValidMetadata" or "failFastInitialization" set, even though they are present in the schema.
This method detects whether these elements are present and if the element is not a chaining provider returns true, otherwise it returns false and emits a warning.

Parameters:

element - the element

attribute - the attribute

Returns:

true iff this is not a chaining resolver and the attribute is present

isTopMost

private boolean isTopMost(@Nonnull
                Element element)

Is this the element at the top of the file? Yes, if it has no parent or if the parent is a RelyingPartyGroup. In this situation we need to wrap the element in a RelyingPartyMetadataProvider.

Parameters:

element - the element.

Returns:

whether it is the outmost element.

getNativeBeanClass

protected abstract Class<? extends MetadataResolver> getNativeBeanClass(Element element)

Return the real class implement by this type. This has the same function as the more usual AbstractSingleBeanDefinitionParser.getBeanClass(Element) but it may need to be shimmed in AbstractMetadataProviderParser which may need to insert an extra bean.

Parameters:

element - the Element that is being parsed

Returns:

the Class of the bean that is being defined via parsing the supplied Element, or null if none

See Also:

AbstractSingleBeanDefinitionParser.getBeanClassName(org.w3c.dom.Element)

getBeanClass

protected final Class<? extends MetadataResolver> getBeanClass(Element element)

Overrides:

getBeanClass in class org.springframework.beans.factory.xml.AbstractSingleBeanDefinitionParser

doParse

protected final void doParse(Element element,
           org.springframework.beans.factory.xml.ParserContext parserContext,
           org.springframework.beans.factory.support.BeanDefinitionBuilder builder)

Overrides:

doParse in class org.springframework.beans.factory.xml.AbstractSingleBeanDefinitionParser

doNativeParse

protected void doNativeParse(Element element,
                 org.springframework.beans.factory.xml.ParserContext parserContext,
                 org.springframework.beans.factory.support.BeanDefinitionBuilder builder)

Parse the element into the provider builder. This has the same function as the more usual AbstractSingleBeanDefinitionParser.doParse(Element, ParserContext, BeanDefinitionBuilder) but it may need to be shimmed in this class which may need to insert an extra bean.

Parameters:

element - the XML element being parsed

parserContext - the object encapsulating the current state of the parsing process

builder - used to define the BeanDefinition

See Also:

AbstractSingleBeanDefinitionParser.doParse(Element, BeanDefinitionBuilder)

processPredicateOptions

private void processPredicateOptions(Element element,
                           org.springframework.beans.factory.xml.ParserContext parserContext,
                           org.springframework.beans.factory.support.BeanDefinitionBuilder builder)

Process predicate-related options.

Parameters:

element - the current element being processed

parserContext - the current parser context

builder - the current bean definition builder