Record Class LocatorCandidate

java.lang.Object

java.lang.Record

com.shaft.capture.model.LocatorCandidate

Record Components:

strategy - locator strategy

expression - sanitized locator expression

uniquenessCount - number of matching elements observed

visible - whether the target was visible

stable - whether the evidence appeared stable

signals - additional deterministic scoring signals

public record LocatorCandidate(LocatorCandidate.LocatorStrategy strategy, String expression, int uniquenessCount, boolean visible, boolean stable, Set<LocatorCandidate.LocatorSignal> signals)
extends Record

Locator evidence retained for deterministic ranking and review.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	LocatorCandidate.LocatorSignal	Deterministic evidence signals.
static enum	LocatorCandidate.LocatorStrategy	Supported locator evidence strategies.

Field Summary

Fields

Modifier and Type	Field	Description
static final Comparator<LocatorCandidate>	BEST_FIRST	Stable best-first ordering for candidate review and replay.

Constructor Summary

Constructors

Constructor	Description
LocatorCandidate(LocatorCandidate.LocatorStrategy strategy, String expression, int uniquenessCount, boolean visible, boolean stable, Set<LocatorCandidate.LocatorSignal> signals)	Creates immutable locator evidence.

Method Summary

Modifier and Type	Method	Description
final boolean	equals(Object o)	Indicates whether some other object is "equal to" this one.
String	expression()	Returns the value of the expression record component.
final int	hashCode()	Returns a hash code value for this object.
int	score()	Computes a deterministic score without model inference.
Set<LocatorCandidate.LocatorSignal>	signals()	Returns the value of the signals record component.
boolean	stable()	Returns the value of the stable record component.
LocatorCandidate.LocatorStrategy	strategy()	Returns the value of the strategy record component.
final String	toString()	Returns a string representation of this record class.
int	uniquenessCount()	Returns the value of the uniquenessCount record component.
boolean	visible()	Returns the value of the visible record component.

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Field Details

BEST_FIRST

public static final Comparator<LocatorCandidate> BEST_FIRST

Stable best-first ordering for candidate review and replay.

Constructor Details

LocatorCandidate

public LocatorCandidate(LocatorCandidate.LocatorStrategy strategy,
 String expression,
 int uniquenessCount,
 boolean visible,
 boolean stable,
 Set<LocatorCandidate.LocatorSignal> signals)

Creates immutable locator evidence.

Method Details

score

public int score()

Computes a deterministic score without model inference.

Returns:

candidate score

toString

public final String toString()

Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.

Specified by:

toString in class Record

Returns:

a string representation of this object

hashCode

public final int hashCode()

Returns a hash code value for this object. The value is derived from the hash code of each of the record components.

Specified by:

hashCode in class Record

Returns:

a hash code value for this object

equals

public final boolean equals(Object o)

Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. Reference components are compared with Objects::equals(Object,Object); primitive components are compared with the compare method from their corresponding wrapper classes.

Specified by:

equals in class Record

Parameters:

o - the object with which to compare

Returns:

true if this object is the same as the o argument; false otherwise.

strategy

public LocatorCandidate.LocatorStrategy strategy()

Returns the value of the strategy record component.

Returns:

the value of the strategy record component

expression

public String expression()

Returns the value of the expression record component.

Returns:

the value of the expression record component

uniquenessCount

public int uniquenessCount()

Returns the value of the uniquenessCount record component.

Returns:

the value of the uniquenessCount record component

visible

public boolean visible()

Returns the value of the visible record component.

Returns:

the value of the visible record component

stable

public boolean stable()

Returns the value of the stable record component.

Returns:

the value of the stable record component

signals

public Set<LocatorCandidate.LocatorSignal> signals()

Returns the value of the signals record component.

Returns:

the value of the signals record component