Class AbstractSimpleConstraintComponent

java.lang.Object

org.eclipse.rdf4j.sail.shacl.ast.constraintcomponents.AbstractConstraintComponent

org.eclipse.rdf4j.sail.shacl.ast.constraintcomponents.AbstractSimpleConstraintComponent

All Implemented Interfaces:

ConstraintComponent, Exportable, TargetChainInterface

Direct Known Subclasses:

DatatypeConstraintComponent, InConstraintComponent, LanguageInConstraintComponent, MaxExclusiveConstraintComponent, MaxInclusiveConstraintComponent, MaxLengthConstraintComponent, MinExclusiveConstraintComponent, MinInclusiveConstraintComponent, MinLengthConstraintComponent, NodeKindConstraintComponent, PatternConstraintComponent

public abstract class AbstractSimpleConstraintComponent
extends AbstractConstraintComponent

Nested Class Summary

Nested classes/interfaces inherited from interface ConstraintComponent

ConstraintComponent.Scope

Field Summary

Fields

Modifier and Type	Field	Description
private Resource	id
private static final org.slf4j.Logger	logger
(package private) TargetChain	targetChain

Fields inherited from class AbstractConstraintComponent

VALUES_INJECTION_POINT

Constructor Summary

Constructors

Constructor	Description
AbstractSimpleConstraintComponent()
AbstractSimpleConstraintComponent(Resource id)

Method Summary

Modifier and Type	Method	Description
ValidationQuery	generateSparqlValidationQuery(ConnectionsGroup connectionsGroup, ValidationSettings validationSettings, boolean negatePlan, boolean negateChildren, ConstraintComponent.Scope scope)
PlanNode	generateTransactionalValidationPlan(ConnectionsGroup connectionsGroup, ValidationSettings validationSettings, PlanNodeProvider overrideTargetNode, ConstraintComponent.Scope scope)
PlanNode	getAllTargetsPlan(ConnectionsGroup connectionsGroup, Resource[] dataGraph, ConstraintComponent.Scope scope, StatementMatcher.StableRandomVariableProvider stableRandomVariableProvider, ValidationSettings validationSettings)
SourceConstraintComponent	getConstraintComponent()
(package private) abstract Function<PlanNode, FilterPlanNode>	getFilterAttacher()
private PlanNode	getFilterAttacherWithNegation(boolean negatePlan, PlanNode allTargets)
Resource	getId()
ValidationApproach	getOptimalBulkValidationApproach()	Should return the fastest validation approach for bulk validation.
private PlanNode	getPlanNodeForOverrideTargetNode(ConnectionsGroup connectionsGroup, ValidationSettings validationSettings, PlanNodeProvider overrideTargetNode, ConstraintComponent.Scope scope, boolean negatePlan, StatementMatcher.StableRandomVariableProvider stableRandomVariableProvider, EffectiveTarget effectiveTarget, Optional<Path> path)
ValidationApproach	getPreferredValidationApproach(ConnectionsGroup connectionsGroup)	A constraint component should decide which validation approach is going to be the optimal performance wise based on the state of the transaction and base sail.
private String	getSparqlFilter(boolean negatePlan, StatementMatcher.Variable<Value> variable, StatementMatcher.StableRandomVariableProvider stableRandomVariableProvider)
(package private) abstract String	getSparqlFilterExpression(StatementMatcher.Variable<Value> variable, boolean negated)	Simple constraints need only implement this method to support SPARQL based validation.
TargetChain	getTargetChain()
(package private) String	literalToString(Literal literal)
void	setTargetChain(TargetChain targetChain)

Methods inherited from class AbstractConstraintComponent

buildSparqlValidNodes_rsx_targetShape, getAllTargetsIncludingThoseAddedByPath, requiresEvaluation, stringRepresentationOfValue, trim

Methods inherited from class Object

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

Methods inherited from interface ConstraintComponent

deepClone, getDefaultMessage

Methods inherited from interface Exportable

toModel

Field Details

logger

private static final org.slf4j.Logger logger

id

private Resource id

targetChain

TargetChain targetChain

Constructor Details

AbstractSimpleConstraintComponent

public AbstractSimpleConstraintComponent(Resource id)

