javax.naming.directory
클래스 InitialDirContext

java.lang.Object 
  javax.naming.InitialContext 
      javax.naming.directory.InitialDirContext

모든 구현된 인터페이스:

Context, DirContext

알려진 직계 서브 클래스:

InitialLdapContext

public class InitialDirContext
extends InitialContext 
implements DirContext 

이 클래스는 디렉토리 조작을 실행하기 위한 개시 컨텍스트 입니다. InitialContext 클래스에 대한 기술 (동기 컨텍스트를 포함한다)이 적용됩니다.

도입된 버전 :

1.3

관련 항목:

InitialContext

필드 개요

클래스 javax.naming. InitialContext 로부터 상속된 필드

defaultInitCtx, gotDefault, myProps

인터페이스 javax.naming.directory. DirContext 로부터 상속된 필드

ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE

인터페이스 javax.naming. Context 로부터 상속된 필드

APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES

생성자 개요

	InitialDirContext () 초기 DirContext를 구축합니다.
protected	InitialDirContext (boolean lazy) 초기화하지 않는다고 하는 옵션을 가지는 초기 DirContext를 구축합니다.
	InitialDirContext (Hashtable <?,?> environment) 지정한 환경을 사용해 초기 DirContext를 구축합니다.

메서드 개요

void	bind (Name name, Object obj, Attributes attrs) 관련된 속성과 함께, 이름을 객체에 바인드 합니다.
void	bind (String name, Object obj, Attributes attrs) 관련된 속성과 함께, 이름을 객체에 바인드 합니다.
DirContext	createSubcontext (Name name, Attributes attrs) 관련된 속성과 함께, 새로운 컨텍스트를 작성해 바인드 합니다.
DirContext	createSubcontext (String name, Attributes attrs) 관련된 속성과 함께, 이름을 객체에 바인드 합니다.
Attributes	getAttributes (Name name) 지정된 객체에 관련된 속성을 모두 취득합니다.
Attributes	getAttributes (Name name, String [] attrIds) 지정된 객체에 관련된 속성으로 선택된 것을 취득합니다.
Attributes	getAttributes (String name) 이름 첨부 객체에 관련된 속성을 모두 취득합니다.
Attributes	getAttributes (String name, String [] attrIds) 이름 첨부 객체에 관련된 속성으로 선택된 것을 취득합니다.
DirContext	getSchema (Name name) 지정된 객체에 관련된 schema를 취득합니다.
DirContext	getSchema (String name) 이름 첨부 객체에 관련한 schema를 취득합니다.
DirContext	getSchemaClassDefinition (Name name) 지정된 객체의 클래스 정의의 schema 객체를 포함한 컨텍스트를 취득합니다.
DirContext	getSchemaClassDefinition (String name) 이름 첨부 객체의 클래스 정의의 schema 객체를 포함한 컨텍스트를 취득합니다.
void	modifyAttributes (Name name, int mod_op, Attributes attrs) 지정된 객체에 관련된 속성을 변경합니다.
void	modifyAttributes (Name name, ModificationItem [] mods) 변경순서 지정 리스트를 사용해, 지정된 객체에 관련된 속성을 변경합니다.
void	modifyAttributes (String name, int mod_op, Attributes attrs) 이름 첨부 객체에 관련된 속성을 변경합니다.
void	modifyAttributes (String name, ModificationItem [] mods) 정렬 된 변경 리스트를 사용해, 지정된 객체에 관련된 속성을 변경합니다.
void	rebind (Name name, Object obj, Attributes attrs) 관련된 속성과 함께 이름을 객체에 바인드 해, 기존의 바인딩을 오버라이드(override) 합니다.
void	rebind (String name, Object obj, Attributes attrs) 관련된 속성과 함께 이름을 객체에 바인드 해, 기존의 바인딩을 오버라이드(override) 합니다.
NamingEnumeration <SearchResult >	search (Name name, Attributes matchingAttributes) 지정된 속성세트를 포함한 객체를 단일 컨텍스트 으로 검색합니다.
NamingEnumeration <SearchResult >	search (Name name, Attributes matchingAttributes, String [] attributesToReturn) 지정된 속성세트를 포함한 객체를 단일 컨텍스트 으로 검색해, 선택한 속성을 취득합니다.
NamingEnumeration <SearchResult >	search (Name name, String filterExpr, Object [] filterArgs, SearchControls cons) 이름 첨부 컨텍스트 또는 지정된 객체로 지정된 검색 필터를 채우는 엔트리를 검색합니다.
NamingEnumeration <SearchResult >	search (Name name, String filter, SearchControls cons) 이름 첨부 컨텍스트 또는 지정된 객체로 지정된 검색 필터를 채우는 엔트리를 검색합니다.
NamingEnumeration <SearchResult >	search (String name, Attributes matchingAttributes) 지정된 속성세트를 포함한 객체를 단일 컨텍스트 으로 검색합니다.
NamingEnumeration <SearchResult >	search (String name, Attributes matchingAttributes, String [] attributesToReturn) 지정된 속성세트를 포함한 객체를 단일 컨텍스트 으로 검색해, 선택한 속성을 취득합니다.
NamingEnumeration <SearchResult >	search (String name, String filterExpr, Object [] filterArgs, SearchControls cons) 이름 첨부 컨텍스트 또는 이름 첨부 객체로 지정된 검색 필터를 채우는 엔트리를 검색합니다.
NamingEnumeration <SearchResult >	search (String name, String filter, SearchControls cons) 이름 첨부 컨텍스트 또는 이름 첨부 객체로 지정된 검색 필터를 채우는 엔트리를 검색합니다.

