|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
java.lang.Object
|
+--javax.naming.InitialContext
|
+--javax.naming.directory.InitialDirContext
이 클래스는 디렉토리 조작을 실행하기 위한 개시 문맥입니다. InitialContext 의 클래스에 대한 기술 (동기 문맥을 포함한다)이 적용됩니다.
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 |
search (Name name,
Attributes matchingAttributes)
지정된 속성세트를 포함한 오브젝트를 단일 문맥으로 검색합니다. |
NamingEnumeration |
search (Name name,
Attributes matchingAttributes,
String [] attributesToReturn)
지정된 속성세트를 포함한 오브젝트를 단일 문맥으로 검색해, 선택한 속성을 취득합니다. |
NamingEnumeration |
search (Name name,
String filterExpr,
Object [] filterArgs,
SearchControls cons)
이름 첨부 문맥 또는 지정된 오브젝트로, 지정된 검색 필터를 채우는 엔트리를 검색합니다. |
NamingEnumeration |
search (Name name,
String filter,
SearchControls cons)
이름 첨부 문맥 또는 지정된 오브젝트로, 지정된 검색 필터를 채우는 엔트리를 검색합니다. |
NamingEnumeration |
search (String name,
Attributes matchingAttributes)
지정된 속성세트를 포함한 오브젝트를 단일 문맥으로 검색합니다. |
NamingEnumeration |
search (String name,
Attributes matchingAttributes,
String [] attributesToReturn)
지정된 속성세트를 포함한 오브젝트를 단일 문맥으로 검색해, 선택한 속성을 취득합니다. |
NamingEnumeration |
search (String name,
String filterExpr,
Object [] filterArgs,
SearchControls cons)
이름 첨부 문맥 또는 지정된 오브젝트로, 지정된 검색 필터를 채우는 엔트리를 검색합니다. |
NamingEnumeration |
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 |
| 생성자의 상세 |
protected InitialDirContext(boolean lazy)
throws NamingException
lazy - true 는 초기 DirContext 가 초기화되지 않는 것을 나타낸다. false 는 new InitialDirContext() 를 호출하는 것과 같다
NamingException - 네이밍 예외가 발생했을 경우InitialContext.init(Hashtable)
public InitialDirContext()
throws NamingException
NamingException - 네이밍 예외가 발생했을 경우InitialDirContext(Hashtable)
public InitialDirContext(Hashtable environment)
throws NamingException
이 constructor 에서는 environment 의 변경 또는 참조의 보존은 행해지지 않습니다만, 복제가 보존됩니다.
environment - 초기 DirContext 의 작성에 사용되는 환경. null 는 하늘의 환경을 나타낸다
NamingException - 네이밍 예외가 발생했을 경우| 메소드의 상세 |
public Attributes getAttributes(String name)
throws NamingException
DirContext 의 기술: DirContext.getAttributes(Name) 를 참조해 주세요.
DirContext 내의 getAttributes name - 속성의 취득원의 오브젝트의 이름
name 에 관련지을 수 있었던 속성세트
NamingException - 네이밍 예외가 발생했을 경우
public Attributes getAttributes(String name,
String [] attrIds)
throws NamingException
DirContext 의 기술: DirContext.getAttributes(Name, String[]) 를 참조해 주세요.
DirContext 내의 getAttributes name - 속성의 취득원의 오브젝트의 이름attrIds - 취득하는 속성의 식별자. null 는 모든 속성이 취득되는 것을 나타낸다. 하늘의 배열은 아무것도 취득되지 않는 것을 나타낸다
NamingException - 네이밍 예외가 발생했을 경우
public Attributes getAttributes(Name name)
throws NamingException
DirContext 의 기술:
DirContext 내의 getAttributes name - 속성의 취득원의 오브젝트의 이름
name 에 관련지을 수 있었던 속성세트. 이름에 속성이 없는 경우, 하늘의 속성 세트를 돌려주어, null 가 될 것은 없다
NamingException - 네이밍 예외가 발생했을 경우DirContext.getAttributes(String) ,
DirContext.getAttributes(Name, String[])
public Attributes getAttributes(Name name,
String [] attrIds)
throws NamingException
DirContext 의 기술: 지정된 속성을 오브젝트가 가지고 있지 않은 경우, 디렉토리는 존재하지 않는 속성을 무시해, 오브젝트가 가지고 있는 요구된 속성을 돌려줍니다.
디렉토리는 요구된 이상의 수의 속성을 돌려주는 일이 있습니다 (클래스 설명의 Attribute Type Names 참조)가, 무관계한 임의의 속성을 돌려줄 것은 없습니다.
클래스의 설명의 Operational Attributes 도 참조해 주세요.
DirContext 내의 getAttributes name - 속성의 취득원의 오브젝트의 이름attrIds - 취득하는 속성의 식별자. null 는 모든 속성이 취득되는 것을 나타낸다. 하늘의 배열은 아무것도 취득되지 않는 것을 나타낸다
NamingException - 네이밍 예외가 발생했을 경우
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 는 불가
NamingException - 네이밍 예외가 발생했을 경우
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 는 불가
NamingException - 네이밍 예외가 발생했을 경우DirContext.modifyAttributes(Name, ModificationItem[])
public void modifyAttributes(String name,
ModificationItem [] mods)
throws NamingException
DirContext 의 기술: DirContext.modifyAttributes(Name, ModificationItem[]) 를 참조해 주세요.
DirContext 내의 modifyAttributes name - 속성이 변경되는 오브젝트의 이름mods - 실행되는 변경의 순서. null 는 불가
NamingException - 네이밍 예외가 발생했을 경우
public void modifyAttributes(Name name,
ModificationItem [] mods)
throws NamingException
DirContext 의 기술:
DirContext 내의 modifyAttributes name - 속성이 변경되는 오브젝트의 이름mods - 실행되는 변경의 순서. null 는 불가
NamingException - 네이밍 예외가 발생했을 경우DirContext.modifyAttributes(Name, int, Attributes) ,
ModificationItem
public void bind(String name,
Object obj,
Attributes attrs)
throws NamingException
DirContext 의 기술: DirContext.bind(Name, Object, Attributes) 를 참조해 주세요.
DirContext 내의 bind name - 하늘이 아닌 바인드 되는 이름obj - null 의 가능성이 있는 바인드 되는 오브젝트attrs - 바인딩에 관련짓는 오브젝트
NamingException - 네이밍 예외가 발생했을 경우
public void bind(Name name,
Object obj,
Attributes attrs)
throws NamingException
DirContext 의 기술:
DirContext 내의 bind name - 하늘이 아닌 바인드 되는 이름obj - null 의 가능성이 있는 바인드 되는 오브젝트attrs - 바인딩에 관련짓는 오브젝트
NamingException - 네이밍 예외가 발생했을 경우Context.bind(Name, Object) ,
DirContext.rebind(Name, Object, Attributes)
public void rebind(String name,
Object obj,
Attributes attrs)
throws NamingException
DirContext 의 기술: DirContext.rebind(Name, Object, Attributes) 를 참조해 주세요.
DirContext 내의 rebind name - 하늘이 아닌 바인드 되는 이름obj - null 의 가능성이 있는 바인드 되는 오브젝트attrs - 바인딩에 관련짓는 오브젝트
NamingException - 네이밍 예외가 발생했을 경우
public void rebind(Name name,
Object obj,
Attributes attrs)
throws NamingException
DirContext 의 기술:
DirContext 내의 rebind name - 하늘이 아닌 바인드 되는 이름obj - null 의 가능성이 있는 바인드 되는 오브젝트attrs - 바인딩에 관련짓는 오브젝트
NamingException - 네이밍 예외가 발생했을 경우Context.bind(Name, Object) ,
DirContext.bind(Name, Object, Attributes)
public DirContext createSubcontext(String name,
Attributes attrs)
throws NamingException
DirContext 의 기술: DirContext.createSubcontext(Name, Attributes) 를 참조해 주세요.
DirContext 내의 createSubcontext name - 하늘이 아닌 작성되는 문맥의 이름attrs - 새롭게 작성된 문맥에 관련짓는 오브젝트
NamingException - 네이밍 예외가 발생했을 경우
public DirContext createSubcontext(Name name,
Attributes attrs)
throws NamingException
DirContext 의 기술:
DirContext 내의 createSubcontext name - 하늘이 아닌 작성되는 문맥의 이름attrs - 새롭게 작성된 문맥에 관련짓는 오브젝트
NamingException - 네이밍 예외가 발생했을 경우Context.createSubcontext(Name)
public DirContext getSchema(String name)
throws NamingException
DirContext 의 기술: DirContext.getSchema(Name) 를 참조해 주세요.
DirContext 내의 getSchema name - schema의 취득원오브젝트의 이름
NamingException - 네이밍 예외가 발생했을 경우
public DirContext getSchema(Name name)
throws NamingException
DirContext 의 기술: 이 메소드는 지정된 오브젝트에 적용할 수 있는 schema 정보 트리의 루트를 돌려줍니다. 지정된 오브젝트 (또는 디렉토리 전체)의 몇개인가가, 같은 schema를 공유하는 경우가 있습니다.
schema 트리의 구조와 내용, schema 트리의 내용의 변경 허가, 이러한 변경의 디렉토리에의 영향등의 문제는 기본이 되는 디렉토리에 의해 다릅니다.
DirContext 내의 getSchema name - schema의 취득원오브젝트의 이름
NamingException - 네이밍 예외가 발생했을 경우
public DirContext getSchemaClassDefinition(String name)
throws NamingException
DirContext 의 기술: DirContext.getSchemaClassDefinition(Name) 를 참조해 주세요.
DirContext 내의 getSchemaClassDefinition name - 오브젝트 클래스 정의의 취득원오브젝트의 이름
NamingException - 네이밍 예외가 발생했을 경우
public DirContext getSchemaClassDefinition(Name name)
throws NamingException
DirContext 의 기술: 디렉토리 schema의 정보 카테고리의 1 개에클래스 정의가 있습니다. 「오브젝트 클래스」의 정의는 오브젝트의형태, 및 그 오브젝트가 가질 필요가 있는 속성과 가질 수 있는 속성 (필수와 임의)을 지정합니다. 여기서 말하는 「오브젝트 클래스」는 Java 적인 의미는 아니고, 디렉토리적인 의미로 사용되고 있습니다. 예를 들어, 지정된 오브젝트가 「Person」클래스의 디렉토리 오브젝트인 경우,getSchemaClassDefinition() 는 「Person」의 (디렉토리의) 오브젝트 클래스 정의를 나타내는 DirContext 를 돌려줍니다.
오브젝트 클래스 정의로부터 취득할 수 있는 정보는 디렉토리 의존입니다.
JNDI 1.2 보다 전은 이 메소드는 지정된 오브젝트의 클래스 정의를 나타내는 단일의 schema 오브젝트를 돌려주고 있었습니다. JNDI 1.2 로부터는 이 메소드는 지정된 오브젝트의 클래스 정의를 모두 포함한 DirContext 를 돌려줍니다.
DirContext 내의 getSchemaClassDefinition name - 오브젝트 클래스 정의의 취득원오브젝트의 이름
NamingException - 네이밍 예외가 발생했을 경우
public NamingEnumeration search(String name,
Attributes matchingAttributes)
throws NamingException
DirContext 의 기술: DirContext.search(Name, Attributes) 를 참조해 주세요.
DirContext 내의 search name - 검색하는 문맥의 이름matchingAttributes - 검색하는 속성
NamingException - 네이밍 예외가 발생했을 경우
public NamingEnumeration search(Name name,
Attributes matchingAttributes)
throws NamingException
DirContext 의 기술: search(Name, Attributes, String[]) 에 null 를 제공하는 것과 동등합니다.
DirContext.search(Name, Attributes, String[]) 를 참조해 주세요.
DirContext 내의 search name - 검색하는 문맥의 이름matchingAttributes - 검색하는 속성
NamingException - 네이밍 예외가 발생했을 경우DirContext.search(Name, Attributes, String[])
public NamingEnumeration search(String name,
Attributes matchingAttributes,
String [] attributesToReturn)
throws NamingException
DirContext 의 기술: DirContext.search(Name, Attributes, String[]) 를 참조해 주세요.
DirContext 내의 search name - 검색하는 문맥의 이름matchingAttributes - 검색하는 속성attributesToReturn - 돌려주는 속성
NamingException - 네이밍 예외가 발생했을 경우
public NamingEnumeration search(Name name,
Attributes matchingAttributes,
String [] attributesToReturn)
throws NamingException
DirContext 의 기술: SearchControls 설정을 사용해 행해집니다.
오브젝트를 선택하기 위해서는 matchingAttributes 의 각 속성이 오브젝트의 속성의 어떤 것일까하고 일치할 필요가 있습니다. matchingAttributes 가 하늘 또는 null 의 경우, 타겟 문맥의 모든 오브젝트가 돌려주어집니다.
matchingAttributes 의 속성 A1 으로 오브젝트의 속성 A2 가 같은 식별자를 가지고 있어A1 의 각 치가 A2 의 값의 어떤 것인가에 동일한 경우,A1 은 A2 에 일치한다고 보입니다. 이것은 값의 순서는 중요하지 않고 또 A2 가 A1 에 없는 「여분의」값을 포함하고 있어도 비교에는 영향이 없는 것을 의미합니다. 게다가A1 이 값을 가지고 있지 않은 경우, 일치의 테스트는 같은 식별자를 가지는 속성 A2 가 존재할지 어떨지를 조사하는 것과 같은 뜻이 됩니다.
속성치를 비교하는데 사용되는 「동등」의 상세한 정의는 기본이 되는 디렉토리 서비스에 의해 정의됩니다. 정의에는 예를 들어 Object.equals 메소드를 사용하는 경우도 있으면, schema를 사용해 다른 동등 조작을 지정하는 경우도 있습니다. 동등 이외의 조작에 근거하는 매칭 (부분 캐릭터 라인의 비교등)에는 필터 인수를 취하는 search 메소드의 버젼을 사용합니다.
이 DirContext 로 변경을 했을 경우, 변경전의 이 메소드에 대한 호출에 의해 돌려주어진 열거의 결과는 정의되고 있지 않습니다.
지정된 속성을 오브젝트가 가지고 있지 않은 경우, 디렉토리는 존재하지 않는 속성을 무시해, 오브젝트가 가지고 있는 요구된 속성을 돌려줍니다.
디렉토리는 요구된 이상의 수의 속성을 돌려주는 일이 있습니다 (클래스 설명의 Attribute Type Names 참조)가, 무관계한 임의의 속성을 돌려줄 것은 없습니다.
클래스의 설명의 Operational Attributes 도 참조해 주세요.
DirContext 내의 search name - 검색하는 문맥의 이름matchingAttributes - 검색하는 속성. 하늘 또는 null 의 경우, 타겟 문맥의 모든 오브젝트가 돌려주어지는attributesToReturn - 돌려주는 속성. null 는 모든 속성이 돌려주어지는 것을 나타낸다. 하늘의 배열은 아무것도 돌려주어지지 않은 것을 나타낸다
attributesToReturn 에 의해 식별된 속성, 및 name 에 의해 이름이 붙여진 문맥에 관련해 이름이 붙여진 해당 오브젝트의 이름을 포함한다
NamingException - 네이밍 예외가 발생했을 경우SearchControls ,
SearchResult ,
DirContext.search(Name, String, Object[], SearchControls)
public NamingEnumeration search(String name,
String filter,
SearchControls cons)
throws NamingException
DirContext 의 기술: DirContext.search(Name, String, SearchControls) 를 참조해 주세요.
DirContext 내의 search name - 검색하는 문맥 또는 오브젝트의 이름filter - 검색에 사용하는 필터식. null 는 불가cons - 검색을 제어하는 검색 제어. null 의 경우, 디폴트의 검색 제어가 사용된다 ((new SearchControls()) 와 동등)
NamingException - 네이밍 예외가 발생했을 경우
public NamingEnumeration 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 는 부분 캐릭터 라인 일치, 등가, 근사 일치, 보다 대, 보다 소를 포함한 소정의 연산자를 정의합니다. 이러한 연산자는 대응하는 시멘틱스와 함께 기본이 되는 디렉토리에 있는 연산자에 MAP 됩니다. 예를 들어, 동등 연산자의 경우, 디렉토리는 필터의 속성의 「동등」을 정의하는 일치 규칙을 가지고 있다고 합니다. 이 규칙을 사용해, 필터로 지정된 속성과 디렉토리의 오브젝트의 속성이 동등한가 어떤가를 조사합니다. 같이 디렉토리가 순서부의 규칙을 가지고 있으면, 이 규칙을 사용해 「보다 대」 및 「보다 소」의 비교를 합니다.
RFC 2254 로 정의되고 있는 연산자의 모든 것을 모든 속성에 적용할 수 있는 것은 아닙니다. 연산자를 적용할 수 없는 경우, 예외 InvalidSearchFilterException 가 슬로우 됩니다.
SearchResult 의 열거의 형태로 결과가 돌려주어집니다. 각 SearchResult 는 오브젝트의 이름이나 그 외 오브젝트에 관한 정보를 포함하고 있습니다 (SearchResult 참조). 이름은 검색의 타겟 문맥에 관련하고 있는 (name 파라미터에 의해 이름이 붙여진다)인가, URL 캐릭터 라인일까의 어느 쪽인지입니다. cons 가 SearchControls.OBJECT_SCOPE 또는 SearchControls.SUBSTREE_SCOPE 의 검색 범위를 지정하는 경우에 생각되도록(듯이), 타겟 문맥이 열거에 포함되는 경우, 그 이름은 하늘의 캐릭터 라인입니다. 일치 오브젝트의 속성을 돌려주도록(듯이) cons 인수가 지정했을 경우,SearchResult 는 그 속성도 포함하는 일이 있습니다.
요구된 속성을 오브젝트가 가지고 있지 않은 경우, 그 존재하지 않는 속성은 무시됩니다. 오브젝트가 가지고 있는 요구된 속성이 돌려주어집니다.
디렉토리는 요구된 이상의 수의 속성을 돌려주는 일이 있습니다 (클래스 설명의 Attribute Type Names 참조)가, 무관계한 임의의 속성을 돌려줄 것은 없습니다.
클래스의 설명의 Operational Attributes 도 참조해 주세요.
DirContext 내의 search name - 검색하는 문맥 또는 오브젝트의 이름filter - 검색에 사용하는 필터식. null 는 불가cons - 검색을 제어하는 검색 제어. null 의 경우, 디폴트의 검색 제어가 사용된다 ((new SearchControls()) 와 동등)
NamingException - 네이밍 예외가 발생했을 경우DirContext.search(Name, String, Object[], SearchControls) ,
SearchControls ,
SearchResult
public NamingEnumeration 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()) 와 동등)
NamingException - 네이밍 예외가 발생했을 경우
public NamingEnumeration 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 진치의 속성을 서포트하는 디렉토리는 바이트 배열을 필터 인수로서 받아들입니다. 다른 형태의 필터 인수의 해석이 있는 경우, 해석은 그 디렉토리의 서비스 프로바이더에 의해 판별되어 서비스 프로바이더는 필터 조작을, 해당하는 시멘틱스와 함께 기본이 되는 디렉토리의 조작에 MAP 합니다.
이 메소드는 결과의 열거를 돌려줍니다. 열거의 각 요소는 오브젝트의 이름 그 외 오브젝트에 관한 정보를 포함하고 있습니다 (SearchResult 참조). 이름은 (name 파라미터에 의해 이름이 붙여진) 검색의 타겟 문맥에 관련하고 있는지 URL 캐릭터 라인일까의 어느 쪽인지입니다. cons 가 SearchControls.OBJECT_SCOPE 또는 SearchControls.SUBSTREE_SCOPE 의 검색 범위를 지정하는 경우에 생각되도록(듯이), 타겟 문맥이 열거에 포함되는 경우, 그 이름은 하늘의 캐릭터 라인입니다.
속성을 돌려주도록(듯이) cons 인수가 지정했을 경우,SearchResult 는 일치하는 오브젝트의 속성도 포함하는 일이 있습니다.
요구된 속성을 오브젝트가 가지고 있지 않은 경우, 그 존재하지 않는 속성은 무시됩니다. 오브젝트가 가지고 있는 요구된 속성이 돌려주어집니다.
디렉토리는 요구된 이상의 수의 속성을 돌려주는 일이 있습니다 (클래스 설명의 Attribute Type Names 참조)가, 무관계한 임의의 속성을 돌려줄 것은 없습니다.
무효인 변수의 치환을 실시하는 검색 필터가 이 메소드에 제공되었을 경우, 결과는 정의되고 있지 않습니다. 이 DirContext 로 변경이 이루어졌을 경우, 이 메소드에 대한 변경전의 호출에 의해 돌려주어지는 열거의 결과는 정의되고 있지 않습니다.
클래스의 설명의 Operational Attributes 도 참조해 주세요.
DirContext 내의 search name - 검색하는 문맥 또는 오브젝트의 이름filterExpr - 검색에 사용하는 필터식. 식에는 폼 「{i}」의 변수를 포함할 수가 있다. i 는 부가 아닌 정수. null 는 불가filterArgs - filterExpr 의 변수를 치환하는 인수의 배열. filterArgs[i] 의 값이 각 「{i}」를 치환한다. null 의 경우, 하늘의 배열과 동등cons - 검색을 제어하는 검색 제어. null 의 경우, 디폴트의 검색 제어가 사용된다 ((new SearchControls()) 와 동등)
NamingException - 네이밍 예외가 발생했을 경우DirContext.search(Name, Attributes, String[]) ,
MessageFormat
|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.