Spec-Zone.ru › OpenJDK 25

Класс UserPrincipalLookupService

java.lang.Object
java.nio.file.attribute.UserPrincipalLookupService
public abstract class UserPrincipalLookupService extends Object
Объект для поиска субъектов-пользователей и субъектов-групп по имени. UserPrincipal представляет идентификатор, который можно использовать для определения прав доступа к объектам в файловой системе. GroupPrincipal представляет идентификатор группы. UserPrincipalLookupService определяет методы для поиска идентификаторов по имени или имени группы (обычно это имена пользователей или учетных записей). Чувствительность имен и имен групп к регистру зависит от реализации. Точное определение группы зависит от реализации, но обычно группа представляет собой идентификатор, созданный в административных целях для определения прав доступа участников группы. В частности, от реализации зависит, является ли пространство имен для имен и групп общим или раздельным. Для обеспечения единообразного и корректного поведения на разных платформах рекомендуется использовать этот API так, как если бы пространства имен были раздельными. Иными словами, для поиска пользователей следует использовать lookupPrincipalByName, а для поиска групп — lookupPrincipalByGroupName.
С момента появления:
1.7
См. также:
  • FileSystem.getUserPrincipalLookupService()

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

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

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

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

Методы, объявленные в классе 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 — при возникновении ошибки ввода-вывода

lookupPrincipalByGroupName

public abstract GroupPrincipal lookupPrincipalByGroupName(String group) throws IOException
Поиск субъекта-группы по имени группы.

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

Параметры:
group — строковое представление группы, которую необходимо найти
Возвращает:
субъект-группа
Вызывает исключения:
UserPrincipalNotFoundException — субъект не существует или не является группой
IOException — при возникновении ошибки ввода-вывода

Сообщить об ошибке или предложить улучшение
Дополнительные сведения об API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API