클래스 javax.naming. InitialContext 로부터 상속된 메서드

addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, getDefaultInitCtx, getEnvironment, getNameInNamespace, getNameParser, getNameParser, getURLOrDefaultInitCtx, getURLOrDefaultInitCtx, init, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

인터페이스 javax.naming. Context 로부터 상속된 메서드

addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, getEnvironment, getNameInNamespace, getNameParser, getNameParser, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind

생성자 상세

InitialDirContext

protected InitialDirContext(boolean lazy)
                     throws NamingException 

초기화하지 않는다고 하는 옵션을 가지는 초기 DirContext를 구축합니다. 이것은, InitialDirContext 생성자가 불려 갔을 때에 환경 파라미터의 값이 불명한 경우에 서브 클래스의 생성자에 의해 사용됩니다. 서브 클래스의 생성자는 이 생성자를 호출해, 환경의 값을 계산해, 값을 돌려주기 전에 init()를 호출합니다.

파라미터:

lazy - true는 초기 DirContext가 초기화되지 않는 것을 나타낸다. false는 new InitialDirContext()를 호출하는 것과 같다

예외:

NamingException - 네이밍 예외가 발생했을 경우

도입된 버전 :

1.3

관련 항목:

InitialContext.init(Hashtable)

InitialDirContext

public InitialDirContext()
                  throws NamingException 

초기 DirContext를 구축합니다. 환경 프로퍼티는 지정되지 않습니다. new InitialDirContext(null)와 같습니다.

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

InitialDirContext(Hashtable)

InitialDirContext

public InitialDirContext(Hashtable <?,?> environment)
                  throws NamingException 

지정한 환경을 사용해 초기 DirContext를 구축합니다. 환경 프로퍼티에 대해서는 javax.naming.InitialContext 클래스의 기술 안에서 설명되고 있습니다.

이 생성자에서는 environment 변경 또는 참조의 보존은 행해지지 않습니다만, 복제가 보존됩니다.

파라미터:

environment - 초기 DirContext 작성에 사용되는 환경. null은 비어있는 환경을 나타낸다

예외:

NamingException - 네이밍 예외가 발생했을 경우

메서드의 상세

getAttributes

public Attributes  getAttributes(String  name)
                         throws NamingException 

인터페이스 DirContext 기술:

이름 첨부 객체에 관련된 속성을 모두 취득합니다. 자세한 내용은 DirContext.getAttributes(Name)를 참조하십시오.

정의:

인터페이스 DirContext 내의 getAttributes

파라미터:

name - 속성의 취득원의 객체의 이름

반환값:

name에 관련된 속성세트

예외:

NamingException - 네이밍 예외가 발생했을 경우

getAttributes

public Attributes  getAttributes(String  name,
                                String [] attrIds)
                         throws NamingException 

인터페이스 DirContext 기술:

이름 첨부 객체에 관련된 속성으로 선택된 것을 취득합니다. 자세한 내용은 DirContext.getAttributes(Name, String[])를 참조하십시오.

정의:

인터페이스 DirContext 내의 getAttributes

파라미터:

name - 속성의 취득원의 객체의 이름

attrIds - 얻는 속성의 식별자. null은 모든 속성이 취득되는 것을 나타낸다. 비어있는 배열은 아무것도 취득되지 않는 것을 나타낸다

반환값:

요구된 속성. null은 불가

예외:

NamingException - 네이밍 예외가 발생했을 경우

getAttributes

public Attributes  getAttributes(Name  name)
                         throws NamingException 

인터페이스 DirContext 기술:

지정된 객체에 관련된 속성을 모두 취득합니다. 속성 모델, 속성형명 및 조작 속성에 대해서는 클래스의 설명을 참조하십시오.

정의:

인터페이스 DirContext 내의 getAttributes

파라미터:

name - 속성의 취득원의 객체의 이름

반환값:

name에 관련된 속성세트. 이름에 속성이 없는 경우, 비어있는 속성 세트를 돌려주고, null이 될 것은 없다

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

DirContext.getAttributes(String), DirContext.getAttributes(Name, String[])

getAttributes

public Attributes  getAttributes(Name  name,
                                String [] attrIds)
                         throws NamingException 

인터페이스 DirContext 기술:

지정된 객체에 관련된 속성으로 선택된 것을 취득합니다. 속성 모델, 속성형명 및 조작 속성에 대해서는 클래스의 설명을 참조하십시오.

지정된 속성을 객체가 가지고 있지 않은 경우, 디렉토리는 존재하지 않는 속성을 무시해, 객체가 가지고 있는 요구된 속성을 리턴합니다.

디렉토리는 요구된 이상의 수의 속성을 돌려주는 일이 있습니다 (클래스의 설명의 「속성형명」참조)가 무관계한 임의의 속성을 돌려줄 것은 없습니다.

클래스의 설명의 「조작 속성」도 참조하십시오.

정의:

