UserPrincipalLookupService — 이름으로 사용자·그룹 principal을 조회하는 객체

UserPrincipalLookupService — 이름으로 사용자·그룹 principal을 조회하는 객체

UserPrincipalLookupService는 이름으로 사용자 및 그룹 principal을 조회하는 객체예요. UserPrincipal은 파일 시스템의 객체에 대한 접근 권한을 결정하는 데 사용될 수 있는 정체성을 나타내고, GroupPrincipal은 그룹 정체성을 나타내요.

출처: Java API Reference

본문

public abstract class UserPrincipalLookupService extends Object

이름으로 사용자 및 그룹 principal을 조회하는 객체예요. UserPrincipal은 파일 시스템의 객체에 대한 접근 권한을 결정하는 데 사용될 수 있는 정체성을 나타내고, GroupPrincipal은 그룹 정체성을 나타내요. UserPrincipalLookupService는 이름 또는 그룹 이름(보통 사용자 이름이나 계정 이름)으로 정체성을 조회하는 메서드를 정의해요. 이름과 그룹 이름이 대소문자를 구분하는지 여부는 구현에 따라 달라요.

그룹의 정확한 정의는 구현별로 다르지만, 일반적으로 그룹의 구성원에 대한 접근 권한을 결정하기 위해 관리 목적으로 만들어진 정체성을 나타내요. 특히 이름과 그룹의 네임스페이스가 같은지 다른지는 구현별로 다르지만, 플랫폼 전반에 걸쳐 일관되고 올바른 동작을 보장하려면 네임스페이스가 다르다고 가정하고 이 API를 사용하는 것을 권장해요. 즉 lookupPrincipalByName은 사용자 조회에, lookupPrincipalByGroupName은 그룹 조회에 사용해야 해요. Java 1.7부터 사용할 수 있어요.

참고: FileSystem.getUserPrincipalLookupService()

생성자

protected UserPrincipalLookupService()

이 클래스의 새 인스턴스를 초기화해요.

메서드 요약

lookupPrincipalByName

public abstract UserPrincipal lookupPrincipalByName(String name) throws IOException

이름으로 사용자 principal을 조회해요.

매개변수: name — 조회할 사용자 principal의 문자열 표현

예외: UserPrincipalNotFoundException — principal이 존재하지 않을 때, IOException — I/O 오류 발생 시, SecurityException — 기본 프로바이더의 경우 보안 관리자가 설치되어 RuntimePermission("lookupUserInformation")을 검사할 때

lookupPrincipalByGroupName

public abstract GroupPrincipal lookupPrincipalByGroupName(String group) throws IOException

그룹 이름으로 그룹 principal을 조회해요. 구현이 그룹 개념을 전혀 지원하지 않는 경우 이 메서드는 항상 UserPrincipalNotFoundException을 던져요. 사용자 계정과 그룹의 네임스페이스가 같은 경우, 이 메서드는 lookupPrincipalByName을 호출하는 것과 동일해요.

예외: UserPrincipalNotFoundException — principal이 존재하지 않거나 그룹이 아닐 때, IOException — I/O 오류 발생 시, SecurityException — 기본 프로바이더의 경우 보안 관리자가 설치되어 RuntimePermission("lookupUserInformation")을 검사할 때

더 알아보기 (Learn more)

Java 공식 API