Класс UserPrincipalLookupService

java.lang.Object
- java.nio.file.attribute.UserPrincipalLookupService

public abstract class UserPrincipalLookupService
extends Object

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

Since:: 1.7
См. также:: FileSystem.getUserPrincipalLookupService()

Конструкторы

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

Методы

Модификатор и тип	Метод	Описание
`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 - строковое представление принципала пользователя для поиска
Возвращает:: принципал пользователя
Исключения:: IOException - если произошла ошибка ввода-вывода; SecurityException - в случае с поставщиком по умолчанию и установленным менеджером безопасности, проверяет RuntimePermission("lookupUserInformation"); UserPrincipalNotFoundException - принципал не существует

lookupPrincipalByGroupName

public abstract GroupPrincipal lookupPrincipalByGroupName(String group)
                                                   throws IOException

Поиск принципала группы по имени группы.

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

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