인터페이스 DirContext 내의 getAttributes

파라미터:

name - 속성의 취득원의 객체의 이름

attrIds - 얻는 속성의 식별자. null은 모든 속성이 취득되는 것을 나타낸다. 비어있는 배열은 아무것도 취득되지 않는 것을 나타낸다

반환값:

요구된 속성. null은 불가

예외:

NamingException - 네이밍 예외가 발생했을 경우

modifyAttributes

public void modifyAttributes(String  name,
                             int mod_op,
                             Attributes  attrs)
                      throws NamingException 

인터페이스 DirContext 기술:

이름 첨부 객체에 관련된 속성을 변경합니다. 자세한 내용은 DirContext.modifyAttributes(Name, int, Attributes)를 참조하십시오.

정의:

인터페이스 DirContext 내의 modifyAttributes

파라미터:

name - 속성이 변경되는 객체의 이름

mod_op - 변경 조작, ADD_ATTRIBUTE, REPLACE_ATTRIBUTE, REMOVE_ATTRIBUTE 어느쪽이든

attrs - 변경에 사용되는 속성. null은 불가

예외:

AttributeModificationException - 변경을 완료할 수 없는 경우

NamingException - 네이밍 예외가 발생했을 경우

modifyAttributes

public void modifyAttributes(Name  name,
                             int mod_op,
                             Attributes  attrs)
                      throws NamingException 

인터페이스 DirContext 기술:

지정된 객체에 관련된 속성을 변경합니다. 변경의 순서는 지정되지 않습니다. 가능한 경우, 변경은 기본적으로 행해집니다.

정의:

인터페이스 DirContext 내의 modifyAttributes

파라미터:

name - 속성이 변경되는 객체의 이름

mod_op - 변경 조작, ADD_ATTRIBUTE, REPLACE_ATTRIBUTE, REMOVE_ATTRIBUTE 어느쪽이든

attrs - 변경에 사용되는 속성. null은 불가

예외:

AttributeModificationException - 변경을 완료할 수 없는 경우

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

DirContext.modifyAttributes(Name, ModificationItem[])

modifyAttributes

public void modifyAttributes(String  name,
                             ModificationItem [] mods)
                      throws NamingException 

인터페이스 DirContext 기술:

정렬 된 변경 리스트를 사용해, 지정된 객체에 관련된 속성을 변경합니다. 자세한 내용은 DirContext.modifyAttributes(Name, ModificationItem[])를 참조하십시오.

정의:

인터페이스 DirContext 내의 modifyAttributes

파라미터:

name - 속성이 변경되는 객체의 이름

mods - 실행되는 변경의 순서. null은 불가

예외:

AttributeModificationException - 변경을 완료할 수 없는 경우

NamingException - 네이밍 예외가 발생했을 경우

modifyAttributes

public void modifyAttributes(Name  name,
                             ModificationItem [] mods)
                      throws NamingException 

인터페이스 DirContext 기술:

변경순서 지정 리스트를 사용해, 지정된 객체에 관련된 속성을 변경합니다. 변경은 지정된 순서로 행해집니다. 각 변경은 변경 조작 코드 및 조작하는 속성을 지정합니다. 가능한 경우, 변경은 기본적으로 행해집니다.

정의:

인터페이스 DirContext 내의 modifyAttributes

파라미터:

name - 속성이 변경되는 객체의 이름

mods - 실행되는 변경의 순서. null은 불가

예외:

AttributeModificationException - 변경을 완료할 수 없는 경우

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

DirContext.modifyAttributes(Name, int, Attributes), ModificationItem

bind

public void bind(String  name,
                 Object  obj,
                 Attributes  attrs)
          throws NamingException 

인터페이스 DirContext 기술:

관련된 속성과 함께, 이름을 객체에 바인드 합니다. 자세한 내용은 DirContext.bind(Name, Object, Attributes)를 참조하십시오.

정의:

인터페이스 DirContext 내의 bind

파라미터:

name - 비어있지 않은 바인드 되는 이름

obj - null 가능성이 있는 바인드 되는 객체

attrs - 바인딩에 관련짓는 객체

예외:

NameAlreadyBoundException - 이름이 이미 바인드 되고 있는 경우

InvalidAttributesException - 바인딩에 「필수」의 속성이 제공되어 있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

bind

public void bind(Name  name,
                 Object  obj,
                 Attributes  attrs)
          throws NamingException 

인터페이스 DirContext 기술:

관련된 속성과 함께, 이름을 객체에 바인드 합니다. attrs가 null인 경우, obj가 DirContext 이면, 바인딩은 obj에 관련된 속성을 가져, 그 외의 경우는 속성이 없습니다. attrs가 null 이외의 경우, 바인딩은 속성으로서 attrs를 가져, obj에 관련된 속성은 모두 무시됩니다.

정의:

인터페이스 DirContext 내의 bind

파라미터:

name - 비어있지 않은 바인드 되는 이름

obj - null 가능성이 있는 바인드 되는 객체

attrs - 바인딩에 관련짓는 객체

예외:

NameAlreadyBoundException - 이름이 이미 바인드 되고 있는 경우

InvalidAttributesException - 바인딩에 「필수」의 속성이 제공되어 있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.bind(Name, Object), DirContext.rebind(Name, Object, Attributes)

