DirContext
DirContext (디렉토리 컨텍스트)
객체와 연관된 속성을 검사·갱신하고 디렉토리를 검색하는 메서드를 포함하는 디렉토리 서비스 인터페이스입니다.
본문
DirContext 메서드에 전달되는 각 이름은 그 컨텍스트에 상대적이며, 빈 이름은 컨텍스트 자체를 가리킵니다. 이름 매개변수는 null이 될 수 없습니다. 이름 인자의 해석 규칙은 Context에서 설명된 것과 동일하게 적용됩니다.
속성이 어떤 대상과 연관되는지에 대한 두 가지 기본 모델이 있습니다. 첫째, 속성이 DirContext 객체 자체와 직접 연관되는 모델입니다. 둘째, 속성이 DirContext의 이름(주로 원자적 이름)과 연관되는 모델입니다. JNDI는 두 모델을 모두 지원하며, 속성을 어디에 '저장'할지는 각 서비스 프로바이더가 결정합니다.
getAttributes()와 search() 메서드에서는 반환할 속성을 속성 이름 목록으로 지정할 수 있습니다. 일부 디렉토리는 속성 서브클래싱, 속성 이름 동의어, 언어 코드 같은 기능 때문에 요청한 이름과 다른 이름의 속성을 반환할 수 있습니다.
일부 디렉토리는 관리 목적으로 객체에 연관된 '운영 속성(operational attribute)' 개념을 가집니다. getAttributes()와 search()에서 반환할 속성 목록에 null을 지정하면 요청 객체와 연관된 모든 속성을 반환하지만, 이때 운영 속성은 포함되지 않으므로 명시적으로 이름을 지정해야 합니다.
이 인터페이스의 모든 메서드는 NamingException이나 그 하위 클래스를 던질 수 있습니다. 매개변수로 전달된 객체는 서비스 프로바이더에 의해 수정되지 않으며, 메서드가 반환한 객체는 호출자가 소유합니다.