Package org.frankframework.pipes

Class AbstractValidator

java.lang.Object

org.frankframework.core.TransactionAttributes

org.frankframework.pipes.AbstractPipe

org.frankframework.pipes.FixedForwardPipe

org.frankframework.pipes.AbstractValidator

All Implemented Interfaces:

FrankElement, HasApplicationContext, HasName, HasTransactionAttribute, IConfigurable, IDualModeValidator, IForwardTarget, IPipe, IScopeProvider, IValidator, IWithParameters, NameAware, EventThrowing, org.springframework.beans.factory.Aware, org.springframework.context.ApplicationContextAware, org.springframework.context.Lifecycle

Direct Known Subclasses:

JsonValidator, XmlValidator

@Forward(name="parserError",description="a parser exception occurred, probably caused by a non-well-formed document. If not specified, <code>failure</code> is used in such a case.") @Forward(name="failure",description="the document is not valid according to the configured schema.") @Forward(name="warnings",description="warnings occurred. If not specified, <code>success</code> is used.") @Forward(name="outputParserError",description="a <code>parserError</code> when validating a response. If not specified, <code>parserError</code> is used.") @Forward(name="outputFailure",description="a <code>failure</code> when validating a response. If not specified, <code>failure</code> is used.") @Forward(name="outputWarnings",description="warnings occurred when validating a response. If not specified, <code>warnings</code> is used.")
public abstract class AbstractValidator
extends FixedForwardPipe
implements IDualModeValidator

Pipe that validates the input message against a schema.

Author:

Gerrit van Brakel

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AbstractValidator.ResponseValidatorWrapper	Wrapper for the response validator.

Field Summary

Fields inherited from class org.frankframework.pipes.AbstractPipe

parameterNamesMustBeUnique

Fields inherited from class org.frankframework.core.TransactionAttributes

log

Fields inherited from interface org.frankframework.core.IPipe

LONG_DURATION_MONITORING_EVENT, MESSAGE_SIZE_MONITORING_EVENT, PIPE_EXCEPTION_MONITORING_EVENT

Constructor Summary

Constructors

Constructor	Description
AbstractValidator()

Method Summary

Modifier and Type	Method	Description
void	configure()	Checks for correct configuration of forward.
protected final PipeForward	determineForward(AbstractXmlValidator.ValidationResult validationResult, boolean responseMode, Supplier<String> errorMessageProvider)
final PipeRunResult	doPipe(Message message, PipeLineSession session)	This is where the action takes place.
PipeRunResult	doPipe(Message input, PipeLineSession session, boolean responseMode, String messageRoot)
IValidator	getResponseValidator()
protected boolean	isConfiguredForMixedValidation()
void	setForwardFailureToSuccess(boolean b)	Deprecated.
void	setResponseRoot(String responseRoot)	Name of the response root element.
void	setRoot(String root)	Name of the root element.
void	setSchemaSessionKey(String schemaSessionKey)	Session key for retrieving a schema.
protected final PipeForward	validate(String messageToValidate, PipeLineSession session)
protected abstract PipeForward	validate(Message messageToValidate, PipeLineSession session, boolean responseMode, String messageRoot)
PipeRunResult	validate(Message message, PipeLineSession session, String messageRoot)

Methods inherited from class org.frankframework.pipes.FixedForwardPipe

getParameterValue, setIfParam, setIfValue, setOnlyIfSessionKey, setOnlyIfValue, setSkipOnEmptyInput, setUnlessSessionKey, setUnlessValue, skipPipe

Methods inherited from class org.frankframework.pipes.AbstractPipe

addForward, addParameter, consumesSessionVariable, createBean, findForward, getAdapter, getEventSourceName, getForwards, getParameterList, hasRegisteredForward, isRunning, registerEvent, setApplicationContext, setChompCharSize, setDurationThreshold, setElementToMove, setElementToMoveChain, setElementToMoveSessionKey, setEmptyInputReplacement, setGetInputFromFixedValue, setGetInputFromSessionKey, setHideRegex, setLocker, setLogIntermediaryResults, setMaxThreads, setName, setPreserveInput, setRemoveCompactMsgNamespaces, setRestoreMovedElements, setSecLogSessionKeys, setSizeStatistics, setStoreResultInSessionKey, setWriteToSecLog, sizeStatisticsEnabled, start, stop, throwEvent

Methods inherited from class org.frankframework.core.TransactionAttributes

configureTransactionAttributes, isTransacted, isTransacted, setTransacted, setTransactionTimeout

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.context.ApplicationContextAware