rebind

public void rebind(String  name,
                   Object  obj,
                   Attributes  attrs)
            throws NamingException 

인터페이스 DirContext 기술:

관련된 속성과 함께 이름을 객체에 바인드 해, 기존의 바인딩을 오버라이드(override) 합니다. 자세한 내용은 DirContext.rebind(Name, Object, Attributes)를 참조하십시오.

정의:

인터페이스 DirContext 내의 rebind

파라미터:

name - 비어있지 않은 바인드 되는 이름

obj - null 가능성이 있는 바인드 되는 객체

attrs - 바인딩에 관련짓는 객체

예외:

InvalidAttributesException - 바인딩에 「필수」의 속성이 제공되어 있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

rebind

public void rebind(Name  name,
                   Object  obj,
                   Attributes  attrs)
            throws NamingException 

인터페이스 DirContext 기술:

관련된 속성과 함께 이름을 객체에 바인드 해, 기존의 바인딩을 오버라이드(override) 합니다. attrs가 null 로 obj가 DirContext인 경우, obj 속성이 사용됩니다. attrs가 null 로 obj가 DirContext가 아닌 경우, 디렉토리에서 이미 바인드 되고 있는 객체에 관련된 기존의 속성이 변경되지 않은 채 남습니다. attrs가 null 이외의 경우, 디렉토리에서 이미 바인드 되고 있는 객체에 관련된 기존의 속성은 삭제되어attrs가 지정된 객체에 관련지을 수 있습니다. obj가 DirContext로 attrs가 null 이외의 경우, obj 속성은 무시됩니다.

정의:

인터페이스 DirContext 내의 rebind

파라미터:

name - 비어있지 않은 바인드 되는 이름

obj - null 가능성이 있는 바인드 되는 객체

attrs - 바인딩에 관련짓는 객체

예외:

InvalidAttributesException - 바인딩에 「필수」의 속성이 제공되어 있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.bind(Name, Object), DirContext.bind(Name, Object, Attributes)

createSubcontext

public DirContext  createSubcontext(String  name,
                                   Attributes  attrs)
                            throws NamingException 

인터페이스 DirContext 기술:

관련된 속성과 함께, 이름을 객체에 바인드 합니다. 자세한 내용은 DirContext.createSubcontext(Name, Attributes)를 참조하십시오.

정의:

인터페이스 DirContext 내의 createSubcontext

파라미터:

name - 비어있지 않은 작성되는 컨텍스트 의 이름

attrs - 새롭게 작성된 컨텍스트에 관련짓는 객체

반환값:

새롭게 작성된 컨텍스트

예외:

NameAlreadyBoundException - 이름이 이미 바인드 되고 있는 경우

InvalidAttributesException - 작성에 필요한 필수 속성 attrs가 일부 밖에 포함되지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

createSubcontext

public DirContext  createSubcontext(Name  name,
                                   Attributes  attrs)
                            throws NamingException 

인터페이스 DirContext 기술:

관련된 속성과 함께, 새로운 컨텍스트를 작성해 바인드 합니다. 이 메서드는 지정한 이름으로 새로운 서브 컨텍스트를 작성해, 그 서브 컨텍스트를 (이름의 말단에 있는 것을 제외하는 모든 불가분의 성분) 타겟 컨텍스트 으로 바인드 해, 제공된 속성을 새롭게 작성된 객체에 관련짓습니다. 모든 중간 컨텍스트 및 타겟 컨텍스트이 이미 존재하고 있을 필요가 있습니다. attrs가 null인 경우, 이 메서드는 Context.createSubcontext()와 동등합니다.

정의:

인터페이스 DirContext 내의 createSubcontext

파라미터:

name - 비어있지 않은 작성되는 컨텍스트 의 이름

attrs - 새롭게 작성된 컨텍스트에 관련짓는 객체

반환값:

새롭게 작성된 컨텍스트

예외:

NameAlreadyBoundException - 이름이 이미 바인드 되고 있는 경우

InvalidAttributesException - 작성에 필요한 필수 속성 attrs가 일부 밖에 포함되지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

Context.createSubcontext(Name)

getSchema

public DirContext  getSchema(String  name)
                     throws NamingException 

인터페이스 DirContext 기술:

이름 첨부 객체에 관련한 schema를 취득합니다. 자세한 내용은 DirContext.getSchema(Name)를 참조하십시오.

정의:

인터페이스 DirContext 내의 getSchema

파라미터:

name - schema의 취득원객체의 이름

반환값:

컨텍스트에 관련된 schema. null은 불가

예외:

OperationNotSupportedException - schema가 지원 되어 있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

getSchema

public DirContext  getSchema(Name  name)
                     throws NamingException 

인터페이스 DirContext 기술:

지정된 객체에 관련된 schema를 취득합니다. schema는 이름 공간의 구조와 그 중에 보존된 속성에 관한 규칙을 설명합니다. schema는 디렉토리에 추가할 수 있는 객체의 형태와 그 객체를 추가하는 장소, 객체를 가질 수 있는 필수 속성과 임의의 속성을 지정합니다. schema의 지원 범위는 디렉토리에 고유합니다.

