GroupPrincipal
Stay organized with collections
Save and categorize content based on your preferences.
A UserPrincipal
representing a group identity, used to
determine access rights to objects in a file system. The exact definition of
a group is implementation specific, but typically, it represents an identity
created for administrative purposes so as to determine the access rights for
the members of the group. Whether an entity can be a member of multiple
groups, and whether groups can be nested, are implementation specified and
therefore not specified.
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."],[[["\u003cp\u003e\u003ccode\u003eGroupPrincipal\u003c/code\u003e represents a group identity used for determining file system object access rights.\u003c/p\u003e\n"],["\u003cp\u003eGroup definitions are implementation-specific, but they typically manage access rights for group members.\u003c/p\u003e\n"],["\u003cp\u003eThe ability for an entity to belong to multiple groups or for groups to be nested is not universally defined.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eGroupPrincipal\u003c/code\u003e inherits methods for comparison, name retrieval, hash code generation, and string representation from the \u003ccode\u003ePrincipal\u003c/code\u003e interface.\u003c/p\u003e\n"]]],["`GroupPrincipal` represents a group identity for determining file system access rights. It extends `UserPrincipal`. Implementations define group specifics, including multiple group membership and nesting. Key actions include comparing principals with `equals()`, retrieving a principal's name with `getName()`, and generating a hash code with `hashCode()`. The `implies()` method determines if a `Subject` is implied. `lookupPrincipalByGroupName()` finds a principal by group name, and `toString()` gets the principal's string representation.\n"],null,["# GroupPrincipal\n\npublic interface **GroupPrincipal** implements [UserPrincipal](../../../../../reference/java/nio/file/attribute/UserPrincipal.html) \nA `UserPrincipal` representing a *group identity*, used to\ndetermine access rights to objects in a file system. The exact definition of\na group is implementation specific, but typically, it represents an identity\ncreated for administrative purposes so as to determine the access rights for\nthe members of the group. Whether an entity can be a member of multiple\ngroups, and whether groups can be nested, are implementation specified and\ntherefore not specified. \n\n##### See Also\n\n- [UserPrincipalLookupService.lookupPrincipalByGroupName(String)](../../../../../reference/java/nio/file/attribute/UserPrincipalLookupService.html#lookupPrincipalByGroupName(java.lang.String)) \n\n### Inherited Method Summary\n\nFrom interface [java.security.Principal](../../../../../reference/java/security/Principal.html) \n\n|-------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| abstract boolean | [equals](../../../../../reference/java/security/Principal.html#equals(java.lang.Object))([Object](../../../../../reference/java/lang/Object.html) another) Compares this principal to the specified object. |\n| abstract [String](../../../../../reference/java/lang/String.html) | [getName](../../../../../reference/java/security/Principal.html#getName())() Returns the name of this principal. |\n| abstract int | [hashCode](../../../../../reference/java/security/Principal.html#hashCode())() Returns a hashcode for this principal. |\n| boolean | [implies](../../../../../reference/java/security/Principal.html#implies(javax.security.auth.Subject))([Subject](../../../../../reference/javax/security/auth/Subject.html) subject) Returns true if the specified subject is implied by this principal. |\n| abstract [String](../../../../../reference/java/lang/String.html) | [toString](../../../../../reference/java/security/Principal.html#toString())() Returns a string representation of this principal. |"]]