IAclFileAttributeView 介面

定義

[Android.Runtime.Register("java/nio/file/attribute/AclFileAttributeView", "", "Java.Nio.FileNio.Attributes.IAclFileAttributeViewInvoker", ApiSince=26)]
public interface IAclFileAttributeView : IDisposable, Java.Interop.IJavaPeerable, Java.Nio.FileNio.Attributes.IFileOwnerAttributeView

[<Android.Runtime.Register("java/nio/file/attribute/AclFileAttributeView", "", "Java.Nio.FileNio.Attributes.IAclFileAttributeViewInvoker", ApiSince=26)>]
type IAclFileAttributeView = interface
    interface IFileOwnerAttributeView
    interface IFileAttributeView
    interface IAttributeView
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable IAttributeView IFileAttributeView IFileOwnerAttributeView IDisposable

備註

一個支援讀取或更新檔案存取控制 Lists（ACL）或檔案擁有者屬性的檔案屬性檢視。

ACL 用於指定對檔案系統物件的存取權限。 ACL 是一個有序的清單 AclEntry access-control-entries，每個 ，指定一個 以及 UserPrincipal 該使用者主體的存取層級。 此檔案屬性檢視定義 #getAcl() getAcl了 ，以及 #setAcl(List) setAcl 根據 RFC  中指定的 ACL 模型來讀寫 ACL 的方法;3530：網路檔案系統（NFS）第4版協定http://www.ietf.org/rfc/rfc3530.txt。 此檔案屬性檢視適用於支援 NFSv4 ACL 模型，或在 NFSv4 ACL 模型與檔案系統所用 ACL 模型之間有 <em>明確定義</em> 映射的檔案系統實作。 此類映射的細節依實作而異，因此未明確說明。

此類別也可 FileOwnerAttributeView 擴充以定義取得及設定檔案擁有者的方法。

當檔案系統提供一組 FileStore file-systems 非同質的存取時，只有部分檔案系統能支援 ACL。 此 FileStore#supportsFileAttributeView supportsFileAttributeView 方法可用來測試檔案系統是否支援 ACL。

<h2>互通性</h2>

RFC 3530 允許在支援 POSIX 定義存取權限的平台上使用特殊的使用者身份。 特殊使用者身份為「OWNER@」、「GROUP@」和「EVERYONE@」。 當 和 都AclFileAttributeViewPosixFileAttributeView支援時，這些特殊的使用者身份可能會被包含在 ACL AclEntry entries 中，並可被讀取或寫入。 檔案系統 UserPrincipalLookupService 的檔案可用來取得 a UserPrincipal ，透過呼叫 UserPrincipalLookupService#lookupPrincipalByName lookupPrincipalByName 該方法來表示這些特殊身份。

<b>使用範例：</b> 假設我們想在現有的 ACL 中新增一個條目以授予「joe」存取權限：

// lookup "joe"
                UserPrincipal joe = file.getFileSystem().getUserPrincipalLookupService()
                    .lookupPrincipalByName("joe");

                // get view
                AclFileAttributeView view = Files.getFileAttributeView(file, AclFileAttributeView.class);

                // create ACE to give "joe" read access
                AclEntry entry = AclEntry.newBuilder()
                    .setType(AclEntryType.ALLOW)
                    .setPrincipal(joe)
                    .setPermissions(AclEntryPermission.READ_DATA, AclEntryPermission.READ_ATTRIBUTES)
                    .build();

                // read ACL, insert ACE, re-write ACL
                List<AclEntry> acl = view.getAcl();
                acl.add(0, entry);   // insert before any DENY entries
                view.setAcl(acl);

<h2> 動態存取 </h2>

當需要動態存取檔案屬性時，此屬性檢視所支援的屬性如下：blockquotetable class=“striped”caption style=“display：none” 支援屬性/caption theadtrth scope=“col” Name /thth scope=“col” 類型 /th/theadtbodytrth scope=“row” “acl” /thTD<>/結束/trtrth scope=“row” “owner” /thtd/td/tr/tbody/table/blockquote

Files#getAttribute getAttribute此方法可透過呼叫 #getAcl getAcl or #getOwner getOwner 方法來讀取 ACL 或擁有者屬性。

Files#setAttribute setAttribute此方法可用於更新 ACL 或擁有者屬性，就像呼叫 #setAcl setAcl or #setOwner setOwner 方法一樣。

<h2> 建立檔案 <時設定 ACL /h2>

支援此屬性檢視的實作，也可能支援在建立檔案或目錄時設定初始 ACL。 初始 ACL 可能提供給Files#createFile createFileFiles#createDirectory createDirectory方法，例如 或 ，FileAttribute其中 a FileAttribute#name name 是物件"acl:acl"FileAttribute#value value清單AclEntry。

若實作支援的 ACL 模型與 NFSv4 定義的 ACL 模型不同，則在建立檔案時設定初始 ACL，必須將 ACL 轉換成檔案系統支援的模型。 建立檔案的方法應拒絕（拋出 IOException IOException）任何因轉譯而安全性較低的檔案嘗試。

在 1.7 版本中加入。

Java 文件 java.nio.file.attribute.AclFileAttributeView。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。