이 메서드는 지정된 객체에 적용할 수 있는 schema 정보 트리의 루트를 리턴합니다. 지정된 객체 (또는 디렉토리 전체)의 몇개인가가 같은 schema를 공유하는 경우가 있습니다.

schema 트리의 구조와 내용, schema 트리의 내용의 변경 허가 이러한 변경의 디렉토리에의 영향등의 문제는 기본이 되는 디렉토리에 의해 다릅니다.

정의:

인터페이스 DirContext 내의 getSchema

파라미터:

name - schema의 취득원객체의 이름

반환값:

컨텍스트에 관련된 schema. null은 불가

예외:

OperationNotSupportedException - schema가 지원 되어 있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

getSchemaClassDefinition

public DirContext  getSchemaClassDefinition(String  name)
                                    throws NamingException 

인터페이스 DirContext 기술:

이름 첨부 객체의 클래스 정의의 schema 객체를 포함한 컨텍스트를 취득합니다. 자세한 내용은 DirContext.getSchemaClassDefinition(Name)를 참조하십시오.

정의:

인터페이스 DirContext 내의 getSchemaClassDefinition

파라미터:

name - 객체 클래스 정의의 취득원객체의 이름

반환값:

지정된 객체의 클래스 정의를 포함한 DirContext. null은 불가

예외:

OperationNotSupportedException - schema가 지원 되어 있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

getSchemaClassDefinition

public DirContext  getSchemaClassDefinition(Name  name)
                                    throws NamingException 

인터페이스 DirContext 기술:

지정된 객체의 클래스 정의의 schema 객체를 포함한 컨텍스트를 취득합니다.

디렉토리 schema의 정보 카테고리의 1개에 「클래스 정의」가 있습니다. 「객체 클래스」의 정의는 객체의 「형태」 및 그 객체가 가질 필요가 있는 속성과 가질 수 있는 속성 (필수와 임의)을 지정합니다. 여기서 말하는 「객체 클래스」는 Java 적인 미가 아니고, 디렉토리적인 미로 사용되고 있습니다. 예를 들어 지정된 객체가 「Person」클래스의 디렉토리 객체인 경우, getSchemaClassDefinition()는 「Person」의 (디렉토리의) 객체 클래스 정의를 나타내는 DirContext를 리턴합니다.

객체 클래스 정의로부터 취득할 수 있는 정보는 디렉토리 존입니다.

JNDI 1.2 보다 전은 이 메서드는 지정된 객체의 클래스 정의를 나타내는 단일의 schema 객체를 돌려주고 있었습니다. JNDI 1.2 로부터는 이 메서드는 지정된 객체의 클래스 정의를 모두 포함한 DirContext를 리턴합니다.

정의:

인터페이스 DirContext 내의 getSchemaClassDefinition

파라미터:

name - 객체 클래스 정의의 취득원객체의 이름

반환값:

지정된 객체의 클래스 정의를 포함한 DirContext. null은 불가

예외:

OperationNotSupportedException - schema가 지원 되어 있지 않은 경우

NamingException - 네이밍 예외가 발생했을 경우

search

public NamingEnumeration <SearchResult > search(String  name,
                                              Attributes  matchingAttributes)
                                       throws NamingException 

인터페이스 DirContext 기술:

지정된 속성세트를 포함한 객체를 단일 컨텍스트 으로 검색합니다. 자세한 내용은 DirContext.search(Name, Attributes)를 참조하십시오.

정의:

인터페이스 DirContext 내의 search

파라미터:

name - 검색하는 컨텍스트 의 이름

matchingAttributes - 검색하는 속성

반환값:

SearchResult 객체의 열거

예외:

NamingException - 네이밍 예외가 발생했을 경우

search

public NamingEnumeration <SearchResult > search(Name  name,
                                              Attributes  matchingAttributes)
                                       throws NamingException 

인터페이스 DirContext 기술:

지정된 속성세트를 포함한 객체를 단일 컨텍스트 으로 검색합니다. 이 메서드는 그 객체의 모든 속성을 리턴합니다. 이것은, atributesToReturn 파라미터로서 메서드 search(Name, Attributes, String[])에 null을 제공하는 것과 동등합니다.
자세한 것은, DirContext.search(Name, Attributes, String[])를 참조하십시오.

정의:

인터페이스 DirContext 내의 search

파라미터:

name - 검색하는 컨텍스트 의 이름

matchingAttributes - 검색하는 속성

반환값:

SearchResult 객체의 열거

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

DirContext.search(Name, Attributes, String[])

search

public NamingEnumeration <SearchResult > search(String  name,
                                              Attributes  matchingAttributes,
                                              String [] attributesToReturn)
                                       throws NamingException 

인터페이스 DirContext 기술:

지정된 속성세트를 포함한 객체를 단일 컨텍스트 으로 검색해, 선택한 속성을 취득합니다. 자세한 내용은 DirContext.search(Name, Attributes, String[])를 참조하십시오.

정의:

인터페이스 DirContext 내의 search

파라미터:

name - 검색하는 컨텍스트 의 이름

matchingAttributes - 검색하는 속성

attributesToReturn - 돌려주는 속성

반환값:

null 이외의 SearchResult 객체의 열거

예외:

NamingException - 네이밍 예외가 발생했을 경우

search

