Uses of Interface java.nio.file.attribute.UserPrincipal (Java Platform SE 8 )
Date: 2026-04-17

## Uses of Interface
java.nio.file.attribute.UserPrincipal

- Packages that use UserPrincipal
  Package | Description
  --- | ---
  java.nio.file | Defines interfaces and classes for the Java virtual machine to access files, file attributes, and file systems.
  java.nio.file.attribute | Interfaces and classes providing access to file and file system attributes.

- - ### Uses of UserPrincipal in java.nio.file

    Methods in java.nio.file that return UserPrincipal
    Modifier and Type | Method and Description
    --- | ---
    `static UserPrincipal` | Files.`getOwner(Path path, LinkOption... options)` Returns the owner of a file.

    Methods in java.nio.file with parameters of type UserPrincipal
    Modifier and Type | Method and Description
    --- | ---
    `static Path` | Files.`setOwner(Path path, UserPrincipal owner)` Updates the file owner.

  - ### Uses of UserPrincipal in java.nio.file.attribute

    Subinterfaces of UserPrincipal in java.nio.file.attribute
    Modifier and Type | Interface and Description
    --- | ---
    `interface` | `GroupPrincipal` A `UserPrincipal` representing a group identity, used to determine access rights to objects in a file system.

    Methods in java.nio.file.attribute that return UserPrincipal
    Modifier and Type | Method and Description
    --- | ---
    `UserPrincipal` | FileOwnerAttributeView.`getOwner()` Read the file owner.
    `abstract UserPrincipal` | UserPrincipalLookupService.`lookupPrincipalByName(String name)` Lookup a user principal by name.
    `UserPrincipal` | PosixFileAttributes.`owner()` Returns the owner of the file.
    `UserPrincipal` | AclEntry.`principal()` Returns the principal component.

    Methods in java.nio.file.attribute with parameters of type UserPrincipal
    Modifier and Type | Method and Description
    --- | ---
    `void` | FileOwnerAttributeView.`setOwner(UserPrincipal owner)` Updates the file owner.
    `AclEntry.Builder` | AclEntry.Builder.`setPrincipal(UserPrincipal who)` Sets the principal component of this builder.

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2026, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.