Module java.base

软件包 java.nio.file.attribute

Class UserPrincipalLookupService

java.lang.Object

java.nio.file.attribute.UserPrincipalLookupService

public abstract class UserPrincipalLookupService
extends Object

按名称查找用户和组主体的对象。 A UserPrincipal表示可以用于确定对文件系统中的对象的访问权限的身份。 A GroupPrincipal表示组身份 。 A UserPrincipalLookupService定义了通过名称或组名称（通常是用户或帐户名称）查找身份的方法。 名称和组名称是否区分大小写取决于实现。 组的确切定义是实现特定的，但通常组代表为管理目的而创建的身份，以便确定组成员的访问权限。 特别地，如果名称和组的名称空间相同或不同，则具体实现。 为了确保跨平台的一致和正确的行为，建议使用这个API，就像命名空间是不同的。 换句话说， lookupPrincipalByName应该用于查找用户，而lookupPrincipalByGroupName应该用于查找组。

从以下版本开始：

1.7

另请参见：

FileSystem.getUserPrincipalLookupService()

构造方法摘要

构造方法

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

方法摘要

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

Methods inherited from class 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 - 如果发生I / O错误

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

lookupPrincipalByGroupName

public abstract GroupPrincipal lookupPrincipalByGroupName(String group)
                                                   throws IOException

按组名查找组主体。

如果一个实现不支持group的概念，那么这个方法总是会抛出UserPrincipalNotFoundException 。 在用户帐户和组的命名空间相同的地方，该方法与调用lookupPrincipalByName相同。

参数

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

结果

一个团体负责人

异常

UserPrincipalNotFoundException - 校长不存在或不是组

IOException - 如果发生I / O错误

SecurityException - In the case of the default provider, and a security manager is installed, it checks RuntimePermission ("lookupUserInformation")