public NamingEnumeration <SearchResult > search(Name  name,
                                              Attributes  matchingAttributes,
                                              String [] attributesToReturn)
                                       throws NamingException 

인터페이스 DirContext 기술:

지정된 속성세트를 포함한 객체를 단일 컨텍스트 으로 검색해, 선택한 속성을 취득합니다. 검색은 디폴트의 SearchControls 설정을 사용해 행해집니다.

객체를 선택하기 위해서는 matchingAttributes 각 속성이 객체의 속성의 어느쪽이든일치할 필요가 있습니다. matchingAttributes가 공백 또는 null인 경우, 타겟 컨텍스트 의 모든 객체가 리턴됩니다 .

matchingAttributes 속성 A₁ 으로 객체의 속성 A₂가 같은 식별자를 가지고 있어A₁ 각 값이 A₂ 값의 어느 쪽인가에 동일한 경우, A₁ 은 A₂에 일치한다고 보입니다. 이것은 값의 순서는 중요하지 않고, 또 A₂가 A₁에 없는 「여분의」값을 포함하고 있어도 비교에는 영향이 없는 것을의미합니다. 게다가A₁ 이 값을 가지고 있지 않은 경우, 일치의 테스트는 같은 식별자를 가지는 속성 A₂가 존재할지 어떨지를 조사하는 것과 같은 뜻이 됩니다.

속성값을 비교하는데 사용되는 「동등」의 상세한 정의는 기본이 되는 디렉토리 서비스에 의해 정의됩니다. 정의에는 예를 들어 Object.equals 메서드를 사용하는 경우도 있으면, schema를 사용해 다른 동등 조작을 지정하는 경우도 있습니다. 동등 이외의 조작에 근거하는 매칭 (부분 캐릭터 라인의 비교등)에는 필터 인수를 취하는 search 메서드의 버전을 사용합니다.

이 DirContext로 변경을 했을 경우, 변경전의 이 메서드에 대한 호출에 의해 리턴된 열거의 결과는 정의되지 않습니다.

지정된 속성을 객체가 가지고 있지 않은 경우, 디렉토리는 존재하지 않는 속성을 무시해, 객체가 가지고 있는 요구된 속성을 리턴합니다.

디렉토리는 요구된 이상의 수의 속성을 돌려주는 일이 있습니다 (클래스의 설명의 「속성형명」참조)가 무관계한 임의의 속성을 돌려줄 것은 없습니다.

클래스의 설명의 「조작 속성」도 참조하십시오.

정의:

인터페이스 DirContext 내의 search

파라미터:

name - 검색하는 컨텍스트 의 이름

matchingAttributes - 검색하는 속성. 공백 또는 null인 경우, 타겟 컨텍스트 의 모든 객체가 리턴된

attributesToReturn - 돌려주는 속성. null은 모든 속성이 리턴된 것을 나타낸다. 비어있는 배열은 아무것도 돌려주고지지 않은 것을 나타낸다

반환값:

null 이외의 SearchResult 객체의 열거. 각 SearchResult는 attributesToReturn에 의해 식별된 속성 및 name에 의해 이름이 붙여진 컨텍스트에 관련해 이름이 붙여진 해당 객체의 이름을 포함한다

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

SearchControls, SearchResult, DirContext.search(Name, String, Object[], SearchControls)

search

public NamingEnumeration <SearchResult > search(String  name,
                                              String  filter,
                                              SearchControls  cons)
                                       throws NamingException 

인터페이스 DirContext 기술:

이름 첨부 컨텍스트 또는 이름 첨부 객체로 지정된 검색 필터를 채우는 엔트리를 검색합니다. 검색 제어에 의해 지정된 것처럼 검색을 실시합니다. 자세한 내용은 DirContext.search(Name, String, SearchControls)를 참조하십시오.

정의:

인터페이스 DirContext 내의 search

파라미터:

name - 검색하는 컨텍스트 또는 객체의 이름

filter - 검색에 사용하는 필터식. null은 불가

cons - 검색을 제어하는 검색 제어. null인 경우, 디폴트의 검색 제어가 사용된다 ((new SearchControls())와 동등)

반환값:

필터를 채우는 객체의 SearchResult 열거

예외:

InvalidSearchFilterException - 기본이 되는 디렉토리가 지정된 검색 필터를 지원 하고 있지 않는지, 인식하지 않는 경우

InvalidSearchControlsException - 검색 제어가 무효인 설정을 포함하고 있는 경우

NamingException - 네이밍 예외가 발생했을 경우

search

public NamingEnumeration <SearchResult > search(Name  name,
                                              String  filter,
                                              SearchControls  cons)
                                       throws NamingException 

인터페이스 DirContext 기술:

이름 첨부 컨텍스트 또는 지정된 객체로 지정된 검색 필터를 채우는 엔트리를 검색합니다. 검색 제어에 의해 지정된 것처럼 검색을 실시합니다.

filter 형식과 해석은 RFC 2254에 준거하고 있습니다. attr 및 value에 대한 해석은 RFC에 다음과 같이 정의되고 있습니다.

attr는 속성의 식별자입니다.

value는 속성의 값의 캐릭터 라인 표현입니다. 속성값의 이 캐릭터 라인 표현의 평행이동은 디렉토리에 고유합니다.

