mirror of
https://github.com/nextcloud/server.git
synced 2026-02-03 20:41:22 -05:00
35dc223500
This is recurrent scenario that we are searching for users and then for each users we fetch the displayName. This is inefficient, so instead try to do one query to fetch everything (e.g. Database backend) or use the already existing DisplayNameCache helper. Signed-off-by: Carl Schwan <carl@carlschwan.eu>
165 lines
3.3 KiB
PHP
165 lines
3.3 KiB
PHP
<?php
|
|
/**
|
|
* @copyright Copyright (c) 2016, ownCloud, Inc.
|
|
*
|
|
* @author Joas Schilling <coding@schilljs.com>
|
|
* @author Johannes Leuker <j.leuker@hosting.de>
|
|
* @author John Molakvoæ <skjnldsv@protonmail.com>
|
|
* @author Julius Härtl <jus@bitgrid.net>
|
|
* @author Lukas Reschke <lukas@statuscode.ch>
|
|
* @author Morris Jobke <hey@morrisjobke.de>
|
|
* @author Robin Appelman <robin@icewind.nl>
|
|
* @author Vincent Petry <vincent@nextcloud.com>
|
|
*
|
|
* @license AGPL-3.0
|
|
*
|
|
* This code is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License, version 3,
|
|
* as published by the Free Software Foundation.
|
|
*
|
|
* 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, version 3,
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>
|
|
*
|
|
*/
|
|
namespace OCP;
|
|
|
|
/**
|
|
* Interface IGroup
|
|
*
|
|
* @since 8.0.0
|
|
*/
|
|
interface IGroup {
|
|
/**
|
|
* @return string
|
|
* @since 8.0.0
|
|
*/
|
|
public function getGID();
|
|
|
|
/**
|
|
* Returns the group display name
|
|
*
|
|
* @return string
|
|
* @since 12.0.0
|
|
*/
|
|
public function getDisplayName();
|
|
|
|
/**
|
|
* Set the group display name
|
|
*
|
|
* @param string $displayName
|
|
* @return bool
|
|
* @since 18.0.0
|
|
*/
|
|
public function setDisplayName(string $displayName): bool;
|
|
|
|
/**
|
|
* get all users in the group
|
|
*
|
|
* @return \OCP\IUser[]
|
|
* @since 8.0.0
|
|
*/
|
|
public function getUsers();
|
|
|
|
/**
|
|
* check if a user is in the group
|
|
*
|
|
* @param \OCP\IUser $user
|
|
* @return bool
|
|
* @since 8.0.0
|
|
*/
|
|
public function inGroup(IUser $user);
|
|
|
|
/**
|
|
* add a user to the group
|
|
*
|
|
* @param \OCP\IUser $user
|
|
* @since 8.0.0
|
|
*/
|
|
public function addUser(IUser $user);
|
|
|
|
/**
|
|
* remove a user from the group
|
|
*
|
|
* @param \OCP\IUser $user
|
|
* @since 8.0.0
|
|
*/
|
|
public function removeUser($user);
|
|
|
|
/**
|
|
* search for users in the group by userid
|
|
*
|
|
* @param string $search
|
|
* @param int $limit
|
|
* @param int $offset
|
|
* @return \OCP\IUser[]
|
|
* @since 8.0.0
|
|
*/
|
|
public function searchUsers(string $search, ?int $limit = null, ?int $offset = null): array;
|
|
|
|
/**
|
|
* returns the number of users matching the search string
|
|
*
|
|
* @param string $search
|
|
* @return int|bool
|
|
* @since 8.0.0
|
|
*/
|
|
public function count($search = '');
|
|
|
|
/**
|
|
* returns the number of disabled users
|
|
*
|
|
* @return int|bool
|
|
* @since 14.0.0
|
|
*/
|
|
public function countDisabled();
|
|
|
|
/**
|
|
* search for users in the group by displayname
|
|
*
|
|
* @param string $search
|
|
* @param int $limit
|
|
* @param int $offset
|
|
* @return \OCP\IUser[]
|
|
* @since 8.0.0
|
|
*/
|
|
public function searchDisplayName($search, $limit = null, $offset = null);
|
|
|
|
/**
|
|
* Get the names of the backends the group is connected to
|
|
*
|
|
* @return string[]
|
|
* @since 22.0.0
|
|
*/
|
|
public function getBackendNames();
|
|
|
|
/**
|
|
* delete the group
|
|
*
|
|
* @return bool
|
|
* @since 8.0.0
|
|
*/
|
|
public function delete();
|
|
|
|
/**
|
|
* @return bool
|
|
* @since 14.0.0
|
|
*/
|
|
public function canRemoveUser();
|
|
|
|
/**
|
|
* @return bool
|
|
* @since 14.0.0
|
|
*/
|
|
public function canAddUser();
|
|
|
|
/**
|
|
* @return bool
|
|
* @since 16.0.0
|
|
*/
|
|
public function hideFromCollaboration(): bool;
|
|
}
|