interface DatabaseCompatibilityHandlerInterface in Search API 8

Bundles methods for resolving DBMS-specific differences.

@internal This interface and all implementing classes are just used by the search_api_db module for internal purposes. They should not be relied upon in other modules.

Hierarchy

• interface \Drupal\search_api_db\DatabaseCompatibility\DatabaseCompatibilityHandlerInterface

1 file declares its use of DatabaseCompatibilityHandlerInterface

Database.php in modules/search_api_db/src/Plugin/search_api/backend/Database.php

File

modules/search_api_db/src/DatabaseCompatibility/DatabaseCompatibilityHandlerInterface.php, line 15

Namespace

Drupal\search_api_db\DatabaseCompatibility

interface DatabaseCompatibilityHandlerInterface {

  /**
   * Retrieves the database connection this compatibility handler is based upon.
   *
   * @return \Drupal\Core\Database\Connection
   *   The database connection.
   */
  public function getDatabase();

  /**
   * Creates a clone of this service for the given database.
   *
   * @param \Drupal\Core\Database\Connection $database
   *   A database of a type compatible with this class.
   *
   * @return static
   *   A clone of this service class for the given database.
   */
  public function getCloneForDatabase(Connection $database);

  /**
   * Reacts to a new table being created.
   *
   * @param string $table
   *   The name of the table.
   * @param string $type
   *   (optional) The type of table. One of "index" (for the denormalized table
   *   for an entire index), "text" (for an index's fulltext data table) and
   *   "field" (for field-specific tables).
   *
   * @throws \Drupal\search_api\SearchApiException
   *   Thrown if any error occurs that should abort the current action. Internal
   *   errors that can be ignored should just be logged.
   */
  public function alterNewTable($table, $type = 'text');

  /**
   * Determines the canonical base form of a value.
   *
   * For example, when the table is case-insensitive, the value should always be
   * lowercased (or always uppercased) to arrive at the canonical base form.
   *
   * If tables of the given type use binary comparison in this database, the
   * value should not be changed.
   *
   * @param string $value
   *   A string to be indexed or searched for.
   * @param string $type
   *   (optional) The type of table. One of "index" (for the denormalized table
   *   for an entire index), "text" (for an index's fulltext data table) and
   *   "field" (for field-specific tables).
   *
   * @return string
   *   The value in its canonical base form, which won't clash with any other
   *   canonical base form when inserted into a table of the given type.
   */
  public function preprocessIndexValue($value, $type = 'text');

  /**
   * Applies a random sort to the query.
   *
   * @param \Drupal\Core\Database\Query\SelectInterface $query
   *   The search query.
   */
  public function orderByRandom(SelectInterface $query);

}

Members

Name	Modifiers	Type	Description	Overrides
DatabaseCompatibilityHandlerInterface::alterNewTable	public	function	Reacts to a new table being created.	1
DatabaseCompatibilityHandlerInterface::getCloneForDatabase	public	function	Creates a clone of this service for the given database.	1
DatabaseCompatibilityHandlerInterface::getDatabase	public	function	Retrieves the database connection this compatibility handler is based upon.	1
DatabaseCompatibilityHandlerInterface::orderByRandom	public	function	Applies a random sort to the query.	1
DatabaseCompatibilityHandlerInterface::preprocessIndexValue	public	function	Determines the canonical base form of a value.	1