예를 들어 「someCount=127」(이)라고 하는 대입식의 경우, attr는 「someCount」로value는 「127」입니다. 속성 ID ( 「someCount」) 및 경우에 따라서는 그 schema에 기반해 프로바이더는 속성의 값이 정수형인 것을 판별합니다. 프로바이더는 계속되어 캐릭터 라인 「127」을 적절히 구문 분석 합니다.

필터 캐릭터 라인의 ASCII 이외의 문자는 해당하는 Java (Unicode) 문자로 나타내, UTF-8 8중창에의 encode는 하지 않습니다. 혹은 RFC 2254 로 진술되고 있는 「backslash - 16 진수자」표기법도 사용할 수 있습니다.

디렉토리가 그 속성의 몇개인가 또는 전부의 캐릭터 라인 표현을 지원 하고 있지 않는 경우, 대신에 필터 인수를 Objects 형태로 받아들이는 search 형식을 사용할 수 있습니다. 이러한 디렉토리의 서비스 프로바이더는 필터 인수를 필터 평가의 그 서비스 특정의 표현에 평행이동 합니다. search(Name, String, Object[], SearchControls)를 참조하십시오.

RFC 2254는 부분 캐릭터 라인 일치, 등가 근사 일치, 보다 대, 보다 소를 포함한 소정의 연산자를 정의합니다. 이러한 연산자는 대응하는 시멘틱스와 함께 기본이 되는 디렉토리에 있는 연산자에 맵 됩니다. 예를 들어 동등 연산자의 경우, 디렉토리는 필터의 속성의 「동등」을 정의하는 일치 규칙을 가지고 있다고 합니다. 이 규칙을 사용해, 필터로 지정된 속성과 디렉토리의 객체의 속성이 동등한가 어떤가를 조사합니다. 같이 디렉토리가 순서부의 규칙을 가지고 있으면, 이 규칙을 사용해 「보다 대」 및 「보다 소」의 비교를 합니다.

RFC 2254 로 정의되고 있는 연산자의 모든 것을 모든 속성에 적용할 수 있는 것은 아닙니다. 연산자를 적용할 수 없는 경우, 예외 InvalidSearchFilterException가 발생 됩니다.

SearchResult 열거의 형태로 결과가 리턴됩니다 . 각 SearchResult는 객체의 이름이나 그 외 객체에 관한 정보를 포함하고 있습니다 (SearchResult 참조). 이름은 검색의 타겟 컨텍스트에 관련하고 있는 (name 파라미터에 의해 이름이 붙여진다)인가 URL 캐릭터 라인일까의 어느 쪽인지입니다. cons가 SearchControls.OBJECT_SCOPE 또는 SearchControls.SUBSTREE_SCOPE 검색 범위를 지정하는 경우에 생각되도록, 타겟 컨텍스트이 열거에 포함되는 경우, 그 이름은 비어있는 캐릭터 라인입니다. 일치 객체의 속성을 돌려주도록 cons 인수가 지정했을 경우, SearchResult는 그 속성도 포함하는 일이 있습니다.

요구된 속성을 객체가 가지고 있지 않은 경우, 그 존재하지 않는 속성은 무시됩니다. 객체가 가지고 있는 요구된 속성이 리턴됩니다 .

디렉토리는 요구된 이상의 수의 속성을 돌려주는 일이 있습니다 (클래스의 설명의 「속성형명」 참조)가 무관계한 임의의 속성을 돌려줄 것은 없습니다.

클래스의 설명의 「조작 속성」도 참조하십시오.

정의:

인터페이스 DirContext 내의 search

파라미터:

name - 검색하는 컨텍스트 또는 객체의 이름

filter - 검색에 사용하는 필터식. null은 불가

cons - 검색을 제어하는 검색 제어. null인 경우, 디폴트의 검색 제어가 사용된다 ((new SearchControls())와 동등)

반환값:

필터를 채우는 객체의 SearchResult 열거. null은 불가

예외:

InvalidSearchFilterException - 기본이 되는 디렉토리가 지정된 검색 필터를 지원 하고 있지 않는지, 인식하지 않는 경우

InvalidSearchControlsException - 검색 제어가 무효인 설정을 포함하고 있는 경우

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

DirContext.search(Name, String, Object[], SearchControls), SearchControls, SearchResult

search

public NamingEnumeration <SearchResult > search(String  name,
                                              String  filterExpr,
                                              Object [] filterArgs,
                                              SearchControls  cons)
                                       throws NamingException 

인터페이스 DirContext 기술:

이름 첨부 컨텍스트 또는 이름 첨부 객체로 지정된 검색 필터를 채우는 엔트리를 검색합니다. 검색 제어에 의해 지정된 것처럼 검색을 실시합니다. 자세한 내용은 DirContext.search(Name, String, Object[], SearchControls)를 참조하십시오.

정의:

인터페이스 DirContext 내의 search

파라미터:

name - 검색하는 컨텍스트 또는 객체의 이름

filterExpr - 검색에 사용하는 필터식. 식에는 폼 「{i}」의 변수를 포함할 수가 있다. i는 부가 아닌 정수. null은 불가

filterArgs - filterExpr 변수를 치환하는 인수의 배열. filterArgs[i]값이 각 「{i}」를 치환한다. null인 경우, 비어있는 배열과 동등

