Package io.jenkins.plugins.configsplice.engine.xml

Class GenericXmlLocator

java.lang.Object

io.jenkins.plugins.configsplice.engine.xml.GenericXmlLocator

public final class GenericXmlLocator
extends Object

Locates the source range addressed by a generic XmlPath (SRS section 8.7).

Same two-pass split as DotNetAttributeLocator: StAX proves the document well formed and safe, then XmlTagScanner — which resolves no entities and loads nothing external — computes exact ranges over the proven-good text.

The difference is navigation. Where the shorthands look for one known element shape, this walks an arbitrary chain of element steps, and therefore has to decide what "the" element means when several match. It never guesses: an unindexed step matching more than one sibling is an ambiguity error, because silently taking the first would make the build depend on document ordering the user cannot see.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	GenericXmlLocator.Located	A located target: an attribute value, or an element's text.

Method Summary

Modifier and Type	Method	Description
static GenericXmlLocator.Located	locate(String text, XmlPath path)	Finds the target addressed by path.

Methods inherited from class java.lang.Object

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

Method Details

locate

public static GenericXmlLocator.Located locate(String text,
 XmlPath path)
                                        throws SpliceException

Finds the target addressed by path.

Throws:

SpliceException - ErrorCode.PATH_MISSING when a step, attribute or text target does not exist, ErrorCode.PATH_AMBIGUOUS when an unindexed step matches more than one sibling, ErrorCode.PARSE_FAILED on malformed or unsafe input