JavaTM 2
Platform
Std.  Ed.  v1. 4.0

javax.naming.event
인터페이스 EventDirContext

모든 슈퍼 인터페이스:
Context , DirContext , EventContext

public interface EventDirContext
extends EventContext , DirContext

디렉토리 문맥으로 지정된 오브젝트가 변경되었을 때에 방아쇠 된 이벤트의 통지를 받는 청취자의 등록에 관한 메소드를 포함합니다.

이 인터페이스에 있는 메소드는 RFC 2254 의 검색 필터에 의한 오브젝트의 식별을 서포트하고 있습니다.

검색 필터를 사용하면(자), 등록시에 존재하지 않는 오브젝트로 전달 대상을 등록해, 다음에 오브젝트를 작성해 필터를 채우는 것이 가능하게 됩니다. 다만, 서비스 프로바이더나 사용하는 프로토콜/서비스에 따라서는 서포트 내용에 제한이 있는 경우가 있습니다. 호출측이 이 방법에서는 서포트되어 있지 않은 필터를 송신했을 경우,addNamingListener()InvalidSearchFilterException 를 슬로우 합니다.

이벤트 소스와 타겟의 설명, 및 이 인터페이스의 메소드에서도 적용할 수 있는 청취자 등록/등록 해제에 대해서는 EventContext 를 참조해 주세요. thread 문제의 자세한 것은 「패키지의 설명」을 참조해 주세요.

SearchControls 또는 파라미터로서 메소드에게 건네진 배열 오브젝트는 호출측이 소유하게 됩니다. 서비스 프로바이더가 오브젝트를 수정하거나 그 참조를 보존할 수 없습니다.

도입된 버젼:
1.3

필드의 개요
 
인터페이스 javax.naming.event. EventContext 에서 상속받은 필드
OBJECT_SCOPE , ONELEVEL_SCOPE , SUBTREE_SCOPE
 
인터페이스 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
 
인터페이스 javax.naming.directory. DirContext 에서 상속받은 필드
ADD_ATTRIBUTE , REMOVE_ATTRIBUTE , REPLACE_ATTRIBUTE
 
메소드의 개요
 void addNamingListener (Name  target, String  filter, Object [] filterArgs, SearchControls  ctls, NamingListener  l)
          청취자를 추가해, 타겟으로 지정된 오브젝트로, 검색 필터 filter 및 필터 인수로 특정한 오브젝트가 수정되었을 경우, 방아쇠 된 네이밍 이벤트를 받아들이도록(듯이) 합니다.
 void addNamingListener (Name  target, String  filter, SearchControls  ctls, NamingListener  l)
          청취자를 추가해, 타겟으로 밤오브젝트의 지정되었을 때에, 검색 필터 filter 로 특정된 오브젝트가 수정되었을 경우, 방아쇠 된 네이밍 이벤트를 받아들이도록(듯이) 합니다.
 void addNamingListener (String  target, String  filter, Object [] filterArgs, SearchControls  ctls, NamingListener  l)
          청취자를 추가해, 캐릭터 라인 타겟명에 의한 오브젝트의 지정되었을 때에, 검색 필터 filter 및 필터 인수로 특정한 오브젝트가 수정되었을 경우, 방아쇠 된 네이밍 이벤트를 받아들이도록(듯이) 합니다.
 void addNamingListener (String  target, String  filter, SearchControls  ctls, NamingListener  l)
          청취자를 추가해, 캐릭터 라인 타겟명에 의한 오브젝트의 지정되었을 때에, 검색 필터 filter 로 특정된 오브젝트가 수정되었을 경우, 방아쇠 된 네이밍 이벤트를 받아들이도록(듯이) 합니다.
 
인터페이스 javax.naming.event. EventContext 에서 상속받은 메소드
addNamingListener , addNamingListener , removeNamingListener , targetMustExist
 
인터페이스 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
 
인터페이스 javax.naming.directory. DirContext 에서 상속받은 메소드
bind , bind , createSubcontext , createSubcontext , getAttributes , getAttributes , getAttributes , getAttributes , getSchema , getSchema , getSchemaClassDefinition , getSchemaClassDefinition , modifyAttributes , modifyAttributes , modifyAttributes , modifyAttributes , rebind , rebind , search , search , search , search , search , search , search , search
 

메소드의 상세

addNamingListener

public void addNamingListener(Name  target,
                              String  filter,
                              SearchControls  ctls,
                              NamingListener  l)
                       throws NamingException 
청취자를 추가해, 타겟으로 밤오브젝트의 지정되었을 때에, 검색 필터 filter 로 특정된 오브젝트가 수정되었을 경우, 방아쇠 된 네이밍 이벤트를 받아들이도록(듯이) 합니다.

검색 컨트롤 ctls 로부터의 returningObj 플래그 및 returningAttributes 플래그라고 하는 스코프는 청취자가 대상으로 하는 오브젝트의 선택을 컨트롤 할 때에 이용되어 어느 정보가 NamingEvent 오브젝트에 돌려주어지는지를 판정합니다. 돌려주어지는 요구 정보는 이용할 수 없는 경우, 또는 서비스 프로바이더나 서비스로 취득할 수 없었던 경우,NamingEvent 오브젝트에 나타나지 않는 것이 있습니다.

