Module java.base

Package java.nio.file.attribute

Class 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()

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	UserPrincipalLookupService()	初始化此类的新实例。

Method Summary

Modifier and Type	Method	Description
abstract GroupPrincipal	lookupPrincipalByGroupName(String group)	按组名查找组主体。
abstract UserPrincipal	lookupPrincipalByName(String name)	按名称查找用户主体。

Methods declared in class java.lang.Object

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

Constructor Details

UserPrincipalLookupService

             protected UserPrincipalLookupService()
            

初始化此类的新实例。

Method Details

lookupPrincipalByName

             public abstract UserPrincipal lookupPrincipalByName(String name) throws IOException
            

按名称查找用户主体。

参数:

name - 要查找的用户主体的字符串表示形式

返回:

一个用户主体

抛出:

UserPrincipalNotFoundException - 主体不存在

IOException - 如果发生I/O错误

SecurityException - 在默认提供程序的情况下，并且安装了安全管理器，则检查RuntimePermission("lookupUserInformation")

lookupPrincipalByGroupName

             public abstract GroupPrincipal lookupPrincipalByGroupName(String group) throws IOException
            

按组名查找组主体。

如果实现不支持任何组概念，则此方法始终会抛出UserPrincipalNotFoundException。 如果用户帐户和组的命名空间相同，则此方法与调用lookupPrincipalByName相同。

参数:

group - 要查找的组的字符串表示形式

返回:

一个组主体

抛出:

UserPrincipalNotFoundException - 主体不存在或不是组

IOException - 如果发生I/O错误

SecurityException - 在默认提供程序的情况下，并且安装了安全管理器，则检查RuntimePermission("lookupUserInformation")