Класс UserPrincipalLookupService
java.lang.Object
java.nio.file.attribute.UserPrincipalLookupService
public abstract class UserPrincipalLookupService extends Object
Объект для поиска пользователей и групп по имени.
UserPrincipal представляет собой идентификатор, который можно использовать для определения прав доступа к объектам в файловой системе. GroupPrincipal представляет собой идентификатор группы. UserPrincipalLookupService определяет методы для поиска идентификаторов по имени или имени группы (обычно это имена пользователей или учетных записей). Чувствительность имен и имен групп к регистру зависит от реализации. Точное определение группы зависит от реализации, но обычно группа представляет собой идентификатор, созданный для административных целей, чтобы определять права доступа участников группы. В частности, от реализации зависит, совпадают ли пространства имен для имен пользователей и групп или различаются. Для обеспечения единообразного и корректного поведения на разных платформах рекомендуется использовать этот API так, как если бы пространства имен различались. Иными словами, для поиска пользователей следует использовать lookupPrincipalByName, а для поиска групп — lookupPrincipalByGroupName.- С версии:
- 1.7
- См. также:
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Инициализирует новый экземпляр этого класса. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
abstract GroupPrincipal |
lookupPrincipalByGroupName |
Поиск идентификатора группы по имени группы. |
abstract UserPrincipal |
lookupPrincipalByName |
Поиск идентификатора пользователя по имени. |
Методы, объявленные в классе Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected Object |
clone() |
Создает и возвращает копию этого объекта. |
boolean |
equals |
Показывает, равен ли этот объект какому-либо другому объекту. |
protected void |
finalize() |
Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков. |
final Class |
getClass() |
Возвращает класс времени выполнения этого Object. |
int |
hashCode() |
Возвращает хеш-код этого объекта. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
String |
toString() |
Возвращает строковое представление объекта. |
final void |
wait() |
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени. |
Подробное описание конструкторов
UserPrincipalLookupService
protected UserPrincipalLookupService()
Инициализирует новый экземпляр этого класса.
Подробное описание методов
lookupPrincipalByName
public abstract UserPrincipal lookupPrincipalByName(String name) throws IOException
Поиск идентификатора пользователя по имени.
- Параметры:
-
name— строковое представление искомого идентификатора пользователя - Возвращает:
- идентификатор пользователя
- Исключения:
-
UserPrincipalNotFoundException— идентификатор не существует -
IOException— если произошла ошибка ввода-вывода
lookupPrincipalByGroupName
public abstract GroupPrincipal lookupPrincipalByGroupName(String group) throws IOException
Поиск идентификатора группы по имени группы.
Если реализация не поддерживает понятие группы, этот метод всегда выбрасывает исключение UserPrincipalNotFoundException. Если пространство имен учетных записей пользователей и групп совпадает, этот метод эквивалентен вызову lookupPrincipalByName.
- Параметры:
-
group— строковое представление искомой группы - Возвращает:
- идентификатор группы
- Исключения:
-
UserPrincipalNotFoundException— идентификатор не существует или не является группой -
IOException— если произошла ошибка ввода-вывода
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.