- java.lang.Object
-
- java.nio.file.attribute.UserPrincipalLookupService
-
public abstract class UserPrincipalLookupService extends Object
An object to lookup user and group principals by name. AUserPrincipal
represents an identity that may be used to determine access rights to objects in a file system. AGroupPrincipal
represents a group identity. AUserPrincipalLookupService
defines methods to lookup identities by name or group name (which are typically user or account names). Whether names and group names are case sensitive or not depends on the implementation. The exact definition of a group is implementation specific but typically a group represents an identity created for administrative purposes so as to determine the access rights for the members of the group. In particular it is implementation specific if the namespace for names and groups is the same or is distinct. To ensure consistent and correct behavior across platforms it is recommended that this API be used as if the namespaces are distinct. In other words, thelookupPrincipalByName
should be used to lookup users, andlookupPrincipalByGroupName
should be used to lookup groups.- Since:
- 1.7
- See Also:
FileSystem.getUserPrincipalLookupService()
-
-
Constructor Summary
Constructors Modifier Constructor and Description protected
UserPrincipalLookupService()
Initializes a new instance of this class.
-
Method Summary
Methods Modifier and Type Method and Description abstract GroupPrincipal
lookupPrincipalByGroupName(String group)
Lookup a group principal by group name.abstract UserPrincipal
lookupPrincipalByName(String name)
Lookup a user principal by name.
-
-
-
Constructor Detail
-
UserPrincipalLookupService
protected UserPrincipalLookupService()
Initializes a new instance of this class.
-
-
Method Detail
-
lookupPrincipalByName
public abstract UserPrincipal lookupPrincipalByName(String name) throws IOException
Lookup a user principal by name.- Parameters:
name
- the string representation of the user principal to lookup- Returns:
- a user principal
- Throws:
UserPrincipalNotFoundException
- the principal does not existIOException
- if an I/O error occursSecurityException
- In the case of the default provider, and a security manager is installed, it checksRuntimePermission
("lookupUserInformation")
-
lookupPrincipalByGroupName
public abstract GroupPrincipal lookupPrincipalByGroupName(String group) throws IOException
Lookup a group principal by group name.Where an implementation does not support any notion of group then this method always throws
UserPrincipalNotFoundException
. Where the namespace for user accounts and groups is the same, then this method is identical to invokinglookupPrincipalByName
.- Parameters:
group
- the string representation of the group to lookup- Returns:
- a group principal
- Throws:
UserPrincipalNotFoundException
- the principal does not exist or is not a groupIOException
- if an I/O error occursSecurityException
- In the case of the default provider, and a security manager is installed, it checksRuntimePermission
("lookupUserInformation")
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-java/nio/file/attribute/userprincipallookupservice.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.