Struct SearchExpression 

pub struct SearchExpression { /* private fields */ }

A complete search request.

The engine’s native search input. Index.search() takes this. JSON parsing at the edge (SearchExpression::from_json) produces this.

The query field accepts any QueryExpression — scoring queries (match, term, knn, bool) and ranking expressions (fusion/RRF).

Implementations

impl SearchExpression

pub fn new() -> Self

Create a new expression with defaults (match_all, size=10).

pub fn query(self, query: QueryExpression) -> Self

Set the query expression (scoring or ranking).

pub fn scoring_query(self, query: ScoringExpression) -> Self

Set a scoring query (convenience — wraps in QueryExpression::Scoring).

pub fn agg(self, name: impl Into<String>, agg: AggregationExpression) -> Self

Add a named aggregation.

pub fn size(self, size: usize) -> Self

Set the maximum number of hits to return.

pub fn from(self, from: usize) -> Self

Set the pagination offset.

pub fn sort(self, sort: Vec<SortField>) -> Self

Set the sort specification.

pub fn collapse(self, field: impl Into<String>) -> Self

Set the collapse field.

pub fn search_after(self, cursor: Vec<SortValue>) -> Self

Set the search_after cursor.

pub fn track_total_hits(self, mode: TrackTotalHits) -> Self

Set total hits tracking mode.

pub fn rescore(self, rescore: RescoreSpec) -> Self

Set a rescore specification.

impl SearchExpression

pub fn from_json( json: Value, default_size: usize, ) -> Result<SearchExpression, LuciError>

Parse an ES-compatible JSON search request.

Accepts both bare queries ({"match": {...}}) and structured requests ({"query": {...}, "aggs": {...}, "size": 10}).

Trait Implementations

impl Default for SearchExpression

fn default() -> Self

Returns the “default value” for a type.