VuFind Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Search Service ======

===== Introduction =====

VuFind 2.0 includes a completely refactored search system that integrates access to the application's remote search systems. The design goals for the new search system are as follows:

  * separate re-usable classes for interacting with a specific remote system and the application-specifc implementation
  * streamline the interface of backend related classes
  * use [[development:architecture:laminas|Laminas]]' capabilities to provide, extend and/or augment the VuFind implementation

FIXME

{{:wiki:vf2-search-sequence.png?linkonly|sequence diagram}}

===== Backend =====

Access to the remote system is implemented by a backend class that implements at least the two retrieval functions ''search()'' and ''retrieve()'', and getter and setter of a unique identifier of a particular backend instance. 

  interface VuFindSearch\Backend\BackendInterface
    public function setIdentifier($identifier);
    public function getIdentifier();
    public function search(AbstractQuery $query, $offset, $limit, ParamBag $params = null);
    public function retrieve($id, ParamBag $params = null);

Both retrieval functions must return a (possibly empty) iterable collection of records, in most cases a simple wrapper around the remote system's response document.

  VuFindSearch\Response\RecordCollectionInterface extends Countable, Iterator
    public function setSourceIdentifier($identifier);
    public function getSourceIdentifier();
    public function getTotal();
    public function getFacets();
    public function getRecords();
    public function getOffset();
    public function first();
    public function add(RecordInterface $record);

Each member of the collection must implement a getter and setter for a backend identifier that servers as an indicator of the record's source.

  VuFindSearch\Response\RecordInterface
    public function setSourceIdentifier($identifier);
    public function getSourceIdentifier();

==== Example: The SOLR Backend ====

:!: In VuFind 2.0 RC1 the separation of Backend and Connector responsibilities is not yet fully implemented. :!:

The SOLR backend provides most feature-rich implementation of a VuFind 2 backend.

The SOLR backend uses a dedicated Connector class that adds another level of abstraction: While the backend translates the user-initiated retrieval operation into a set of SOLR query parameters, the Connector maps the operation to the responsible SOLR request handler and handles the HTTP transport layer. 

The Connector returns a serialized SOLR response (i.e. the body of the HTTP response) which is deserialized by the Backend. The deserialized response is then passed to a configurable factory that creates the record collection containing the records.

FIXME

===== Search Service =====

The search service integrates all backends used by the VuFind application. Instead of using the backend classes directly, all retrieval operations use the search service class and select the backend by passing its identifier as first argument. This indirection is necessary in order to implement a well defined behavior of retrieval operations required to extend and/or modify the application without modifying the core classes or hardcoding application specific behavior.

:!: It is worth noting that every retrieval operation can be called with a 'parameter bag' that holds backend specific operation parameters. This certainly puts limitations on the integration part, but allows for a great deal of flexibility with regards to backend features :!:

The search service uses a scoped service manager bound to the namespace ''VuFind\Search'' and emits the following events:

==== resolve ====

The target of the ''resolve'' event is the name of the backend to perform a retrieval operation on. The event is short-circuited and stops as soon as a listener returns a backend instance. Backends are only resolved once during a run of the application.

==== pre ====

The target of the ''pre'' event is the backend instance. Listeners can access the operation name and parameters via the event's parameters. Parameters that are implemented as objects, such as the parameter bag can be modified by a listener. All other parameters are immutable.

==== post ====

The target of the ''post'' event is the return value of the requested operation.

==== error ====

If a backend implementation raised an exception this event is triggered with the exception object as target. Listeners can be attached to e.g. annotate the exception or log specific errors of a third party index provider.


===== Additional Resources =====

This [[https://www.youtube.com/watch?v=8InrSNbt1Sk|Video Presentation from the 2013 VuFind Summit]] features some detailed discussion of the search service. Slides are available [[http://vufind.org/docs/summit2013/search.ppt|here]].

The [[videos:search_system|Search System Overview and Update]] video from 2021 provides some valuable updates to the original 2013 Summit content, addressing changes made in release 8.0.