IAclFileAttributeView Interface

Référence

Définition

Espace de noms:: Java.Nio.FileNio.Attributes

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Vue d’attribut de fichier qui prend en charge la lecture ou la mise à jour des attributs de propriétaire de fichier ou de listes de contrôle d’accès d’un fichier.

[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 fichier ou de listes de contrôle d’accès 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 #setAcl(List) setAcl permettant de #getAcl() getAcllire 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 : Protocolehttp://www.ietf.org/rfc/rfc3530.txt NFS (Network File System) version 4. Cette vue d’attribut de fichier est destinée aux implémentations du 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&lt;AclEntry&gt; 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 : <blockquote<>table class="striped"caption style="<>display :none"Supported attributes</caption><thead<>tr<>th scope="col »> Name </th th<>scope="col »> Type </th<>/tr/thead<>tbody<>tr<><> th scope=">row »> « acl » </th><Td>List<> </Td></tr tr><<>th scope="row »> « owner » </th><td>UserPrincipal</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 #getOwner getOwner les #getAcl getAcl 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 #setOwner setOwner les #setAcl setAcl 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 FileAttribute avec"acl:acl"FileAttribute#name nameet une liste FileAttribute#value value d’objets AclEntryFiles#createDirectory createDirectory.

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.

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

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

Propriétés

Acl	Vue d’attribut de fichier qui prend en charge la lecture ou la mise à jour des attributs de propriétaire de fichier ou de listes de contrôle d’accès d’un fichier.
Handle	Obtient la valeur JNI de l’objet Android sous-jacent. (Hérité de IJavaObject)
JniIdentityHashCode	Retourne la valeur de `java.lang.System.identityHashCode()` l’instance encapsulée. (Hérité de IJavaPeerable)
JniManagedPeerState	État de l’homologue managé. (Hérité de IJavaPeerable)
JniPeerMembers	Prise en charge de l’accès aux membres et de l’appel. (Hérité de IJavaPeerable)
Owner	Vue d’attribut de fichier qui prend en charge la lecture ou la mise à jour des attributs de propriétaire de fichier ou de listes de contrôle d’accès d’un fichier. (Hérité de IFileOwnerAttributeView)
PeerReference	Retourne une JniObjectReference instance d’objet Java encapsulée. (Hérité de IJavaPeerable)

Méthodes

Disposed()	Appelé lorsque l’instance a été supprimée. (Hérité de IJavaPeerable)
DisposeUnlessReferenced()	S’il n’existe aucune référence en suspens à cette instance, les appels `Dispose()`; sinon, ne fait rien. (Hérité de IJavaPeerable)
Finalized()	Appelé lorsque l’instance a été finalisée. (Hérité de IJavaPeerable)
Name()	Retourne le nom de la vue d’attribut.
SetJniIdentityHashCode(Int32)	Définissez la valeur retournée par `JniIdentityHashCode`. (Hérité de IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Vue d’attribut de fichier qui prend en charge la lecture ou la mise à jour des attributs de propriétaire de fichier ou de listes de contrôle d’accès d’un fichier. (Hérité de IJavaPeerable)
SetPeerReference(JniObjectReference)	Définissez la valeur retournée par `PeerReference`. (Hérité de IJavaPeerable)
UnregisterFromRuntime()	Annulez l’inscription de cette instance afin que le runtime ne le retourne pas à partir d’appels futurs Java.Interop.JniRuntime+JniValueManager.PeekValue . (Hérité de IJavaPeerable)

Méthodes d’extension

JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Vue d’attribut de fichier qui prend en charge la lecture ou la mise à jour des attributs de propriétaire de fichier ou de listes de contrôle d’accès d’un fichier.
GetJniTypeName(IJavaPeerable)	Vue d’attribut de fichier qui prend en charge la lecture ou la mise à jour des attributs de propriétaire de fichier ou de listes de contrôle d’accès d’un fichier.

S’applique à

Partager via