AbstractSimpleConstraintComponent

public AbstractSimpleConstraintComponent()

Method Details

getId

public Resource getId()

Overrides:

getId in class AbstractConstraintComponent

getTargetChain

public TargetChain getTargetChain()

Specified by:

getTargetChain in interface TargetChainInterface

Overrides:

getTargetChain in class AbstractConstraintComponent

setTargetChain

public void setTargetChain(TargetChain targetChain)

Specified by:

setTargetChain in interface TargetChainInterface

Overrides:

setTargetChain in class AbstractConstraintComponent

generateTransactionalValidationPlan

public PlanNode generateTransactionalValidationPlan(ConnectionsGroup connectionsGroup,
 ValidationSettings validationSettings,
 PlanNodeProvider overrideTargetNode,
 ConstraintComponent.Scope scope)

Specified by:

generateTransactionalValidationPlan in interface ConstraintComponent

Overrides:

generateTransactionalValidationPlan in class AbstractConstraintComponent

getPlanNodeForOverrideTargetNode

private PlanNode getPlanNodeForOverrideTargetNode(ConnectionsGroup connectionsGroup,
 ValidationSettings validationSettings,
 PlanNodeProvider overrideTargetNode,
 ConstraintComponent.Scope scope,
 boolean negatePlan,
 StatementMatcher.StableRandomVariableProvider stableRandomVariableProvider,
 EffectiveTarget effectiveTarget,
 Optional<Path> path)

generateSparqlValidationQuery

public ValidationQuery generateSparqlValidationQuery(ConnectionsGroup connectionsGroup,
 ValidationSettings validationSettings,
 boolean negatePlan,
 boolean negateChildren,
 ConstraintComponent.Scope scope)

Specified by:

generateSparqlValidationQuery in interface ConstraintComponent

Overrides:

generateSparqlValidationQuery in class AbstractConstraintComponent

getSparqlFilter

private String getSparqlFilter(boolean negatePlan,
 StatementMatcher.Variable<Value> variable,
 StatementMatcher.StableRandomVariableProvider stableRandomVariableProvider)

getSparqlFilterExpression

abstract String getSparqlFilterExpression(StatementMatcher.Variable<Value> variable,
 boolean negated)

Simple constraints need only implement this method to support SPARQL based validation. The returned filter body should evaluate to true for values that fail validation, unless negated==true. If the filter condition throws an error (a SPARQL runtime error, not Java error) then the error will be caught and coalesced to `true`.

Parameters:

variable -

negated -

Returns:

a string that is the body of a SPARQL filter

getFilterAttacherWithNegation

private PlanNode getFilterAttacherWithNegation(boolean negatePlan,
 PlanNode allTargets)

getPreferredValidationApproach

public ValidationApproach getPreferredValidationApproach(ConnectionsGroup connectionsGroup)

Description copied from interface: ConstraintComponent

A constraint component should decide which validation approach is going to be the optimal performance wise based on the state of the transaction and base sail.

Specified by:

getPreferredValidationApproach in interface ConstraintComponent

Overrides:

getPreferredValidationApproach in class AbstractConstraintComponent

getOptimalBulkValidationApproach

public ValidationApproach getOptimalBulkValidationApproach()

Description copied from interface: ConstraintComponent

Should return the fastest validation approach for bulk validation. When aggregating multiple constraint components the most compatible should be chosen.

Specified by:

getOptimalBulkValidationApproach in interface ConstraintComponent

Overrides:

getOptimalBulkValidationApproach in class AbstractConstraintComponent

getConstraintComponent

public SourceConstraintComponent getConstraintComponent()

getFilterAttacher

abstract Function<PlanNode, FilterPlanNode> getFilterAttacher()

literalToString

String literalToString(Literal literal)

getAllTargetsPlan

public PlanNode getAllTargetsPlan(ConnectionsGroup connectionsGroup,
 Resource[] dataGraph,
 ConstraintComponent.Scope scope,
 StatementMatcher.StableRandomVariableProvider stableRandomVariableProvider,
 ValidationSettings validationSettings)

Specified by:

getAllTargetsPlan in interface ConstraintComponent

Overrides:

getAllTargetsPlan in class AbstractConstraintComponent