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)