模块 java.base

包 java.nio.file.attribute

类 UserPrincipalLookupService

java.lang.Object

java.nio.file.attribute.UserPrincipalLookupService

public abstract class UserPrincipalLookupService extends Object 
      

按名称查找用户和组主体的对象。 UserPrincipal 表示可用于确定对文件系统中对象的访问权限的身份。一个 GroupPrincipal 代表一个 group identity 。 UserPrincipalLookupService 定义了按名称或组名（通常是用户名或帐户名）查找身份的方法。名称和组名是否区分大小写取决于实现。组的确切定义是特定于实现的，但通常组表示为管理目的而创建的身份，以确定组成员的访问权限。特别是，如果名称和组的 namespace 相同或不同，则它是特定于实现的。为确保跨平台的行为一致且正确，建议使用此 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 - 在默认提供程序的情况下，安装了安全管理器，它检查 RuntimePermission ("lookupUserInformation")