파라미터:
target - 이 문맥에 관련해 해결되는 오브젝트의 null 이외의 이름
filter - null 이외의 캐릭터 라인 필터 (RFC2254 참조)
ctls - null 의 가능성이 있는 검색 컨트롤. null 의 경우, 디폴트의 검색 컨트롤이 사용되는
l - null 이외의 청취자
예외:
NamingException - 청취자 추가시에 문제가 발생했을 경우
관련 항목:
EventContext.removeNamingListener(javax.naming.event.NamingListener) , DirContext.search(javax.naming.Name, java.lang.String, javax.naming.directory.SearchControls)

addNamingListener

public void addNamingListener(String  target,
                              String  filter,
                              SearchControls  ctls,
                              NamingListener  l)
                       throws NamingException 
청취자를 추가해, 캐릭터 라인 타겟명에 의한 오브젝트의 지정되었을 때에, 검색 필터 filter 로 특정된 오브젝트가 수정되었을 경우, 방아쇠 된 네이밍 이벤트를 받아들이도록(듯이) 합니다. 이 메소드의 동작 방법에 대한 자세한 것은 Name 를 받아들이는 overload를 참조해 주세요.

파라미터:
target - 이 문맥에 관련해 해결되는 오브젝트의 null 이외의 캐릭터 라인명
filter - null 이외의 캐릭터 라인 필터 (RFC2254 참조)
ctls - null 의 가능성이 있는 검색 컨트롤. null 의 경우, 디폴트의 검색 컨트롤이 사용되는
l - null 이외의 청취자
예외:
NamingException - 청취자 추가시에 문제가 발생했을 경우
관련 항목:
EventContext.removeNamingListener(javax.naming.event.NamingListener) , DirContext.search(java.lang.String, java.lang.String, javax.naming.directory.SearchControls)

addNamingListener

public void addNamingListener(Name  target,
                              String  filter,
                              Object [] filterArgs,
                              SearchControls  ctls,
                              NamingListener  l)
                       throws NamingException 
청취자를 추가해, 타겟으로 지정된 오브젝트로, 검색 필터 filter 및 필터 인수로 특정한 오브젝트가 수정되었을 경우, 방아쇠 된 네이밍 이벤트를 받아들이도록(듯이) 합니다. 검색 컨트롤 ctls 로부터의 returningObj 플래그 및 returningAttributes 플래그라고 하는 스코프는 청취자가 대상으로 하는 오브젝트의 선택을 컨트롤 할 때에 이용되어 어느 정보가 NamingEvent 오브젝트에 돌려주어지는지를 판정합니다. 돌려주어지는 요구 정보는 이용할 수 없는 경우, 또는 서비스 프로바이더나 서비스로 취득할 수 없었던 경우,NamingEvent 오브젝트에 나타나지 않는 것이 있습니다.

파라미터:
target - 이 문맥에 관련해 해결되는 오브젝트의 null 이외의 이름
filter - null 이외의 캐릭터 라인 필터 (RFC2254 참조)
filterArgs - 필터에 대해서 null 의 가능성이 있는 인수의 배열
ctls - null 의 가능성이 있는 검색 컨트롤. null 의 경우, 디폴트의 검색 컨트롤이 사용되는
l - null 이외의 청취자
예외:
NamingException - 청취자 추가시에 문제가 발생했을 경우
관련 항목:
EventContext.removeNamingListener(javax.naming.event.NamingListener) , DirContext.search(javax.naming.Name, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)

addNamingListener

public void addNamingListener(String  target,
                              String  filter,
                              Object [] filterArgs,
                              SearchControls  ctls,
                              NamingListener  l)
                       throws NamingException 
청취자를 추가해, 캐릭터 라인 타겟명에 의한 오브젝트의 지정되었을 때에, 검색 필터 filter 및 필터 인수로 특정한 오브젝트가 수정되었을 경우, 방아쇠 된 네이밍 이벤트를 받아들이도록(듯이) 합니다. 이 메소드의 동작 방법에 대한 자세한 것은 Name 를 받아들이는 overload를 참조해 주세요.

파라미터:
target - 이 문맥에 관련해 해결되는 오브젝트의 null 이외의 캐릭터 라인명
filter - null 이외의 캐릭터 라인 필터 (RFC2254 참조)
filterArgs - 필터에 대해서 null 의 가능성이 있는 인수의 배열
ctls - null 의 가능성이 있는 검색 컨트롤. null 의 경우, 디폴트의 검색 컨트롤이 사용되는
l - null 이외의 청취자
예외:
NamingException - 청취자 추가시에 문제가 발생했을 경우
관련 항목:
EventContext.removeNamingListener(javax.naming.event.NamingListener) , DirContext.search(java.lang.String, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)

JavaTM 2
Platform
Std.  Ed.  v1. 4.0

버그의 보고와 기능의 리퀘스트
이외의 API 레퍼런스 및 개발자용 문서에 대해서는 Java 2 SDK SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

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.