nextcloud/lib/public/FullTextSearch/Model/IIndex.php

284 lines
5.6 KiB
PHP

<?php
declare(strict_types=1);
/**
* @copyright 2018
*
* @author Christoph Wurst <christoph@winzerhof-wurst.at>
* @author Maxence Lange <maxence@artificial-owl.com>
*
* @license GNU AGPL version 3 or any later version
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
*/
namespace OCP\FullTextSearch\Model;
/**
* Interface IIndex
*
* Index are generated by FullTextSearch to manage the status of a document
* regarding the date of the last index and the date of the last modification
* of the original document.
*
* The uniqueness of an IIndexDocument is made by the Id of the Content Provider
* and the Id of the original document within the Content Provider.
*
* We will call original document the source from which the IIndexDocument is
* generated. As an example, an original document can be a file, a mail, ...
*
* @since 15.0.0
*
* @package OCP\FullTextSearch\Model
*/
interface IIndex {
public const INDEX_OK = 1;
public const INDEX_IGNORE = 2;
public const INDEX_META = 4;
public const INDEX_CONTENT = 8;
public const INDEX_PARTS = 16;
public const INDEX_FULL = 28;
public const INDEX_REMOVE = 32;
public const INDEX_DONE = 64;
public const INDEX_FAILED = 128;
public const ERROR_FAILED = 1;
public const ERROR_FAILED2 = 2;
public const ERROR_FAILED3 = 4;
public const ERROR_SEV_1 = 1;
public const ERROR_SEV_2 = 2;
public const ERROR_SEV_3 = 3;
public const ERROR_SEV_4 = 4;
/**
* Get the Id of the Content Provider.
*
* @since 15.0.0
*
* @return string
*/
public function getProviderId(): string;
/**
* Get the Id of the original document.
*
* @since 15.0.0
*
* @return string
*/
public function getDocumentId(): string;
/**
* Set the source of the original document.
*
* @since 15.0.0
*
* @param string $source
*
* @return IIndex
*/
public function setSource(string $source): IIndex;
/**
* Get the source of the original document.
*
* @since 15.0.0
*
* @return string
*/
public function getSource(): string;
/**
* Set the owner of the original document.
*
* @since 15.0.0
*
* @param string $ownerId
*
* @return IIndex
*/
public function setOwnerId(string $ownerId): IIndex;
/**
* Get the owner of the original document.
*
* @since 15.0.0
*
* @return string
*/
public function getOwnerId(): string;
/**
* Set the current index status (bit flag) of the original document.
* If $reset is true, the status is reset to the defined value.
*
* @since 15.0.0
*
* @param int $status
* @param bool $reset
*
* @return IIndex
*/
public function setStatus(int $status, bool $reset = false): IIndex;
/**
* Get the current index status of the original document.
*
* @since 15.0.0
*
* @return int
*/
public function getStatus(): int;
/**
* Check if the document fit a specific status.
*
* @since 15.0.0
*
* @param int $status
*
* @return bool
*/
public function isStatus(int $status): bool;
/**
* Remove a status.
*
* @since 15.0.0
*
* @param int $status
*
* @return IIndex
*/
public function unsetStatus(int $status): IIndex;
/**
* Add an option related to the original document (as string).
*
* @since 15.0.0
*
* @param string $option
* @param string $value
*
* @return IIndex
*/
public function addOption(string $option, string $value): IIndex;
/**
* Add an option related to the original document (as integer).
*
* @since 15.0.0
*
* @param string $option
* @param int $value
*
* @return IIndex
*/
public function addOptionInt(string $option, int $value): IIndex;
/**
* Get the option related to the original document (as string).
*
* @since 15.0.0
*
* @param string $option
* @param string $default
*
* @return string
*/
public function getOption(string $option, string $default = ''): string;
/**
* Get the option related to the original document (as integer).
*
* @since 15.0.0
*
* @param string $option
* @param int $default
*
* @return int
*/
public function getOptionInt(string $option, int $default = 0): int;
/**
* Get all options related to the original document.
*
* @since 15.0.0
*
* @return array
*/
public function getOptions(): array;
/**
* Add an error log related to the Index.
*
* @since 15.0.0
*
* @param string $message
* @param string $exception
* @param int $sev
*
* @return IIndex
*/
public function addError(string $message, string $exception = '', int $sev = self::ERROR_SEV_3): IIndex;
/**
* Returns the number of known errors related to the Index.
*
* @since 15.0.0
*
* @return int
*/
public function getErrorCount(): int;
/**
* Reset all error logs related to the Index.
*
* @since 15.0.0
*/
public function resetErrors(): IIndex;
/**
* Set the date of the last index.
*
* @since 15.0.0
*
* @param int $lastIndex
*
* @return IIndex
*/
public function setLastIndex(int $lastIndex = -1): IIndex;
/**
* Get the date of the last index.
*
* @since 15.0.0
*
* @return int
*/
public function getLastIndex(): int;
}