setApplicationContext

Methods inherited from interface org.frankframework.core.FrankElement

addConfigWarning

Methods inherited from interface org.frankframework.core.HasApplicationContext

getApplicationContext, getConfigurationClassLoader

Methods inherited from interface org.frankframework.core.HasName

getName

Methods inherited from interface org.frankframework.core.HasTransactionAttribute

getTransactionAttribute, getTransactionTimeout, getTxDef, setTransactionAttribute

Methods inherited from interface org.frankframework.core.IForwardTarget

getName

Methods inherited from interface org.frankframework.core.IPipe

addForward, consumesSessionVariable, getChompCharSize, getDurationThreshold, getElementToMove, getElementToMoveChain, getElementToMoveSessionKey, getEmptyInputReplacement, getForwards, getGetInputFromFixedValue, getGetInputFromSessionKey, getHideRegex, getLocker, getLogIntermediaryResults, getMaxThreads, getSecLogSessionKeys, getStoreResultInSessionKey, isPreserveInput, isRemoveCompactMsgNamespaces, isRestoreMovedElements, isWriteToSecLog, registerEvent, setChompCharSize, setDurationThreshold, setElementToMove, setElementToMoveChain, setElementToMoveSessionKey, setEmptyInputReplacement, setGetInputFromFixedValue, setGetInputFromSessionKey, setHideRegex, setLocker, setLogIntermediaryResults, setPipeLine, setPreserveInput, setRemoveCompactMsgNamespaces, setRestoreMovedElements, setSecLogSessionKeys, setStoreResultInSessionKey, setWriteToSecLog, sizeStatisticsEnabled, start, stop, throwEvent, throwEvent

Methods inherited from interface org.frankframework.core.IValidator

setName

Methods inherited from interface org.springframework.context.Lifecycle

isRunning

Constructor Details

AbstractValidator

public AbstractValidator()

Method Details

configure

public void configure()
               throws ConfigurationException

Description copied from class: FixedForwardPipe

Checks for correct configuration of forward.

Specified by:

configure in interface IConfigurable

Overrides:

configure in class FixedForwardPipe

Throws:

ConfigurationException - in case it was not able to configure the component.

doPipe

public final PipeRunResult doPipe(Message message,
 PipeLineSession session)
                           throws PipeRunException

Description copied from interface: IPipe

This is where the action takes place. Pipes may only throw a PipeRunException, to be handled by the caller of this object. Implementations must either consume the message, or pass it on to the next Pipe in the PipeRunResult.

Specified by:

doPipe in interface IPipe

Throws:

PipeRunException

validate

public PipeRunResult validate(Message message,
 PipeLineSession session,
 String messageRoot)
                       throws PipeRunException

Specified by:

validate in interface IValidator

Throws:

PipeRunException

doPipe

public PipeRunResult doPipe(Message input,
 PipeLineSession session,
 boolean responseMode,
 String messageRoot)
                     throws PipeRunException

Throws:

PipeRunException

validate

protected final PipeForward validate(String messageToValidate,
 PipeLineSession session)
                              throws PipeRunException,
XmlValidatorException,
ConfigurationException

Throws:

PipeRunException

XmlValidatorException

ConfigurationException

validate

protected abstract PipeForward validate(Message messageToValidate,
 PipeLineSession session,
 boolean responseMode,
 String messageRoot)
                                 throws PipeRunException,
XmlValidatorException,
ConfigurationException

Throws:

PipeRunException

XmlValidatorException

ConfigurationException

determineForward

protected final PipeForward determineForward(AbstractXmlValidator.ValidationResult validationResult,
 boolean responseMode,
 Supplier<String> errorMessageProvider)
                                      throws PipeRunException

Throws:

PipeRunException

isConfiguredForMixedValidation

protected boolean isConfiguredForMixedValidation()

getResponseValidator

public IValidator getResponseValidator()

Specified by:

getResponseValidator in interface IDualModeValidator

setSchemaSessionKey

public void setSchemaSessionKey(String schemaSessionKey)

Session key for retrieving a schema.

setRoot

public void setRoot(String root)

Name of the root element.

setResponseRoot

public void setResponseRoot(String responseRoot)

Name of the response root element.

setForwardFailureToSuccess

@Deprecated
@ConfigurationWarning("please specify a forward with name=failure instead")
public void setForwardFailureToSuccess(boolean b)

Deprecated.

If true, the failure forward is replaced by the success forward (like a warning mode).