IPosixFileAttributeView Interface

Définition

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

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

Attributs

RegisterAttribute

Implémente

IJavaObject IJavaPeerable IAttributeView IBasicFileAttributeView IFileAttributeView IFileOwnerAttributeView IDisposable

Remarques

Vue d’attribut de fichier qui fournit une vue des attributs de fichier couramment associés aux fichiers sur les systèmes de fichiers utilisés par les systèmes d’exploitation qui implémentent la famille POSIX (Portable Operating System Interface) de normes.

Les systèmes d’exploitation qui implémentent la famille POSIX de normes utilisent généralement des systèmes de fichiers qui ont un propriétaire/em< de> fichier<>, <un>propriétaire< de groupe em/em> et <des autorisations d’accès em>< associées>. Cette vue d’attribut de fichier fournit un accès en lecture et écriture à ces attributs.

La #readAttributes() readAttributes méthode est utilisée pour lire les attributs du fichier. Le fichier PosixFileAttributes#owner() owner est représenté par une UserPrincipal identité du propriétaire du fichier à des fins de contrôle d’accès. Le PosixFileAttributes#group() group-owner, représenté par un GroupPrincipal, est l’identité du propriétaire du groupe, où un groupe est une identité créée à des fins administratives afin de déterminer les droits d’accès pour les membres du groupe.

L’attribut PosixFileAttributes#permissions() permissions est un ensemble d’autorisations d’accès. Cette vue d’attribut de fichier fournit l’accès aux neuf autorisations définies par la PosixFilePermission classe. Ces neuf bits d’autorisation déterminent l’accès <em>read</em>, <em>write</em>, et <em>execute</em> access for the file owner, group, and other (autres identités qui signifient des identités autres que le propriétaire et les membres du groupe). Certains systèmes d’exploitation et systèmes de fichiers peuvent fournir des bits d’autorisation supplémentaires, mais l’accès à ces autres bits n’est pas défini par cette classe dans cette version.

<b>Exemple d’utilisation :</b> Supposons que nous devons imprimer le propriétaire et les autorisations d’accès d’un fichier :

Path file = ...
                PosixFileAttributes attrs = Files.getFileAttributeView(file, PosixFileAttributeView.class)
                    .readAttributes();
                System.out.format("%s %s%n",
                    attrs.owner().getName(),
                    PosixFilePermissions.toString(attrs.permissions()));

<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’attributs sont définis et, en outre, les attributs suivants sont pris en charge : blockquotetable class="striped"caption style="display :none"Supported attributes/captionthead trth scope="col » Name /th thscope="col » Type /th/tr/theadtbody trth scope="row » « permissions » /thtd<> /td/tr trth scope="row » « group » /thtd/td/tr/tbody/table/blockquote

La Files#getAttribute getAttribute méthode peut être utilisée pour lire l’un de ces attributs, ou l’un des attributs définis par BasicFileAttributeView le cas échéant en appelant la #readAttributes readAttributes() méthode.

La Files#setAttribute setAttribute méthode peut être utilisée pour mettre à jour l’heure de la dernière modification du fichier, l’heure de dernier accès ou créer des attributs d’heure tels que définis par BasicFileAttributeView. Il peut également être utilisé pour mettre à jour les autorisations, le propriétaire ou le propriétaire de groupe comme si, respectivement, appelez les méthodes, #setPermissions setPermissionset #setOwner setOwner les #setGroup setGroupméthodes.

<h2> Définition des autorisations initiales </h2>

Les implémentations prenant en charge cette vue d’attribut peuvent également prendre en charge la définition des autorisations initiales lors de la création d’un fichier ou d’un répertoire. Les autorisations initiales sont fournies aux Files#createFile createFile méthodes en Files#createDirectory createDirectory tant qu’avecFileAttributeFileAttribute#name name"posix:permissions"et à un FileAttribute#value value ensemble d’autorisations. L’exemple suivant utilise la PosixFilePermissions#asFileAttribute asFileAttribute méthode pour construire un FileAttribute fichier lors de la création d’un fichier :

Path path = ...
                Set<PosixFilePermission> perms =
                    EnumSet.of(OWNER_READ, OWNER_WRITE, OWNER_EXECUTE, GROUP_READ);
                Files.createFile(path, PosixFilePermissions.asFileAttribute(perms));

Lorsque les autorisations d’accès sont définies au moment de la création de fichier, la valeur réelle des autorisations peut différer selon la valeur de l’objet d’attribut. Les raisons de cette opération sont spécifiques à l’implémentation. Sur les systèmes UNIX, par exemple, un processus a un <em umask>/em< qui a un impact sur les bits d’autorisation des fichiers>nouvellement créés. Lorsqu’une implémentation prend en charge le paramètre des autorisations d’accès et que le système de fichiers sous-jacent prend en charge les autorisations d’accès, il est nécessaire que la valeur des autorisations d’accès réelles soit égale ou inférieure à la valeur de l’attribut fourni aux méthodes ou Files#createFile createFile aux Files#createDirectory createDirectory méthodes. En d’autres termes, le fichier peut être plus sécurisé que demandé.

Ajouté dans la version 1.7.

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

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.