3 * This program is free software; you can redistribute it and/or modify
4 * it under the terms of the GNU General Public License as published by
5 * the Free Software Foundation; either version 2 of the License, or
6 * (at your option) any later version.
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
13 * You should have received a copy of the GNU General Public License along
14 * with this program; if not, write to the Free Software Foundation, Inc.,
15 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
16 * http://www.gnu.org/copyleft/gpl.html
21 namespace MediaWiki\User
;
24 use InvalidArgumentException
;
25 use Wikimedia\Rdbms\IReadableDatabase
;
28 * Service for looking up UserIdentity
30 * @package MediaWiki\User
33 interface UserIdentityLookup
extends IDBAccessObject
{
36 * Find an identity of a user by $name
39 * @param int $queryFlags one of IDBAccessObject constants
40 * @return UserIdentity|null
41 * @throws InvalidArgumentException if non-normalizable actor name is passed.
43 public function getUserIdentityByName(
45 int $queryFlags = self
::READ_NORMAL
49 * Find an identity of a user by $userId
52 * @param int $queryFlags one of IDBAccessObject constants
53 * @return UserIdentity|null
55 public function getUserIdentityByUserId(
57 int $queryFlags = self
::READ_NORMAL
61 * Returns a specialized SelectQueryBuilder for querying the UserIdentity objects.
63 * @param IReadableDatabase|int $dbOrQueryFlags The database connection to perform the query on,
64 * or one of the self::READ_* constants.
65 * @return UserSelectQueryBuilder
67 public function newSelectQueryBuilder( $dbOrQueryFlags = self
::READ_NORMAL
): UserSelectQueryBuilder
;