8f6939f594
This skips ones that have been marked but were never in the then RELEASE-NOTES and later HISTORY file, and so weren't properly deprecated ever. Change-Id: I31df2d7e83182b5bf9524237fc4a1862356bfd5a
79 lines
2.2 KiB
PHP
79 lines
2.2 KiB
PHP
<?php
|
|
|
|
/**
|
|
* BaseSearchResultSet is the base class that must be extended by SearchEngine
|
|
* search result set implementations.
|
|
*
|
|
* This base class is meant to hold B/C behaviors and to be useful it must never:
|
|
* - be used as type hints (ISearchResultSet must be used for this)
|
|
* - implement a constructor
|
|
* - declare utility methods
|
|
*
|
|
* @stable to extend
|
|
* @ingroup Search
|
|
*/
|
|
abstract class BaseSearchResultSet implements ISearchResultSet {
|
|
|
|
/**
|
|
* @var ArrayIterator|null Iterator supporting BC iteration methods
|
|
*/
|
|
private $bcIterator;
|
|
|
|
/**
|
|
* Fetches next search result, or false.
|
|
* @deprecated since 1.32; Use self::extractResults() or foreach
|
|
* @return SearchResult|false
|
|
*/
|
|
public function next() {
|
|
wfDeprecated( __METHOD__, '1.32' );
|
|
$it = $this->bcIterator();
|
|
$searchResult = $it->current();
|
|
$it->next();
|
|
return $searchResult ?? false;
|
|
}
|
|
|
|
/**
|
|
* Rewind result set back to beginning
|
|
* @deprecated since 1.32; Use self::extractResults() or foreach
|
|
*/
|
|
public function rewind() {
|
|
wfDeprecated( __METHOD__, '1.32' );
|
|
$this->bcIterator()->rewind();
|
|
}
|
|
|
|
private function bcIterator() {
|
|
if ( $this->bcIterator === null ) {
|
|
// @phan-suppress-next-line PhanTypeMismatchProperty Expected
|
|
$this->bcIterator = 'RECURSION';
|
|
$this->bcIterator = $this->getIterator();
|
|
} elseif ( $this->bcIterator === 'RECURSION' ) {
|
|
// @phan-suppress-previous-line PhanTypeComparisonFromArray Use of string is a hack
|
|
// Either next/rewind or extractResults must be implemented. This
|
|
// class was potentially instantiated directly. It should be
|
|
// abstract with abstract methods to enforce this but that's a
|
|
// breaking change...
|
|
wfDeprecated( static::class . ' without implementing extractResults', '1.32' );
|
|
$this->bcIterator = new ArrayIterator( [] );
|
|
}
|
|
return $this->bcIterator;
|
|
}
|
|
|
|
/**
|
|
* Fetch an array of regular expression fragments for matching
|
|
* the search terms as parsed by this engine in a text extract.
|
|
* STUB
|
|
*
|
|
* @return string[]
|
|
* @deprecated since 1.34 (use SqlSearchResult)
|
|
*/
|
|
public function termMatches() {
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* Frees the result set, if applicable.
|
|
* @deprecated since 1.34; noop
|
|
*/
|
|
public function free() {
|
|
}
|
|
}
|