291 lines
5.6 KiB
PHP
291 lines
5.6 KiB
PHP
<?php
|
|
declare(strict_types=1);
|
|
|
|
|
|
/**
|
|
* FullTextSearch - Full text search framework for extcloud
|
|
*
|
|
* This file is licensed under the Affero General Public License version 3 or
|
|
* later. See the COPYING file.
|
|
*
|
|
* @author Maxence Lange <maxence@artificial-owl.com>
|
|
* @copyright 2018
|
|
* @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 {
|
|
|
|
|
|
const INDEX_OK = 1;
|
|
const INDEX_IGNORE = 2;
|
|
|
|
const INDEX_META = 4;
|
|
const INDEX_CONTENT = 8;
|
|
const INDEX_PARTS = 16;
|
|
const INDEX_FULL = 28;
|
|
const INDEX_REMOVE = 32;
|
|
const INDEX_DONE = 64;
|
|
const INDEX_FAILED = 128;
|
|
|
|
const ERROR_FAILED = 1;
|
|
const ERROR_FAILED2 = 2;
|
|
const ERROR_FAILED3 = 4;
|
|
|
|
const ERROR_SEV_1 = 1;
|
|
const ERROR_SEV_2 = 2;
|
|
const ERROR_SEV_3 = 3;
|
|
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|int $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;
|
|
|
|
|
|
}
|