Class ReorderFiltersInOptionalBodiesTransform

java.lang.Object

org.eclipse.rdf4j.queryrender.sparql.ir.util.transform.BaseTransform

org.eclipse.rdf4j.queryrender.sparql.ir.util.transform.ReorderFiltersInOptionalBodiesTransform

public final class ReorderFiltersInOptionalBodiesTransform
extends BaseTransform

Within OPTIONAL bodies, move simple FILTER conditions earlier when all their variables are already available from preceding lines in the same OPTIONAL body. This improves readability and can unlock later fusions. Safety: - Only reorders plain text FILTER conditions; structured bodies (EXISTS/NOT EXISTS) are left in place. - A FILTER is moved only if every variable it references appears in lines preceding the first nested OPTIONAL. - Preserves container structure and recurses conservatively.

Field Summary

Fields inherited from class BaseTransform

ANON_PATH_INVERSE_PREFIX, ANON_PATH_PREFIX

Modifier and Type	Field	Description
static final String	ANON_PATH_INVERSE_PREFIX
static final String	ANON_PATH_PREFIX

Method Summary

Modifier and Type	Method	Description
static void	addVarName(Set<String> out, Var v)
static IrBGP	apply(IrBGP bgp, TupleExprIRRenderer r)
static Set<String>	collectVarsFromLines(List<IrNode> lines, TupleExprIRRenderer r)
static Set<String>	extractVarsFromText(String s)
static IrBGP	reorderFiltersWithin(IrBGP inner, TupleExprIRRenderer r)

Methods inherited from class BaseTransform

bgpWithLines, branchHasAnonPathBridge, copyAllExcept, fuseAdjacentPtThenPt, fuseAdjacentSpThenPt, fuseAltInverseTailBGP, fusePtSpPtSequence, invertNegatedPropertySet, iri, isAnonPathInverseVar, isAnonPathVar, isConstantIriPredicate, joinPathWithLaterSp, mergeNpsMembers, normalizeCompactNps, orientBareNpsForNext, rewriteContainers, sameVar, sameVarOrValue, unionBranchesAllHaveAnonPathBridge, unionBranchesShareAnonPathVarWithAllowedRoleMapping, unionBranchesShareCommonAnonPathVarName, unionIsExplicitAndAllBranchesScoped, varOrValue

Modifier and Type	Method	Description
static IrBGP	bgpWithLines(IrBGP original, List<IrNode> lines)	Build a new IrBGP with the same scope flag and the provided lines.
static boolean	branchHasAnonPathBridge(IrBGP branch)	True if the given branch contains at least one variable with the parser-generated _anon_path_ (or inverse variant) prefix anywhere in its simple triple-like structures.
static void	copyAllExcept(IrBGP from, IrBGP to, IrNode except)
static IrBGP	fuseAdjacentPtThenPt(IrBGP bgp)	Fuse adjacent IrPathTriple nodes when the first's object equals the second's subject.
static IrBGP	fuseAdjacentSpThenPt(IrBGP bgp, TupleExprIRRenderer r)
static IrBGP	fuseAltInverseTailBGP(IrBGP bgp, TupleExprIRRenderer r)	Fuse a path triple whose object is a bridge var with a constant-IRI tail triple that also uses the bridge var, producing a new path with an added '/^p' or '/p' segment.
static IrBGP	fusePtSpPtSequence(IrBGP bgp, TupleExprIRRenderer r)	Fuse a three-line sequence: IrPathTriple (A), IrStatementPattern (B), IrPathTriple (C) into A then ( ^B.p / C ).
static String	invertNegatedPropertySet(String npsText)	If the given path text is a negated property set of the form !
static String	iri(Var pred, TupleExprIRRenderer r)	Convenience: render a constant-IRI predicate Var to text.
static boolean	isAnonPathInverseVar(Var v)	True when the anonymous path var explicitly encodes inverse orientation.
static boolean	isAnonPathVar(Var v)
static boolean	isConstantIriPredicate(IrStatementPattern sp)	Convenience: true iff SP has a constant-IRI predicate.
static IrBGP	joinPathWithLaterSp(IrBGP bgp, TupleExprIRRenderer r)
static String	mergeNpsMembers(String a, String b)	Merge NPS members of two canonical strings '!
static String	normalizeCompactNps(String path)	Normalize compact negated-property-set forms into the canonical parenthesized variant.
static IrBGP	orientBareNpsForNext(IrBGP bgp)	Re-orient a bare negated property set path "!
static IrNode	rewriteContainers(IrNode n, Function<IrBGP,IrBGP> f)	Utility: rewrite container nodes by applying a given function to their inner IrBGP children.
static boolean	sameVar(Var a, Var b)
static boolean	sameVarOrValue(Var a, Var b)	True when both variables denote the same term: compares names if both are variables without value, or compares values if both are constants.
static boolean	unionBranchesAllHaveAnonPathBridge(IrUnion u)	True if all UNION branches contain at least one _anon_path_* variable (or inverse variant).
static boolean	unionBranchesShareAnonPathVarWithAllowedRoleMapping(IrUnion u)	New-scope UNION safety: true iff the two UNION branches share at least one _anon_path_* variable name.
static boolean	unionBranchesShareCommonAnonPathVarName(IrUnion u)	True if all UNION branches share at least one common variable name that starts with the _anon_path_ prefix.
static boolean	unionIsExplicitAndAllBranchesScoped(IrUnion u)	Universal safeguard for explicit user UNIONs: true iff the UNION is marked as new scope and all its branches are also marked as new scope.
static String	varOrValue(Var v, TupleExprIRRenderer r)

Methods inherited from class Object

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

Method Details

apply

public static IrBGP apply(IrBGP bgp,
 TupleExprIRRenderer r)

reorderFiltersWithin

public static IrBGP reorderFiltersWithin(IrBGP inner,
 TupleExprIRRenderer r)

collectVarsFromLines

public static Set<String> collectVarsFromLines(List<IrNode> lines,
 TupleExprIRRenderer r)

extractVarsFromText

public static Set<String> extractVarsFromText(String s)

addVarName

public static void addVarName(Set<String> out,
 Var v)