Spec-Zone.ru › OpenJDK 27

Класс 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
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Показывает, равен ли этот объект какому-либо другому объекту.
protected void finalize()
Устарело, планируется удаление: этот элемент API может быть удален в будущей версии.
Финализация устарела и может быть удалена в одном из следующих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

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, 2026, 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.

Spec-Zone.ru

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