class item_search_service implements item_search_service_interface

internal  
 

Application-level facade for the Item Search Engine.

This service orchestrates the construction and execution of search queries. It acts as the boundary between the Controller/API and the complex SQL/SearchEngine.

Methods

__construct(factory $factory, executor $executor)

No description

search(search_criteria $criteria, search_metadata_criteria $meta, pagination|null $pagination = null, sorting|null $sorting = null, string|null $domain_class = null)

Perform an advanced item search using criteria, metadata, pagination, and sorting.

search_raw(search_criteria $criteria, search_metadata_criteria $meta, pagination|null $pagination = null, sorting|null $sorting = null)

Perform an advanced search returning stdClass records.

mixed
first(search_criteria $criteria, search_metadata_criteria $meta, string|null $domain_class = null)

Retrieve the first matching item.

Details

at line 47
__construct(factory $factory, executor $executor)

No description

Parameters

factory $factory

factory responsible for creating Query instances

executor $executor

component that executes queries and returns Result DTOs

Perform an advanced item search using criteria, metadata, pagination, and sorting.

The result will, by default, be hydrated into domain objects when a domain class with a TYPE constant is provided.

Parameters

search_criteria $criteria
search_metadata_criteria $meta
pagination|null $pagination
sorting|null $sorting
string|null $domain_class

(null = raw stdClass logic via engine)

Return Value

result_interface

Exceptions

coding_exception
dml_exception

at line 109
result_interface search_raw(search_criteria $criteria, search_metadata_criteria $meta, pagination|null $pagination = null, sorting|null $sorting = null)

Perform an advanced search returning stdClass records.

Parameters

search_criteria $criteria
search_metadata_criteria $meta
pagination|null $pagination
sorting|null $sorting

Return Value

result_interface

Exceptions

coding_exception
dml_exception

at line 134
mixed first(search_criteria $criteria, search_metadata_criteria $meta, string|null $domain_class = null)

Retrieve the first matching item.

Parameters

search_criteria $criteria
search_metadata_criteria $meta
string|null $domain_class

Return Value

mixed

Exceptions

coding_exception
dml_exception