Deprecate \OCP\ISearch
Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>
This commit is contained in:
parent
f8e08a74ba
commit
27b8637e3e
|
@ -32,6 +32,7 @@ use OC\Files\Filesystem;
|
|||
|
||||
/**
|
||||
* Provide search results from the 'files' app
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
class File extends \OCP\Search\Provider {
|
||||
|
||||
|
@ -39,6 +40,7 @@ class File extends \OCP\Search\Provider {
|
|||
* Search for files and folders matching the given query
|
||||
* @param string $query
|
||||
* @return \OCP\Search\Result
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public function search($query) {
|
||||
$files = Filesystem::search($query);
|
||||
|
|
|
@ -27,15 +27,17 @@ namespace OC\Search\Result;
|
|||
|
||||
/**
|
||||
* A found audio file
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
class Audio extends File {
|
||||
|
||||
/**
|
||||
* Type name; translated in templates
|
||||
* @var string
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public $type = 'audio';
|
||||
|
||||
|
||||
/**
|
||||
* @TODO add ID3 information
|
||||
*/
|
||||
|
|
|
@ -31,36 +31,42 @@ use OCP\Files\Folder;
|
|||
|
||||
/**
|
||||
* A found file
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
class File extends \OCP\Search\Result {
|
||||
|
||||
/**
|
||||
* Type name; translated in templates
|
||||
* @var string
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public $type = 'file';
|
||||
|
||||
/**
|
||||
* Path to file
|
||||
* @var string
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public $path;
|
||||
|
||||
/**
|
||||
* Size, in bytes
|
||||
* @var int
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public $size;
|
||||
|
||||
/**
|
||||
* Date modified, in human readable form
|
||||
* @var string
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public $modified;
|
||||
|
||||
/**
|
||||
* File mime type
|
||||
* @var string
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public $mime_type;
|
||||
|
||||
|
@ -68,12 +74,14 @@ class File extends \OCP\Search\Result {
|
|||
* File permissions:
|
||||
*
|
||||
* @var string
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public $permissions;
|
||||
|
||||
/**
|
||||
* Create a new file search result
|
||||
* @param FileInfo $data file data given by provider
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public function __construct(FileInfo $data) {
|
||||
$path = $this->getRelativePath($data->getPath());
|
||||
|
@ -97,6 +105,7 @@ class File extends \OCP\Search\Result {
|
|||
|
||||
/**
|
||||
* @var Folder $userFolderCache
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
protected static $userFolderCache = null;
|
||||
|
||||
|
@ -105,6 +114,7 @@ class File extends \OCP\Search\Result {
|
|||
* eg /user/files/foo.txt -> /foo.txt
|
||||
* @param string $path
|
||||
* @return string relative path
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
protected function getRelativePath($path) {
|
||||
if (!isset(self::$userFolderCache)) {
|
||||
|
|
|
@ -27,12 +27,14 @@ namespace OC\Search\Result;
|
|||
|
||||
/**
|
||||
* A found folder
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
class Folder extends File {
|
||||
|
||||
/**
|
||||
* Type name; translated in templates
|
||||
* @var string
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public $type = 'folder';
|
||||
}
|
||||
|
|
|
@ -27,15 +27,17 @@ namespace OC\Search\Result;
|
|||
|
||||
/**
|
||||
* A found image file
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
class Image extends File {
|
||||
|
||||
/**
|
||||
* Type name; translated in templates
|
||||
* @var string
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public $type = 'image';
|
||||
|
||||
|
||||
/**
|
||||
* @TODO add EXIF information
|
||||
*/
|
||||
|
|
|
@ -29,6 +29,7 @@ namespace OCP;
|
|||
/**
|
||||
* Small Interface for Search
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
interface ISearch {
|
||||
|
||||
|
@ -40,6 +41,7 @@ interface ISearch {
|
|||
* @param int $size
|
||||
* @return array An array of OCP\Search\Result's
|
||||
* @since 8.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public function searchPaged($query, array $inApps = [], $page = 1, $size = 30);
|
||||
|
||||
|
@ -48,6 +50,7 @@ interface ISearch {
|
|||
* @param string $class class name of a OCP\Search\Provider
|
||||
* @param array $options optional
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public function registerProvider($class, array $options = []);
|
||||
|
||||
|
@ -55,12 +58,14 @@ interface ISearch {
|
|||
* Remove one existing search provider
|
||||
* @param string $provider class name of a OCP\Search\Provider
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public function removeProvider($provider);
|
||||
|
||||
/**
|
||||
* Remove all registered search providers
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public function clearProviders();
|
||||
}
|
||||
|
|
|
@ -359,6 +359,7 @@ interface IServerContainer extends IContainer {
|
|||
*
|
||||
* @return \OCP\ISearch
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public function getSearch();
|
||||
|
||||
|
|
|
@ -30,12 +30,14 @@ namespace OCP\Search;
|
|||
/**
|
||||
* Provides a template for search functionality throughout ownCloud;
|
||||
* @since 8.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
abstract class PagedProvider extends Provider {
|
||||
|
||||
/**
|
||||
* show all results
|
||||
* @since 8.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public const SIZE_ALL = 0;
|
||||
|
||||
|
@ -43,6 +45,7 @@ abstract class PagedProvider extends Provider {
|
|||
* Constructor
|
||||
* @param array $options
|
||||
* @since 8.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public function __construct($options) {
|
||||
parent::__construct($options);
|
||||
|
@ -53,6 +56,7 @@ abstract class PagedProvider extends Provider {
|
|||
* @param string $query
|
||||
* @return array An array of OCP\Search\Result's
|
||||
* @since 8.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public function search($query) {
|
||||
// old apps might assume they get all results, so we use SIZE_ALL
|
||||
|
@ -66,6 +70,7 @@ abstract class PagedProvider extends Provider {
|
|||
* @param int $size 0 = SIZE_ALL
|
||||
* @return array An array of OCP\Search\Result's
|
||||
* @since 8.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
abstract public function searchPaged($query, $page, $size);
|
||||
}
|
||||
|
|
|
@ -30,11 +30,13 @@ namespace OCP\Search;
|
|||
/**
|
||||
* Provides a template for search functionality throughout ownCloud;
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
abstract class Provider {
|
||||
|
||||
/**
|
||||
* @since 8.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public const OPTION_APPS = 'apps';
|
||||
|
||||
|
@ -42,6 +44,7 @@ abstract class Provider {
|
|||
* List of options
|
||||
* @var array
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
protected $options;
|
||||
|
||||
|
@ -49,6 +52,7 @@ abstract class Provider {
|
|||
* Constructor
|
||||
* @param array $options as key => value
|
||||
* @since 7.0.0 - default value for $options was added in 8.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public function __construct($options = []) {
|
||||
$this->options = $options;
|
||||
|
@ -59,6 +63,7 @@ abstract class Provider {
|
|||
* @param string $key
|
||||
* @return mixed
|
||||
* @since 8.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public function getOption($key) {
|
||||
if (is_array($this->options) && isset($this->options[$key])) {
|
||||
|
@ -76,6 +81,7 @@ abstract class Provider {
|
|||
* @param string[] $apps
|
||||
* @return bool
|
||||
* @since 8.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public function providesResultsFor(array $apps = []) {
|
||||
$forApps = $this->getOption(self::OPTION_APPS);
|
||||
|
@ -87,6 +93,7 @@ abstract class Provider {
|
|||
* @param string $query
|
||||
* @return array An array of OCP\Search\Result's
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
abstract public function search($query);
|
||||
}
|
||||
|
|
|
@ -29,6 +29,7 @@ namespace OCP\Search;
|
|||
/**
|
||||
* The generic result of a search
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
class Result {
|
||||
|
||||
|
@ -37,6 +38,7 @@ class Result {
|
|||
* corresponding application.
|
||||
* @var string
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public $id;
|
||||
|
||||
|
@ -45,6 +47,7 @@ class Result {
|
|||
* results.
|
||||
* @var string
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public $name;
|
||||
|
||||
|
@ -52,6 +55,7 @@ class Result {
|
|||
* URL to the application item.
|
||||
* @var string
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public $link;
|
||||
|
||||
|
@ -60,6 +64,7 @@ class Result {
|
|||
* as the class name (e.g. \OC\Search\File -> 'file') in lowercase.
|
||||
* @var string
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public $type = 'generic';
|
||||
|
||||
|
@ -69,6 +74,7 @@ class Result {
|
|||
* @param string $name displayed text of result
|
||||
* @param string $link URL to the result within its app
|
||||
* @since 7.0.0
|
||||
* @deprecated 20.0.0
|
||||
*/
|
||||
public function __construct($id = null, $name = null, $link = null) {
|
||||
$this->id = $id;
|
||||
|
|
Loading…
Reference in New Issue