Class DefaultQueryTransformer

java.lang.Object

dev.langchain4j.rag.query.transformer.DefaultQueryTransformer

All Implemented Interfaces:

QueryTransformer

public class DefaultQueryTransformer
extends Object
implements QueryTransformer

Default implementation of QueryTransformer intended to be suitable for the majority of use cases.

It's important to note that while efforts will be made to avoid breaking changes, the default behavior of this class may be updated in the future if it's found that the current behavior does not adequately serve the majority of use cases. Such changes would be made to benefit both current and future users.

This implementation simply returns the provided Query without any transformation.

See Also:

• CompressingQueryTransformer
• ExpandingQueryTransformer

Constructor Summary

Constructors

Constructor	Description
DefaultQueryTransformer()

Method Summary

Modifier and Type	Method	Description
Collection<Query>	transform(Query query)	Transforms the given Query into one or multiple Querys.
CompletableFuture<Collection<Query>>	transformAsync(Query query)	Non-blocking counterpart of QueryTransformer.transform(Query), invoked by the asynchronous (CompletableFuture/CompletionStage) and reactive (Flow.Publisher) AI Service modes when RAG is configured.

Methods inherited from class Object

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

Constructor Details

DefaultQueryTransformer

public DefaultQueryTransformer()

Method Details

transform

public Collection<Query> transform(Query query)

Description copied from interface: QueryTransformer

Transforms the given Query into one or multiple Querys.

Specified by:

transform in interface QueryTransformer

Parameters:

query - The Query to be transformed.

Returns:

A collection of one or more Querys derived from the original Query.

transformAsync

public CompletableFuture<Collection<Query>> transformAsync(Query query)

Description copied from interface: QueryTransformer

Non-blocking counterpart of QueryTransformer.transform(Query), invoked by the asynchronous (CompletableFuture/CompletionStage) and reactive (Flow.Publisher) AI Service modes when RAG is configured.

The default implementation returns a failed future carrying AsyncNotSupportedException: a transformer backed by a blocking LLM call (e.g. query compression/expansion) must opt in by overriding this method to stay off the calling thread. A transformer that cannot be made non-blocking is still usable from these modes via DefaultRetrievalAugmentor, which offloads the blocking QueryTransformer.transform(Query) to its executor.

Specified by:

transformAsync in interface QueryTransformer

Parameters:

query - The Query to be transformed.

Returns:

A CompletableFuture of one or more Querys derived from the original Query.