패키지 javax.naming.event

네이밍 및 디렉토리 서비스에 액세스 하는 경우, 이벤트 통지를 지원 하고 있습니다.

참조처:
설명

인터페이스 개요

EventContext	컨텍스트 으로 지정된 객체가 변경되었을 때에 트리거 되는 이벤트의 통지를 받는 리스너의 등록/등록 해제에 관한 메서드를 포함합니다.
EventDirContext	디렉토리 컨텍스트 으로 지정된 객체가 변경되었을 때에 트리거 된 이벤트의 통지를 받는 리스너의 등록에 관한 메서드를 포함합니다.
NamespaceChangeListener	이름 공간의 변경을 대상으로 하는 리스너가 구현에 필요한 메서드를 지정합니다.
NamingListener	이 인터페이스는 NamingEvent를 처리하는 리스너측 인터페이스의 루트입니다.
ObjectChangeListener	OBJECT_CHANGED 이벤트형을 가지는 NamingEvent 리스너가 구현해야 하는 메서드를 지정합니다.

클래스 개요

NamingEvent	이 클래스는 네임 서비스/디렉토리 서비스로 트리거 된 이벤트를 나타냅니다.
NamingExceptionEvent	이 클래스는 NamingEvent를 통지하는 리스너의 정보를 수집하는 순서/프로세스가 NamingException을 Throw 했을 때에 트리거 되는 이벤트를 나타냅니다.

패키지 javax.naming.event 설명

네이밍 및 디렉토리 서비스에 액세스 하는 경우, 이벤트 통지를 지원 하고 있습니다.

이 패키지는 Java Naming and Directory Interface^TM (JNDI)의 이벤트 통지 조작을 정의합니다. JNDI 는 Java 프로그램 언어로 작성된 어플리케이션에 네이밍 기능 및 디렉토리 기능을 제공합니다. JNDI는 특정의 네이밍 또는 디렉토리 서비스 구현으로부터 독립해 설계되고 있습니다. 이 때문에 새로운 서비스 및 이미 배치되고 있는 다양한 서비스에 공통의 방법으로 액세스 할 수 있습니다.

네이밍 이벤트

이 패키지로 네이밍 및 디렉토리 서비스로 생성되는 이벤트를 표시하려면, NamingEvent 클래스를 정의합니다. Context와 DirContext 서브 인터페이스로서EventContext와 EventDirContext도 정의합니다. 이 서브 인터페이스를 사용해, 어플리케이션은 컨텍스트 으로 트리거 된 이벤트에 그 대상을 등록합니다.

NamingEvent 란 네이밍 및 디렉토리 서비스로 발생하는 이벤트입니다. 네이밍 이벤트에는 다음의 2 종류의 카테고리가 있습니다.

• 이름 공간 (객체의 추가 변경, 삭제)에 영향을 주는 것
• 객체의 컨텐츠에 영향을 주는 것

이벤트의 각 카테고리는 NamespaceChangeListener, ObjectChangeListener 등의 대응하는 리스너에 의해 처리됩니다.

예를 들어 어플리케이션의 경우, 변경하는 대상을 다음과 같이 객체에 등록할 수 있습니다.

EventContext src =  (EventContext)(new InitialContext()). lookup("o=wiz, c=us") ;src.addNamingListener("ou=users", EventContext.ONELEVEL_SCOPE, new ChangeHandler());...class ChangeHandler implements ObjectChangeListener { public void objectChanged(NamingEvent evt) { System.out.println(evt.getNewBinding());
 } public void namingExceptionThrown(NamingExceptionEvent evt) { System.out.println(evt.getException());
 }}

thread 문제

이벤트가 리스너에게 디스패치 되는 경우, 리스너 메서드 (objectChanged() 등)는 addNamingListener()에 의 호출이 실행된 thread 이외로 실행 가능합니다. 사용하는 thread는 서비스 프로바이더에 의해 선택됩니다. 이벤트가 복수의 리스너에게 디스패치 되는 경우, 별개의 thread로 동시에 리스너 메서드를 실행하려면, 서비스 프로바이더가 선택 ( 및 일반적으로 장려된다)하는 일이 있습니다.

리스너 인스턴스가 NamingEvent.getEventContext()를 호출했을 경우, 다른 thread로 동시에 동일한 컨텍스트를 처리하고 있을 가능성을 고려할 필요가 있습니다. 똑같이, 리스너가 addNamingListener()를 개입시켜 등록될 때의 thread는 서비스 프로바이더가 새로운에 작성한 thread로 리스너를 나중에 호출할 가능성이 있는 것을 고려할 필요가 있습니다. 컨텍스트 인스턴스는 일반적으로 thread 세이프인 것을 보증되어 있지 않기 때문에 모든 컨텍스트 조작은 필요에 따라서 동기화해 주세요.

예외 처리

리스너가 이벤트에 컨텍스트를 등록하는 경우, 이벤트 생성에 필요한 정보를 수집하기 위해, 컨텍스트에 내부 처리가 필요한 일이 있습니다. 예를 들어 최종적으로는 이벤트에 변환되는 것 같은 변경의 대상 등록을 서버에 요구할 필요가 있는 경우 등입니다. 이벤트 정보를 수집할 수 없게 하는 예외가 발생했을 경우, 리스너는 이벤트의 정보를 받을 수가 없습니다. 이러한 예외가 발생하면, NamingExceptionEvent가 트리거 되어 리스너에게 통지합니다. 상기의 샘플 코드로 표시된 것처럼 리스너의 namingExceptionThrown() 메서드가 불려가 리스너는 자동적으로 등록 해제가 됩니다.

패키지의 사양

Java 테크놀러지의 Web 사이트에서는 다음의 문서를 참조할 수 있습니다.

• 「JNDI API Document」 (Postscript)
• 「JNDI API Document」 (PDF)

도입된 버전 :

1.3