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

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.
  • 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.
    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.
    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).
    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.
    StandardNodeNameRule
    The default NodeNameRule: treats numeric names, UUID names, and names containing special characters as dynamic, matching
    invalid reference 
    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.