Package io.jmix.aitools.dataload

Class EntityDataLoadResult

java.lang.Object

io.jmix.aitools.dataload.EntityDataLoadResult

public class EntityDataLoadResult
extends Object

Outcome of AiDataLoadService.loadData(String): the original user request together with the LLM-generated query, its validation result and the fetched rows.

Always returned - inspect isExecuted() and getExecutionError() to tell a successful load from a generation/validation/execution failure.

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	executed
protected @Nullable String	executionError
protected boolean	hasMore
protected EntityDataLoadQuery	query
protected List<Map<String,Object>>	rows
protected String	userText
protected JpqlValidationResult	validationResult

Constructor Summary

Constructors

Constructor	Description
EntityDataLoadResult(String userText, EntityDataLoadQuery query, JpqlValidationResult validationResult, List<Map<String,Object>> rows, boolean hasMore, boolean executed, @Nullable String executionError)

Method Summary

Modifier and Type	Method	Description
@Nullable String	getExecutionError()	Returns the execution error message, or null if the query was executed successfully or never attempted.
EntityDataLoadQuery	getQuery()	Returns the query as generated by the LLM, before any validation repair: JPQL, parameters, result-property names, explanation and warnings.
List<Map<String,Object>>	getRows()	Returns the fetched rows; each map is keyed by the names from EntityDataLoadQuery.getResultProperties().
String	getUserText()	Returns the original natural-language request the query was generated from.
JpqlValidationResult	getValidationResult()	Returns the validation outcome for getQuery(): parse/semantic issues found before execution.
boolean	isExecuted()	Returns whether the query was actually executed against the database.
boolean	isHasMore()	Returns whether more rows are available in the database beyond the returned page.

Methods inherited from class java.lang.Object

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

Field Details

userText

protected String userText

query

protected EntityDataLoadQuery query

validationResult

protected JpqlValidationResult validationResult

rows

protected List<Map<String,Object>> rows

hasMore

protected boolean hasMore

executed

protected boolean executed

executionError

protected @Nullable String executionError

Constructor Details

EntityDataLoadResult

public EntityDataLoadResult(String userText,
 EntityDataLoadQuery query,
 JpqlValidationResult validationResult,
 List<Map<String,Object>> rows,
 boolean hasMore,
 boolean executed,
 @Nullable String executionError)

Method Details

getQuery

public EntityDataLoadQuery getQuery()

Returns the query as generated by the LLM, before any validation repair: JPQL, parameters, result-property names, explanation and warnings. If the query was repaired during execution, the executed query may differ — only this original version is exposed here.

Returns:

the LLM-generated query, before any repair

getUserText

public String getUserText()

Returns the original natural-language request the query was generated from.

Returns:

the original natural-language request

getValidationResult

public JpqlValidationResult getValidationResult()

Returns the validation outcome for getQuery(): parse/semantic issues found before execution. When JpqlValidationResult.isValid() is false the query is not executed.

Returns:

the validation outcome

isHasMore

public boolean isHasMore()

Returns whether more rows are available in the database beyond the returned page. The caller can re-issue the request with an increased firstResult.

Returns:

true if more rows are available, false otherwise

getRows

public List<Map<String,Object>> getRows()

Returns the fetched rows; each map is keyed by the names from EntityDataLoadQuery.getResultProperties(). Empty when the query was not executed or produced no rows.

Returns:

the fetched rows

isExecuted

public boolean isExecuted()

Returns whether the query was actually executed against the database. false means generation failed, validation rejected the query, or execution threw — see getExecutionError().

Returns:

true if the query was executed, false otherwise

getExecutionError

public @Nullable String getExecutionError()

Returns the execution error message, or null if the query was executed successfully or never attempted.

Returns:

the execution error message, or null