Module java.base

软件包 java.nio.file.attribute

Class AclEntry

java.lang.Object

java.nio.file.attribute.AclEntry

public final class AclEntry
extends Object

访问控制列表（ACL）中的条目。

此类表示的ACL条目基于RFC 3530: Network File System (NFS) version 4 Protocol中指定的ACL模型。 每个条目有四个组件如下：

1. type组件确定条目是否准予或拒绝访问。

2. principal组件，有时称为“谁”组件，是一个UserPrincipal对应于该条目授予或拒绝访问的身份

3. permissions组件是一组permissions

4. flags组件是一组flags，用于指示条目如何继承和传播

使用关联的AclEntry.Builder对象通过调用其build方法创建ACL条目。

ACL条目是不可变的，并且可以安全地被多个并发线程使用。

从以下版本开始：

1.7

Nested Class Summary

Nested Classes

Modifier and Type	Class	描述
static class	AclEntry.Builder	一个AclEntry对象的生成器。

方法摘要

Modifier and Type	方法	描述
boolean	equals(Object ob)	将指定的对象与此ACL条目进行比较以获得相等性。
Set<AclEntryFlag>	flags()	返回flags组件的副本。
int	hashCode()	返回此ACL条目的哈希码值。
static AclEntry.Builder	newBuilder()	构建一个新的构建器。
static AclEntry.Builder	newBuilder(AclEntry entry)	使用现有ACL条目的组件构造一个新构建器。
Set<AclEntryPermission>	permissions()	返回权限组件的副本。
UserPrincipal	principal()	返回主成分。
String	toString()	返回此ACL条目的字符串表示形式。
AclEntryType	type()	返回ACL条目类型。

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

方法详细信息

newBuilder

public static AclEntry.Builder newBuilder()

构建一个新的构建器。 类型的初始值和组件是null 。 权限和标志组件的初始值为空集。

结果

一个新的建设者

newBuilder

public static AclEntry.Builder newBuilder(AclEntry entry)

使用现有ACL条目的组件构造一个新构建器。

参数

entry - 一个ACL条目

结果

一个新的建设者

type

public AclEntryType type()

返回ACL条目类型。

结果

ACL条目类型

principal

public UserPrincipal principal()

返回主成分。

结果

主要组成部分

permissions

public Set<AclEntryPermission> permissions()

返回权限组件的副本。

返回的集合是一个可修改的权限副本。

结果

权限组件

flags

public Set<AclEntryFlag> flags()

返回flags组件的副本。

返回的集合是标记的可修改副本。

结果

标志组件

equals

public boolean equals(Object ob)

将指定的对象与此ACL条目进行比较以获得相等性。

如果给定的对象不是一个AclEntry那么这个方法立即返回false 。

对于要考虑的两个ACL条目为等式，需要它们是相同的类型，它们的组件是相等的，它们的权限组件是相等的，并且它们的标志组件是相等的。

该方法满足Object.equals方法的一般合同。

重写：

equals在 Object

参数

ob - 要比较此对象的对象

结果

true如果，并且仅当给定对象是AclEntry与此AclEntry相同时

另请参见：

Object.hashCode() ， HashMap

hashCode

public int hashCode()

返回此ACL条目的哈希码值。

该方法满足Object.hashCode()方法的一般合同。

重写：

hashCode在 Object

结果

该对象的哈希码值。

另请参见：

Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

toString

public String toString()

返回此ACL条目的字符串表示形式。

重写：

toString在 Object

结果

the string representation of this entry