net.shibboleth.metadata.pipeline

Class BaseIteratingStage<T>

java.lang.Object

net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

net.shibboleth.utilities.java.support.component.AbstractIdentifiableInitializableComponent

net.shibboleth.metadata.pipeline.BaseStage<T>

net.shibboleth.metadata.pipeline.BaseIteratingStage<T>

Type Parameters:

T - type of metadata this stage operates upon

All Implemented Interfaces:

Stage<T>, net.shibboleth.utilities.java.support.component.Component, net.shibboleth.utilities.java.support.component.DestructableComponent, net.shibboleth.utilities.java.support.component.IdentifiableComponent, net.shibboleth.utilities.java.support.component.IdentifiedComponent, net.shibboleth.utilities.java.support.component.InitializableComponent

Direct Known Subclasses:

ContactPersonFilterStage, EntityDescriptorItemIdPopulationStage, EntityFilterStage, EntityRegistrationAuthorityFilterStage, EntityRoleFilterStage, GenerateIdStage, ItemIdTransformStage, ItemMetadataAddingStage, PullUpCacheDurationStage, PullUpValidUntilStage, RemoveOrganizationStage, SetCacheDurationStage, SetValidUntilStage, ValidateValidUntilStage, XMLSchemaValidationStage, XMLSignatureSigningStage, XMLSignatureValidationStage

@ThreadSafe
public abstract class BaseIteratingStage<T>
extends BaseStage<T>

Base class for Stage implementations that iterate over each Item in a collection and do something.

Constructor Summary

Constructors

Constructor and Description
BaseIteratingStage()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doExecute(Collection<Item<T>> itemCollection) Iterates over each element of the Item collection and delegates the processing of that element to doExecute(Item).
protected abstract boolean	doExecute(Item<T> item) Processes a given Item.

Methods inherited from class net.shibboleth.metadata.pipeline.BaseStage

execute, getCollectionPredicate, setCollectionPredicate

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractIdentifiableInitializableComponent

setId

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

doInitialize, getId

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

destroy, doDestroy, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.shibboleth.utilities.java.support.component.DestructableComponent

destroy, isDestroyed

Methods inherited from interface net.shibboleth.utilities.java.support.component.IdentifiedComponent

getId

Methods inherited from interface net.shibboleth.utilities.java.support.component.InitializableComponent

initialize, isInitialized

Constructor Detail

BaseIteratingStage

public BaseIteratingStage()

Method Detail

doExecute

protected void doExecute(@Nonnull@NonnullElements
             Collection<Item<T>> itemCollection)
                  throws StageProcessingException

Iterates over each element of the Item collection and delegates the processing of that element to doExecute(Item). Performs the stage processing on the given Item collection.

The stage is guaranteed to be have been initialized and not destroyed when this is invoked.

Specified by:

doExecute in class BaseStage<T>

Parameters:

itemCollection - collection to be processed

Throws:

StageProcessingException - thrown if there is an unrecoverable problem when processing the stage

doExecute

protected abstract boolean doExecute(@Nonnull
                Item<T> item)
                              throws StageProcessingException

Processes a given Item.

Parameters:

item - Item on which to operate

Returns:

true if the Item should be retained in the collection, false if not

Throws:

StageProcessingException - thrown if there is a problem with the stage processing