Класс UserPrincipalLookupService

java.lang.Object

java.nio.file.attribute.UserPrincipalLookupService

public abstract class UserPrincipalLookupService extends Object

Объект для поиска пользователей и групп по имени. UserPrincipal представляет собой идентификатор, который может использоваться для определения прав доступа к объектам в файловой системе. GroupPrincipal представляет собой идентификатор группы. UserPrincipalLookupService определяет методы для поиска идентификаторов по имени или имени группы (обычно имена пользователей или учётных записей). Чувствительность к регистру имён и имён групп зависит от реализации. Точное определение группы зависит от реализации, но, как правило, группа представляет собой идентификатор, созданный в административных целях для определения прав доступа для членов группы. В частности, зависит от реализации, является ли пространство имён для имён и групп одинаковым или разным. Для обеспечения согласованного и корректного поведения на разных платформах рекомендуется использовать этот API, как если бы пространства имён были разными. Другими словами, lookupPrincipalByName следует использовать для поиска пользователей, а lookupPrincipalByGroupName — для поиска групп.

Since:

1.7

See Also:

Краткое описание конструкторов

UserPrincipalLookupService()

Модификатор	Конструктор	Описание
`protected`	Инициализирует новый экземпляр этого класса.

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract GroupPrincipal`	`lookupPrincipalByGroupName(String group)`	Поиск идентификатора группы по имени группы.
`abstract UserPrincipal`	`lookupPrincipalByName(String name)`	Поиск идентификатора пользователя по имени.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

UserPrincipalLookupService

protected UserPrincipalLookupService()

Инициализирует новый экземпляр этого класса.

Подробное описание методов

lookupPrincipalByName

public abstract UserPrincipal lookupPrincipalByName(String name) throws IOException

Поиск идентификатора пользователя по имени.

Параметры:: name - строковое представление идентификатора пользователя для поиска
Возвращает:: идентификатор пользователя
Исключения:: UserPrincipalNotFoundException - идентификатор не существует; IOException - если произошла ошибка ввода-вывода; SecurityException - В случае с поставщиком по умолчанию и установленным менеджером безопасности проверяется RuntimePermission("lookupUserInformation")

lookupPrincipalByGroupName

public abstract GroupPrincipal lookupPrincipalByGroupName(String group) throws IOException

Поиск идентификатора группы по имени группы.

Если реализация не поддерживает понятие группы, этот метод всегда выбрасывает UserPrincipalNotFoundException. Если пространство имён для учётных записей пользователей и групп совпадает, этот метод идентичен вызову lookupPrincipalByName.

Параметры:: group - строковое представление группы для поиска
Возвращает:: идентификатор группы
Исключения:: UserPrincipalNotFoundException - идентификатор не существует или не является группой; IOException - если произошла ошибка ввода-вывода; SecurityException - В случае с поставщиком по умолчанию и установленным менеджером безопасности проверяется RuntimePermission("lookupUserInformation")

© 1993, 2023, 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.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/attribute/UserPrincipalLookupService.html