Class ExtractionBuilder<T>

java.lang.Object

ai.doctruth.ExtractionBuilder<T>

public final class ExtractionBuilder<T>
extends Object

Immutable fluent builder for one extraction call. Each with* method returns a NEW instance — the receiver is never mutated, so a single builder can be safely shared across threads and re-used across run(ParsedDocument) calls.

Since:

0.1.0

Method Summary

Modifier and Type	Method	Description
ExtractionResult<T>	run(ParsedDocument doc)	Execute the configured extraction.
ExtractionBuilder<T>	withAuditListener(AuditEventListener listener)	Plug an AuditEventListener into this builder so every extraction emits one SIEM-friendly event.
ExtractionBuilder<T>	withBitemporal()
ExtractionBuilder<T>	withConfidence()
ExtractionBuilder<T>	withContextStrategy(ContextStrategy s)
<V> ExtractionBuilder<T>	withFieldConstraint(String fieldPath, Class<V> valueType, Predicate<V> predicate, String message)
ExtractionBuilder<T>	withMaxRetries(int n)
ExtractionBuilder<T>	withObjectConstraint(Predicate<T> predicate, String message)
ExtractionBuilder<T>	withProvenance()
ExtractionBuilder<T>	withSourcePublishedAt(Instant t)

Methods inherited from class Object

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

Method Details

withProvenance

public ExtractionBuilder<T> withProvenance()

withBitemporal

public ExtractionBuilder<T> withBitemporal()

withConfidence

public ExtractionBuilder<T> withConfidence()

withMaxRetries

public ExtractionBuilder<T> withMaxRetries(int n)

withContextStrategy

public ExtractionBuilder<T> withContextStrategy(ContextStrategy s)

withSourcePublishedAt

public ExtractionBuilder<T> withSourcePublishedAt(Instant t)

withFieldConstraint

public <V> ExtractionBuilder<T> withFieldConstraint(String fieldPath,
 Class<V> valueType,
 Predicate<V> predicate,
 String message)

withObjectConstraint

public ExtractionBuilder<T> withObjectConstraint(Predicate<T> predicate,
 String message)

withAuditListener

public ExtractionBuilder<T> withAuditListener(AuditEventListener listener)

Plug an AuditEventListener into this builder so every extraction emits one SIEM-friendly event. The default is AuditEventListener.NOOP; opt-in only.

Throws:

NullPointerException - if listener is null.

run

public ExtractionResult<T> run(ParsedDocument doc)
                        throws ExtractionException

Execute the configured extraction.

Throws:

NullPointerException - if doc is null.

ExtractionException - on provider or schema-parse failure (cause-chain preserved).