javax.naming.event
인터페이스 EventDirContext

모든 슈퍼 인터페이스:

Context , DirContext , EventContext

public interface EventDirContext
extends EventContext , DirContext 

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

이 인터페이스에 있는 메소드는,RFC 2254 의 검색 필터에 의한 객체의 식별을 지원하고 있습니다.

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

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

SearchControls 또는, 파라미터로서 메소드에게 건네진 배열 객체는, 호출측이 소유하게 됩니다. 서비스 프로바이더는 객체를 변경하지 않고, 그 객체에 대한 참조도 보관 유지하지 않습니다.

도입된 버젼:

1.3

필드의 개요

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

OBJECT_SCOPE , ONELEVEL_SCOPE , SUBTREE_SCOPE

인터페이스 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

메소드의 개요

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.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

인터페이스 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

메소드의 상세

addNamingListener

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

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

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

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)