Package com.tnsai.output.validation

Class StructuredOutputExecutor<T>

java.lang.Object

com.tnsai.output.validation.StructuredOutputExecutor<T>

public final class StructuredOutputExecutor<T>
extends Object

Ensures LLM outputs conform to expected schema with automatic retry.

Combines structured output generation with validation rules and automatic re-prompting on failure.

Usage

 StructuredOutputExecutor executor = StructuredOutputExecutor.builder()
     .llm(client)
     .targetType(OrderSummary.class)
     .rules(List.of(
         ValidationRule.notNull("orderId"),
         ValidationRule.range("total", 0, 100000)))
     .maxRetries(3)
     .build();

 StructuredOutputResult<OrderSummary> result = executor.generate("Summarize this order: ...");
 if (result.success()) {
     OrderSummary order = result.value();
 }
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	StructuredOutputExecutor.Builder<T>
static final record	StructuredOutputExecutor.StructuredOutputResult<T>	Result of a structured output generation attempt.

Method Summary

Modifier and Type	Method	Description
static <T> StructuredOutputExecutor.Builder<T>	builder()
StructuredOutputExecutor.StructuredOutputResult<T>	generate(String prompt)	Generates structured output with validation and retry.

Methods inherited from class java.lang.Object

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

Method Details

generate

public StructuredOutputExecutor.StructuredOutputResult<T> generate(String prompt)

Generates structured output with validation and retry.

builder

public static <T>
StructuredOutputExecutor.Builder<T> builder()