Chain (Digital Signature Services 5.5 API)

java.lang.Object
- eu.europa.esig.dss.validation.process.Chain<T>

Type Parameters:

T - the class used as result. The selected class must extend XmlConstraintsConclusion which contains some constraints and a conclusion.

Direct Known Subclasses:

AbstractAcceptanceValidation, CertificateQualificationBlock, CertQualificationAtTimeBlock, CryptographicVerification, DigestAlgorithmAcceptanceValidation, FormatChecking, IdentificationOfTheSigningCertificate, PastCertificateValidation, PastSignatureValidation, RevocationFreshnessChecker, SignatureQualificationBlock, SubX509CertificateValidation, TLValidationBlock, ValidationContextInitialization, ValidationProcessForBasicSignatures, ValidationProcessForSignaturesWithArchivalData, ValidationProcessForSignaturesWithLongTermValidationData, ValidationProcessForTimeStamps, ValidationTimeSliding, X509CertificateValidation
```
public abstract class Chain<T extends XmlConstraintsConclusion>
extends Object
```
This class is part of the design pattern "Chain of responsibility". All sub-classes need to implement the method initChain() which will define the ChainItem (constraints) to execute. The chain is builded as follow with the method ChainItem.setNextItem(eu.europa.esig.dss.validation.process.ChainItem<T>).

See Also:

ChainItem

Field Summary

Fields
Modifier and Type	Field	Description
`protected ChainItem<T>`	`firstItem`	The first item to execute the chain
`protected T`	`result`	The result object : a sub-class of `XmlConstraintsConclusion`

Constructor Summary

Constructors
Modifier Constructor Description

protected Chain(T newInstance)
Common constructor

Method Summary

Modifier and Type	Method	Description
`protected void`	`addAdditionalInfo()`
`protected void`	`collectErrorsWarnsInfos()`
`T`	`execute()`	This method allows to initialize and execute the complete chain until the first failure.
`protected LevelConstraint`	`getFailLevelConstraint()`
`protected LevelConstraint`	`getInfoLevelConstraint()`
`protected LevelConstraint`	`getWarnLevelConstraint()`
`protected abstract void`	`initChain()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - result
```
protected final T extends XmlConstraintsConclusion result
```
    The result object : a sub-class of XmlConstraintsConclusion
  - firstItem
```
protected ChainItem<T extends XmlConstraintsConclusion> firstItem
```
    The first item to execute the chain
- Constructor Detail
  - Chain
```
protected Chain(T newInstance)
```
    Common constructor
    
    Parameters:
    
    newInstance - a new instance of the result object
- Method Detail
  - execute
```
public T execute()
```
    This method allows to initialize and execute the complete chain until the first failure.
    
    Returns:
    
    the complete result with constraints and final conclusion for the chain
  - addAdditionalInfo
```
protected void addAdditionalInfo()
```
  - initChain
```
protected abstract void initChain()
```
  - getFailLevelConstraint
```
protected LevelConstraint getFailLevelConstraint()
```
  - getWarnLevelConstraint
```
protected LevelConstraint getWarnLevelConstraint()
```
  - getInfoLevelConstraint
```
protected LevelConstraint getInfoLevelConstraint()
```
  - collectErrorsWarnsInfos
```
protected void collectErrorsWarnsInfos()
```