UserPrincipal
Stay organized with collections
Save and categorize content based on your preferences.
Known Indirect Subclasses
GroupPrincipal |
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
.
Inherited Method Summary
From interface
java.security.Principal
abstract
boolean
|
equals( Object another)
Compares this principal to the specified object.
|
abstract
String
|
getName()
Returns the name of this principal.
|
abstract
int
|
hashCode()
Returns a hashcode for this principal.
|
boolean
|
implies( Subject subject)
Returns true if the specified subject is implied by this principal.
|
abstract
String
|
toString()
Returns a string representation of this principal.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-10 UTC.
[[["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, 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."]]],["`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"]]