Stay organized with collections
Save and categorize content based on your preferences.
AI-generated Key Takeaways
UserPrincipal represents an identity, typically a username or account name, used for determining access rights to file system objects.
Access rights are often managed using mechanisms like Access Control Lists (ACLs) that verify the identity of the requesting entity.
UserPrincipal objects can be retrieved via a UserPrincipalLookupService or from FileAttributeView implementations, such as AclFileAttributeView and PosixFileAttributeView.
UserPrincipal inherits methods from java.security.Principal like getName(), equals(), hashCode(), implies(), and toString() for managing and comparing principal objects.
public interface
UserPrincipal
implements
Principal
A UserPrincipal representing a group identity, used to
determine access rights to objects in a file system.
A Principal representing an identity used to determine access rights
to objects in a file system.
On many platforms and file systems an entity requires appropriate access
rights or permissions in order to access objects in a file system. The
access rights are generally performed by checking the identity of the entity.
For example, on implementations that use Access Control Lists (ACLs) to
enforce privilege separation then a file in the file system may have an
associated ACL that determines the access rights of identities specified in
the ACL.
A UserPrincipal object is an abstract representation of an
identity. It has a name that is typically the username or
account name that it represents. User principal objects may be obtained using
a UserPrincipalLookupService, or returned by FileAttributeView implementations that provide access to identity related
attributes. For example, the AclFileAttributeView and PosixFileAttributeView provide access to a file's owner.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-10 UTC."],[],["`UserPrincipal` represents an identity for determining file system access rights. It features a `name` (username/account name) and can be retrieved via `UserPrincipalLookupService` or `FileAttributeView`. It extends `Principal`, inheriting methods like `equals`, `getName`, `hashCode`, `implies`, and `toString`. Access to objects is granted based on the entity's identity, which may be checked against Access Control Lists (ACLs). `GroupPrincipal` is an indirect subclass, representing a group identity.\n"]]