cons - 검색을 제어하는 검색 제어. null인 경우, 디폴트의 검색 제어가 사용된다 ((new SearchControls())와 동등)

반환값:

필터를 채우는 객체의 SearchResult 열거. null은 불가

예외:

InvalidSearchControlsException - cons가 무효인 설정을 포함하고 있는 경우

InvalidSearchFilterException - filterArgs를 가지는 filterExpr가 무효인 검색 필터를 나타내고 있는 경우

NamingException - 네이밍 예외가 발생했을 경우

search

public NamingEnumeration <SearchResult > search(Name  name,
                                              String  filterExpr,
                                              Object [] filterArgs,
                                              SearchControls  cons)
                                       throws NamingException 

인터페이스 DirContext 기술:

이름 첨부 컨텍스트 또는 지정된 객체로 지정된 검색 필터를 채우는 엔트리를 검색합니다. 검색 제어에 의해 지정된 것처럼 검색을 실시합니다.

filterExpr 해석은 RFC 2254에 근거하고 있습니다. 이 밖에 filterArgs 배열의 객체에 관련된 폼 {i} 변수를 포함한 경우가 있습니다. i는 정수입니다. 그 외의 점에서는 filterExpr 해석은 메서드 search(Name, String, SearchControls) filter 파라미터의 해석과 동일합니다.

변수 {i}가 검색 필터에 있는 경우, 필터 인수 filterArgs[i]가 그 자리소에 사용되는 것을 나타내고 있습니다. 이러한 변수는 attr, value, 또는 matchingrule 생성이 RFC 2254, 섹션 4 필터 문법으로 게재되는 장소라면 어디에서라도 사용할 수 있습니다. 캐릭터 라인치 필터의 인수가 변수를 치환하는 경우, 필터는 캐릭터 라인이 변수 대신에 지정된 것처럼 해석되어 RFC 2254 규칙에 따라 필터내의 특수한 미를 가지는 문자 ('*' 등)는 이스케이프 됩니다.

속성의 일부 또는 전부에 캐릭터 라인 표현을 사용하지 않는 디렉토리의 경우, 속성값에 대응하는 필터 인수는 String 이외의 형태의 가능성이 있습니다. 예를 들어 구조화되어 있지 않은 2 진수의 속성을 지원하는 디렉토리는 바이트 배열을 필터 인수로서 받아들입니다. 다른 형태의 필터 인수의 해석이 있는 경우, 해석은 그 디렉토리의 서비스 프로바이더에 의해 판별되어 서비스 프로바이더는 필터 조작을 해당하는 시멘틱스와 함께 기본이 되는 디렉토리의 조작에 맵 합니다.

이 메서드는 결과의 열거를 리턴합니다. 열거의 각 요소는 객체의 이름 그 외 객체에 관한 정보를 포함하고 있습니다 (SearchResult 참조). 이름은 (name 파라미터에 의해 이름이 붙여진) 검색의 타겟 컨텍스트에 관련하고 있는지, URL 캐릭터 라인일까의 어느 쪽인지입니다. cons가 SearchControls.OBJECT_SCOPE 또는 SearchControls.SUBSTREE_SCOPE 검색 범위를 지정하는 경우에 생각되도록, 타겟 컨텍스트이 열거에 포함되는 경우, 그 이름은 비어있는 캐릭터 라인입니다.

속성을 돌려주도록 cons 인수가 지정했을 경우, SearchResult는 일치하는 객체의 속성도 포함하는 일이 있습니다.

요구된 속성을 객체가 가지고 있지 않은 경우, 그 존재하지 않는 속성은 무시됩니다. 객체가 가지고 있는 요구된 속성이 리턴됩니다 .

디렉토리는 요구된 이상의 수의 속성을 돌려주는 일이 있습니다 (클래스의 설명의 「속성형명」 참조)가 무관계한 임의의 속성을 돌려줄 것은 없습니다.

무효인 변수의 치환을 실시하는 검색 필터가 이 메서드에 제공되었을 경우, 결과는 정의되지 않습니다. 이 DirContext 로 변경이 이루어졌을 경우, 이 메서드에 대한 변경전의 호출에 의해 리턴된 열거의 결과는 정의되지 않습니다.

클래스의 설명의 「조작 속성」도 참조하십시오.

정의:

인터페이스 DirContext 내의 search

파라미터:

name - 검색하는 컨텍스트 또는 객체의 이름

filterExpr - 검색에 사용하는 필터식. 식에는 폼 「{i}」의 변수를 포함할 수가 있다. i는 부가 아닌 정수. null은 불가

filterArgs - filterExpr 변수를 치환하는 인수의 배열. filterArgs[i]값이 각 「{i}」를 치환한다. null인 경우, 비어있는 배열과 동등

cons - 검색을 제어하는 검색 제어. null인 경우, 디폴트의 검색 제어가 사용된다 ((new SearchControls())와 동등)

반환값:

필터를 채우는 객체의 SearchResult 열거. null은 불가

예외:

InvalidSearchControlsException - cons가 무효인 설정을 포함하고 있는 경우

InvalidSearchFilterException - filterArgs를 가지는 filterExpr가 무효인 검색 필터를 나타내고 있는 경우

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

DirContext.search(Name, Attributes, String[]), MessageFormat