interface IndexTaskManagerInterface in Search API 8

Defines the interface for the index task manager.

Hierarchy

• interface \Drupal\search_api\Task\IndexTaskManagerInterface

1 file declares its use of IndexTaskManagerInterface

IndexStatusForm.php in src/Form/IndexStatusForm.php

File

src/Task/IndexTaskManagerInterface.php, line 10

Namespace

Drupal\search_api\Task

interface IndexTaskManagerInterface {

  /**
   * Creates a task to start tracking for the given index, or some datasources.
   *
   * @param \Drupal\search_api\IndexInterface $index
   *   The search index.
   * @param string[]|null $datasource_ids
   *   (optional) The IDs of specific datasources for which tracking should
   *   start. Or NULL to start tracking for all datasources.
   */
  public function startTracking(IndexInterface $index, array $datasource_ids = NULL);

  /**
   * Adds a single page of items to the tracker.
   *
   * @param \Drupal\search_api\IndexInterface $index
   *   The search index.
   *
   * @return bool
   *   TRUE if tracking for this index has been finished, FALSE otherwise.
   *
   * @throws \Drupal\search_api\SearchApiException
   *   Thrown if any error occurred while tracking items.
   */
  public function addItemsOnce(IndexInterface $index);

  /**
   * Sets a batch to track all remaining items for the given index.
   *
   * @param \Drupal\search_api\IndexInterface $index
   *   The search index.
   */
  public function addItemsBatch(IndexInterface $index);

  /**
   * Tracks all remaining items for the given index.
   *
   * Since no kind of batch processing is used, this might run out of memory or
   * execution time on larger sites.
   *
   * @param \Drupal\search_api\IndexInterface $index
   *   The search index.
   *
   * @throws \Drupal\search_api\SearchApiException
   *   Thrown if any error occurred while tracking items.
   */
  public function addItemsAll(IndexInterface $index);

  /**
   * Stops tracking for the given index.
   *
   * Will delete any remaining tracking tasks and also remove all items from
   * tracking for this index.
   *
   * @param \Drupal\search_api\IndexInterface $index
   *   The search index.
   * @param string[]|null $datasource_ids
   *   (optional) The IDs of the datasources for which to stop tracking. Or NULL
   *   to stop tracking for all datasources.
   */
  public function stopTracking(IndexInterface $index, array $datasource_ids = NULL);

  /**
   * Checks whether tracking has already been completed for the given index.
   *
   * @param \Drupal\search_api\IndexInterface $index
   *   The search index.
   *
   * @return bool
   *   TRUE if tracking has been completed for the given index, FALSE otherwise.
   */
  public function isTrackingComplete(IndexInterface $index);

}

Members

Name	Modifiers	Type	Description	Overrides
IndexTaskManagerInterface::addItemsAll	public	function	Tracks all remaining items for the given index.	1
IndexTaskManagerInterface::addItemsBatch	public	function	Sets a batch to track all remaining items for the given index.	1
IndexTaskManagerInterface::addItemsOnce	public	function	Adds a single page of items to the tracker.	1
IndexTaskManagerInterface::isTrackingComplete	public	function	Checks whether tracking has already been completed for the given index.	1
IndexTaskManagerInterface::startTracking	public	function	Creates a task to start tracking for the given index, or some datasources.	1
IndexTaskManagerInterface::stopTracking	public	function	Stops tracking for the given index.	1