interface ResultSetInterface in Search API 8

Represents the result set of a search query.

The \Traversable implementation should iterate over the returned result items.

Hierarchy

• interface \Drupal\search_api\Query\ResultSetInterface extends \Drupal\search_api\Query\Traversable

17 files declare their use of ResultSetInterface

BackendTestBase.php in tests/src/Kernel/BackendTestBase.php

Highlight.php in src/Plugin/search_api/processor/Highlight.php

Index.php in src/Entity/Index.php

IndexInterface.php in src/IndexInterface.php

NumberFieldBoostTest.php in tests/src/Kernel/Processor/NumberFieldBoostTest.php

... See full list

File

src/Query/ResultSetInterface.php, line 13

Namespace

Drupal\search_api\Query

interface ResultSetInterface extends \Traversable {

  /**
   * Retrieves the query executed for this search result.
   *
   * @return \Drupal\search_api\Query\QueryInterface
   *   The executed query.
   */
  public function getQuery();

  /**
   * Retrieves the total number of results that were found in this search.
   *
   * @return int|null
   *   The total number of results, if set. NULL otherwise.
   */
  public function getResultCount();

  /**
   * Sets the result count of the search.
   *
   * @param int $result_count
   *   The number of search results, in total.
   *
   * @return $this
   */
  public function setResultCount($result_count);

  /**
   * Retrieves the query result items.
   *
   * @return \Drupal\search_api\Item\ItemInterface[]
   *   The query result items, keyed by item ID.
   */
  public function getResultItems();

  /**
   * Adds a new result item.
   *
   * This method has to be invoked in the correct order, with the first-ordered
   * item being added first and so on.
   *
   * @param \Drupal\search_api\Item\ItemInterface $result_item
   *   One of the search results.
   *
   * @return $this
   */
  public function addResultItem(ItemInterface $result_item);

  /**
   * Sets the query result items.
   *
   * @param \Drupal\search_api\Item\ItemInterface[] $result_items
   *   The query result items, keyed by item ID.
   *
   * @return $this
   */
  public function setResultItems(array $result_items);

  /**
   * Loads all "original objects" of the result items that have not been loaded.
   *
   * This can be used in case original objects are needed for all results, to
   * make sure they are multi-loaded, avoiding the performance penalty
   * associated with loading them individually.
   */
  public function preLoadResultItems();

  /**
   * Returns the warnings triggered by the search query.
   *
   * @return string[]
   *   An array of translated, sanitized warning messages that may be displayed
   *   to the user.
   */
  public function getWarnings();

  /**
   * Adds a warning message that was triggered by the search query.
   *
   * @param string $warning
   *   A translated, sanitized warning message that may be displayed to the
   *   user.
   *
   * @return $this
   */
  public function addWarning($warning);

  /**
   * Sets the warnings triggered by the search query.
   *
   * @param string[] $warnings
   *   An array of translated, sanitized warning messages that may be displayed
   *   to the user.
   *
   * @return $this
   */
  public function setWarnings(array $warnings);

  /**
   * Returns the ignored search keys, if any.
   *
   * @return string[]
   *   A numeric array of search keys that were ignored for this search (for
   *   example, because of being too short or stop words).
   */
  public function getIgnoredSearchKeys();

  /**
   * Adds an ignored search key for the search query.
   *
   * @param string $ignored_search_key
   *   A single search key (word) that was ignored in the search.
   *
   * @return $this
   */
  public function addIgnoredSearchKey($ignored_search_key);

  /**
   * Sets the ignored search keys of the search query.
   *
   * @param string[] $ignored_search_keys
   *   An array of search keys (individual words) that were ignored in the
   *   search.
   *
   * @return $this
   */
  public function setIgnoredSearchKeys(array $ignored_search_keys);

  /**
   * Determines whether extra data with a specific key is set on this result.
   *
   * @param string $key
   *   The extra data's key.
   *
   * @return bool
   *   TRUE if the data is set, FALSE otherwise.
   */
  public function hasExtraData($key);

  /**
   * Retrieves extra data for this search result.
   *
   * @param string $key
   *   The key of the extra data.
   * @param mixed $default
   *   (optional) The value to return if the data is not set.
   *
   * @return mixed
   *   The data set for that key, or $default if the data is not present.
   */
  public function getExtraData($key, $default = NULL);

  /**
   * Retrieves all extra data set for this search result.
   *
   * The data is returned as a reference so that it can be altered this way.
   *
   * @return array
   *   An array mapping extra data keys to their data.
   */
  public function &getAllExtraData();

  /**
   * Sets some extra data for this search result.
   *
   * @param string $key
   *   The key for the extra data.
   * @param mixed $data
   *   (optional) The data to set. If NULL, remove the extra data with the given
   *   key instead.
   *
   * @return $this
   */
  public function setExtraData($key, $data = NULL);

  /**
   * Creates a clone of this result set based on the given query.
   *
   * @param \Drupal\search_api\Query\QueryInterface $query
   *   The query for the new result set.
   *
   * @return static
   *   A clone of this result set.
   */
  public function getCloneForQuery(QueryInterface $query);

}

Members

Name	Modifiers	Type	Description	Overrides
ResultSetInterface::addIgnoredSearchKey	public	function	Adds an ignored search key for the search query.	1
ResultSetInterface::addResultItem	public	function	Adds a new result item.	1
ResultSetInterface::addWarning	public	function	Adds a warning message that was triggered by the search query.	1
ResultSetInterface::getAllExtraData	public	function	Retrieves all extra data set for this search result.	1
ResultSetInterface::getCloneForQuery	public	function	Creates a clone of this result set based on the given query.	1
ResultSetInterface::getExtraData	public	function	Retrieves extra data for this search result.	1
ResultSetInterface::getIgnoredSearchKeys	public	function	Returns the ignored search keys, if any.	1
ResultSetInterface::getQuery	public	function	Retrieves the query executed for this search result.	1
ResultSetInterface::getResultCount	public	function	Retrieves the total number of results that were found in this search.	1
ResultSetInterface::getResultItems	public	function	Retrieves the query result items.	1
ResultSetInterface::getWarnings	public	function	Returns the warnings triggered by the search query.	1
ResultSetInterface::hasExtraData	public	function	Determines whether extra data with a specific key is set on this result.	1
ResultSetInterface::preLoadResultItems	public	function	Loads all "original objects" of the result items that have not been loaded.	1
ResultSetInterface::setExtraData	public	function	Sets some extra data for this search result.	1
ResultSetInterface::setIgnoredSearchKeys	public	function	Sets the ignored search keys of the search query.	1
ResultSetInterface::setResultCount	public	function	Sets the result count of the search.	1
ResultSetInterface::setResultItems	public	function	Sets the query result items.	1
ResultSetInterface::setWarnings	public	function	Sets the warnings triggered by the search query.	1