Package com.northconcepts.datapipeline.foundations.pipeline.tree.detect

Pluggable algorithms to detect record breaks and fields in a Tree, including collapsing down (merging) tree-node-paths where a naming/wildcard pattern can be derived.

See: Description

Interface Summary

Interface	Description
NodeNameRule	Classifies a single XML element or JSON field name as dynamic data (an identifier, date, or other generated value) rather than a fixed structural name.
SiblingSetRule	Examines a parent's candidate children collectively and derives a SiblingSetPattern when their names share a naming/wildcard pattern, or returns null when no pattern can be derived.

Class Summary

Class	Description
AffixSiblingSetRule	Derives a SiblingSetPattern from siblings sharing a fixed prefix/suffix around a varying dynamic segment — for example item-1, item-2, item-3 collapse to item-*.
CollapseSiblingPatterns	Collapses down (merges) sibling tree-node-paths whose names share a derivable naming/wildcard pattern (see SiblingSetRule) into a single wildcard node, mirroring what the build-time NodeNameRules produce for individually dynamic names: the collapsed node is named *, its XPath expression ends in node(), member names become its values, and descendant XPaths collapse the merged segment to *.
DateTimeNodeNameRule	Classifies date/timestamp names (for example 2024-01-15 map keys) as dynamic using a DateTimePatternDetector.
DetectFieldCandidates	Marks every TreeNode that held at least one text value as a field, assigns its initial field name, and flags values that should cascade across multiple output records.
DetectRecordBreakCandidates	Marks the repeating TreeNodes that represent one record per instance.
MakeFieldNamesUnique	Final naming pass: reassigns field names that still collide after the tree structure was transformed, keeping every field name unique.
OptimizeTreeStructure	Cleans up a loaded Tree by merging non-wildcard siblings into an existing wildcard node, adding a synthetic value field under childless wildcard nodes, and marking JSON array elements as record breaks.
RegexNodeNameRule	Classifies names matching a caller-supplied regular expression as dynamic.
SiblingSetPattern	An immutable naming pattern derived from a set of sibling names — a fixed prefix and suffix around a dynamic middle segment (for example item-* derived from item-1, item-2, item-3).
StandardNodeNameRule	The default NodeNameRule: treats numeric names, UUID names, and names containing special characters as dynamic, matching XmlNode#isWildcardCandidate(String).
StructureSiblingSetRule	Derives a SiblingSetPattern from siblings whose child structures overlap, instead of their names: each candidate's structural signature is the set of its child element and attribute names (looking through JSON object/array container nodes), and siblings whose signatures agree above minimumSimilarity (Jaccard overlap) form the collapse group.
TreeDetectionStrategy	Defines the algorithms used to detect record breaks and fields in a Tree: an ordered list of NodeNameRules that classify dynamic element/field names while the tree is being built, followed by an ordered list of TreeTransformer passes that run over the loaded tree.
TreeTransformer	A single pass in a TreeDetectionStrategy that analyzes or restructures a Tree after it has been loaded from an XML or JSON document.

Package com.northconcepts.datapipeline.foundations.pipeline.tree.detect Description

Pluggable algorithms to detect record breaks and fields in a Tree, including collapsing down (merging) tree-node-paths where a naming/wildcard pattern can be derived.