模块 java.base

软件包 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()

构造方法摘要

构造方法

变量	构造器	描述
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 - 如果发生I / O错误

SecurityException - 如果是默认提供程序，并且安装了安全管理器，则会检查RuntimePermission ("lookupUserInformation")

lookupPrincipalByGroupName

public abstract GroupPrincipal lookupPrincipalByGroupName(String group)
                                                   throws IOException

按组名查找组主体。

如果实现不支持任何组概念，则此方法始终抛出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")