IAclFileAttributeView Interface

Définition

[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

Attributs

RegisterAttribute

Implémente

IJavaObject IJavaPeerable IAttributeView IFileAttributeView IFileOwnerAttributeView IDisposable

Remarques

Vue d'attribut de fichier qui prend en charge la lecture ou la mise à jour des attributs de propriétaire de fichiers ou de listes de Access Control fichiers (ACL) d'un fichier.

Les listes de contrôle d’accès sont utilisées pour spécifier les droits d’accès aux objets du système de fichiers. Une liste de contrôle d’accès est une liste ordonnée de AclEntry access-control-entries, chacune spécifiant un UserPrincipal niveau d’accès et le niveau d’accès pour ce principal d’utilisateur. Cette vue d’attribut de fichier définit les méthodes #getAcl() getAcl permettant de #setAcl(List) setAcllire et d’écrire des listes de contrôle d’accès basées sur le modèle de liste de contrôle d’accès spécifié dans RFC  ; 3530 : Protocole NFS (Network File System) version 4.http://www.ietf.org/rfc/rfc3530.txt Cette vue d’attribut de fichier est destinée aux implémentations de système de fichiers qui prennent en charge le modèle ACL NFSv4 ou qui ont un <mappage em>bien défini</em> entre le modèle ACL NFSv4 et le modèle ACL utilisé par le système de fichiers. Les détails de ce mappage dépendent de l’implémentation et ne sont donc pas spécifiés.

Cette classe s’étend également afin de définir des FileOwnerAttributeView méthodes pour obtenir et définir le propriétaire du fichier.

Lorsqu’un système de fichiers fournit l’accès à un ensemble qui FileStore file-systems ne sont pas homogènes, seuls certains systèmes de fichiers peuvent prendre en charge les listes de contrôle d’accès. La FileStore#supportsFileAttributeView supportsFileAttributeView méthode peut être utilisée pour tester si un système de fichiers prend en charge les listes de contrôle d’accès.

<Interopérabilité> h2</h2>

RFC  ; 3530 permet d’utiliser des identités utilisateur spéciales sur des plateformes qui prennent en charge les autorisations d’accès définies par POSIX. Les identités utilisateur spéciales sont « »,OWNER@ «GROUP@ » et «EVERYONE@ ». Lorsque la liste de contrôle d’accès et la AclFileAttributeViewPosixFileAttributeView liste de contrôle d’accès sont prises en charge, ces identités d’utilisateur spéciales peuvent être incluses dans la liste de contrôle d’accès AclEntry entries qui sont lues ou écrites. Le système de UserPrincipalLookupService fichiers peut être utilisé pour obtenir un UserPrincipal pour représenter ces identités spéciales en appelant la UserPrincipalLookupService#lookupPrincipalByName lookupPrincipalByName méthode.

<b>Exemple d’utilisation :</b> Supposons que nous souhaitons ajouter une entrée à une liste de contrôle d’accès existante pour accorder l’accès « 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> Accès <dynamique /h2>

Lorsque l’accès dynamique aux attributs de fichier est requis, les attributs pris en charge par cette vue d’attribut sont les suivants : blockquotetable class="striped"caption style="display :none"Supported attributes/captiontheadtrth scope="col » Name /th thscope="col » Type /th/tr/theadtbodytr th scope="row » « acl » /thtd<> /td/tr trth scope="row » « owner » /thtd/td/tr/tbody/table/blockquote

La Files#getAttribute getAttribute méthode peut être utilisée pour lire les attributs de liste de contrôle d’accès ou de propriétaire comme si vous appelez les méthodes ou #getAcl getAcl les #getOwner getOwner méthodes.

La Files#setAttribute setAttribute méthode peut être utilisée pour mettre à jour les attributs de liste de contrôle d’accès ou de propriétaire comme si vous appelez les méthodes ou #setAcl setAcl les #setOwner setOwner méthodes.

<h2> Définition de la liste de contrôle d’accès lors de la création d’un fichier </h2>

Les implémentations prenant en charge cette vue d’attribut peuvent également prendre en charge la définition de la liste de contrôle d’accès initiale lors de la création d’un fichier ou d’un répertoire. La liste de contrôle d’accès initiale peut être fournie à des méthodes telles que Files#createFile createFile ou à une Files#createDirectory createDirectory avecFileAttributeFileAttribute#name nameet une liste "acl:acl" d’objets FileAttribute#value valueAclEntry.

Lorsqu’une implémentation prend en charge un modèle ACL qui diffère du modèle ACL défini par NFSv4, puis définit la liste de contrôle d’accès initiale lors de la création du fichier doit traduire la liste de contrôle d’accès au modèle pris en charge par le système de fichiers. Les méthodes qui créent un fichier doivent rejeter (en lisant IOException IOException) toute tentative de création d’un fichier qui serait moins sécurisé suite à la traduction.

Ajouté dans la version 1.7.

Java documentation pour java.nio.file.attribute.AclFileAttributeView.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.