Merge "Add SearchIndexField::getEngineHints()"

diff --git a/includes/search/NullIndexField.php b/includes/search/NullIndexField.php
index 933e0ad..852e1d5 100644 (file)
--- a/includes/search/NullIndexField.php
+++ b/includes/search/NullIndexField.php
@@ -42,4 +42,11 @@ class NullIndexField implements SearchIndexField {
        public function merge( SearchIndexField $that ) {
                return $that;
        }
+
+       /**
+        * {@inheritDoc}
+        */
+       public function getEngineHints( SearchEngine $engine ) {
+               return [];
+       }
 }

diff --git a/includes/search/SearchIndexField.php b/includes/search/SearchIndexField.php
index 6b5316f..a348d6d 100644 (file)
--- a/includes/search/SearchIndexField.php
+++ b/includes/search/SearchIndexField.php
@@ -72,4 +72,21 @@ interface SearchIndexField {
         * @return SearchIndexField|false New definition or false if not mergeable.
         */
        public function merge( SearchIndexField $that );
+
+       /**
+        * A list of search engine hints for this field.
+        * Hints are usually specific to a search engine implementation
+        * and allow to fine control how the search engine will handle this
+        * particular field.
+        *
+        * For example some search engine permits some optimizations
+        * at index time by ignoring an update if the updated value
+        * does not change by more than X% on a numeric value.
+        *
+        * @param SearchEngine $engine
+        * @return array an array of hints generally indexed by hint name. The type of
+        * values is search engine specific
+        * @since 1.30
+        */
+       public function getEngineHints( SearchEngine $engine );
 }

diff --git a/includes/search/SearchIndexFieldDefinition.php b/includes/search/SearchIndexFieldDefinition.php
index 04344fd..e3e01e8 100644 (file)
--- a/includes/search/SearchIndexFieldDefinition.php
+++ b/includes/search/SearchIndexFieldDefinition.php
@@ -140,4 +140,11 @@ abstract class SearchIndexFieldDefinition implements SearchIndexField {
        public function setMergeCallback( $callback ) {
                $this->mergeCallback = $callback;
        }
+
+       /**
+        * {@inheritDoc}
+        */
+       public function getEngineHints( SearchEngine $engine ) {
+               return [];
+       }
 }