Класс 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- строковое представление принципала пользователя для поиска - Возвращает:
- принципал пользователя
- Исключения:
-
UserPrincipalNotFoundException- принципал не существует -
IOException- если произошла ошибка ввода-вывода -
SecurityException- В случае с поставщиком по умолчанию и установленным менеджером безопасности, он проверяетRuntimePermission("lookupUserInformation")
lookupPrincipalByGroupName
public abstract GroupPrincipal lookupPrincipalByGroupName(String group)
throws IOException
Поиск принципала группы по имени группы.
Если реализация не поддерживает понятие группы, этот метод всегда выбрасывает UserPrincipalNotFoundException. Если пространство имён для учётных записей пользователей и групп совпадает, то этот метод идентичен вызову lookupPrincipalByName.
- Параметры:
-
group- строковое представление группы для поиска - Возвращает:
- принципал группы
- Исключения:
-
UserPrincipalNotFoundException- принципал не существует или не является группой -
IOException- если произошла ошибка ввода-вывода -
SecurityException- В случае с поставщиком по умолчанию и установленным менеджером безопасности, он проверяетRuntimePermission("lookupUserInformation")
© 1993, 2020, 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.