javax.naming.event
클래스 NamingEvent

java.lang.Object 
  java.util.EventObject 
      javax.naming.event.NamingEvent

모든 구현된 인터페이스:

Serializable

public class NamingEvent
extends EventObject 

이 클래스는 네임 서비스/디렉토리 서비스로 트리거 된 이벤트를 나타냅니다.

NamingEvent 상태 구성은 다음과 같습니다.

• 이벤트 소스: 이 이벤트를 트리거 한 EventContext
• 이벤트의 형태
• 새로운 바인딩: 변경 후의 객체 정보
• 낡은 바인딩: 변경전의 객체 정보
• 변경 정보: 이 이벤트를 트리거 한 변경에 대한 정보. 일반적으로 서비스 프로바이더 특유의 정보, 또는 서버 특유의 정보

이벤트 소스는 리스너가 등록한, 항상 같은 EventContext 인스턴스가 될테니 주의해 주세요. 게다가NamingEvent에 있는 바인딩명은 그 인스턴스와 항상 관련하고 있습니다. 예를 들어 리스너가 다음의 등록을 행했다고 합니다.

        NamespaceChangeListener listener = ...;
        src.addNamingListener("x", SUBTREE_SCOPE, listener);

그 후에 객체명 "x/y"가 삭제되면, 대응하는 NamingEvent (evt)에는 다음을 포함할 필요가 있습니다.

        evt.getEventContext() == src
        evt.getOldBinding(). getName(). equals("x/y")

복수의 thread가 같은 EventContext에 동시에 액세스 하고 있는 경우는 주의가 필요합니다. thread 문제의자세한 내용은 「패키지의 설명」을 참조하십시오.

도입된 버전 :

1.3

관련 항목:

NamingListener, EventContext, 직렬화 된 형식

필드 개요

protected Object	changeInfo 이 이벤트를 생성한 변경 정보를 포함합니다.
protected Binding	newBinding 변경 후의 객체 정보를 포함합니다.
static int	OBJECT_ADDED 새로운 객체가 추가된 것을 나타내는 네이밍 이벤트형.
static int	OBJECT_CHANGED 객체가 변경된 것을 나타내는 네이밍 이벤트형.
static int	OBJECT_REMOVED 객체가 삭제된 것을 나타내는 네이밍 이벤트형.
static int	OBJECT_RENAMED 객체의 이름이 변경이 된 것을 나타내는 네이밍 이벤트형.
protected Binding	oldBinding 변경전의 객체 정보를 포함합니다.
protected int	type 이 이벤트의 형태를 포함합니다.

클래스 java.util. EventObject 로부터 상속된 필드

source

생성자 개요

NamingEvent (EventContext source, int type, Binding newBd, Binding oldBd, Object changeInfo)
NamingEvent 인스턴스를 구축합니다.

메서드 개요

void	dispatch (NamingListener listener) 이 이벤트로 최적인 리스너 메서드를 호출합니다.
Object	getChangeInfo () 이 이벤트의 변경 정보를 취득합니다.
EventContext	getEventContext () 이 이벤트를 트리거 한 이벤트 소스를 검출합니다.
Binding	getNewBinding () 변경 후의 객체의 바인딩을 취득합니다.
Binding	getOldBinding () 변경전의 객체의 바인딩을 취득합니다.
int	getType () 이 이벤트의 형태를 리턴합니다.

클래스 java.util. EventObject 로부터 상속된 메서드

getSource, toString

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

필드의 상세

OBJECT_ADDED

public static final int OBJECT_ADDED

새로운 객체가 추가된 것을 나타내는 네이밍 이벤트형. 이 정수의 값은 0 입니다.

관련 항목:

정수 필드값

OBJECT_REMOVED

public static final int OBJECT_REMOVED

객체가 삭제된 것을 나타내는 네이밍 이벤트형. 이 정수의 값은 1 입니다.

관련 항목:

정수 필드값

OBJECT_RENAMED

public static final int OBJECT_RENAMED

객체의 이름이 변경이 된 것을 나타내는 네이밍 이벤트형. 일부의 서비스에서는 논리적인 이름 변경 조작 1개에 대해서 복수 이벤트를 트리거 하는 일이 있을테니 주의해 주세요. 예를 들어 새로운 이름의 바인딩을 추가해, 낡은 바인딩을 삭제하는 것에의해 이름 변경 조작이 구현되는 경우가 있습니다.

낡은 이름 또는 새로운 이름이 리스너의 등록한 범위를 넘고 있는 경우, NamingEvent에 있는 구/신바인딩은 null이 되는 일이 있습니다.

이름 공간 트리의 내부 노드가 이름 변경했을 경우, 리스너의 범위내인 최상정도 노드를 사용해, 이름 변경 이벤트가 생성됩니다. 지원 범위는 프로바이더 고유가 됩니다. 예를 들어 내부 노드를 변경하면, 이름 변경 통지가 모든 하위 노드에 대해서 생성됩니다. 대응하는 프로바이더의 설정에 관계없이, 이러한 통지는 리스너에게 강제적으로 전달됩니다.

이 정수의 값은 2 입니다.

관련 항목:

정수 필드값

OBJECT_CHANGED

public static final int OBJECT_CHANGED

객체가 변경된 것을 나타내는 네이밍 이벤트형. 이것에는 객체의 속성이나 객체 그 자체의 변경도 있습니다. 일부의 서비스에서는 1개의 수정에 대해서 복수의 이벤트를 트리거 하는 일이 있기 때문에 주의해 주세요. 예를 들어 낡은 바인딩을 삭제하고 나서, 이름이 같아 객체가 다른 새로운 바인딩을 추가하면, 수정이 구현되는 경우가 있습니다.

이 정수의 값은 3 입니다.

관련 항목:

정수 필드값

changeInfo

protected Object  changeInfo

이 이벤트를 생성한 변경 정보를 포함합니다.

type

protected int type

이 이벤트의 형태를 포함합니다.

관련 항목:

OBJECT_ADDED, OBJECT_REMOVED, OBJECT_RENAMED, OBJECT_CHANGED

oldBinding

protected Binding  oldBinding

변경전의 객체 정보를 포함합니다.

newBinding

protected Binding  newBinding

변경 후의 객체 정보를 포함합니다.

생성자 상세

NamingEvent

public NamingEvent(EventContext  source,
                   int type,
                   Binding  newBd,
                   Binding  oldBd,
                   Object  changeInfo)

NamingEvent 인스턴스를 구축합니다.

newBd 및 oldBd의 이름은 이벤트 소스 source에 관련해 해결됩니다. OBJECT_ADDED 이벤트형에 대해서는 newBd를 null 로 하지 말아 주세요. OBJECT_REMOVED 이벤트형에 대해서는 oldBd를 null 로 하지 말아 주세요. OBJECT_CHANGED 이벤트형에 대해서는 newBd 및 oldBd를 null 로 하지 말아 주세요. OBJECT_RENAMED 이벤트형에 대해서는 리스너가 등록한 범위외에 새로운 바인딩 또는 낡은 바인딩이 있는 경우, newBd 또는 oldBd 어느쪽이든을 null 로 할 수 있습니다.

파라미터:

source - 이 이벤트를 트리거 한 null 이외의 컨텍스트

type - 이벤트의 형태

newBd - 변경전에 null 가능성이 있는 바인딩. 메서드의 설명을 참조하십시오

oldBd - 변경 후에 null 가능성이 있는 바인딩. 메서드의 설명을 참조하십시오

changeInfo - 변경 정보를 포함한, null 가능성이 있는 객체

관련 항목:

OBJECT_ADDED, OBJECT_REMOVED, OBJECT_RENAMED, OBJECT_CHANGED

메서드의 상세

getType

public int getType()

이 이벤트의 형태를 리턴합니다.

반환값:

이 이벤트의 형태

관련 항목:

OBJECT_ADDED, OBJECT_REMOVED, OBJECT_RENAMED, OBJECT_CHANGED

getEventContext

public EventContext  getEventContext()

이 이벤트를 트리거 한 이벤트 소스를 검출합니다. 이것은 EventObject.getSource()와 같은 객체를 리턴합니다.

이 메서드의 결과를 사용해 이벤트 소스에 액세스 했을 경우, 예를 들어 객체를 참조하거나 속성을 얻는인 경우, Context 구현이 thread 세이프는 아닌 (또 EventContext가 Context 서브 인터페이스이다) 모아 두어 락이 필요합니다. thread 문제의자세한 내용은 「패키지의 설명」을 참조하십시오.

반환값:

이 이벤트를 트리거 한 null 이외의 컨텍스트

getOldBinding

public Binding  getOldBinding()

변경전의 객체의 바인딩을 취득합니다.

변경전에 존재한 객체가 전송원의 컨텍스트 (getEventContext())에 관련된 경우, 바인딩은 null 이외일 필요가 있습니다. 즉, OBJECT_REMOVED 및 OBJECT_CHANGED에 대해서는 null 외로의해 주세요. OBJECT_RENAMED에 대해서는 이름 변경전의 객체가 대상을 등록한 리스너의 범위외에 있는 경우는 null 로 해, 객체가 이름 변경전의 범위내에 있는 경우는 null 외로의해 주세요.

바인딩의 이름은 이벤트 소스 getEventContext()에 관련된 것으로서 해결됩니다. Binding.getObject()로 리턴된 객체는 정보를 사용할 수 없는 경우는 null이 됩니다.

반환값:

변경전의 객체로 null 가능성이 있는 바인딩

getNewBinding

public Binding  getNewBinding()

변경 후의 객체의 바인딩을 취득합니다.

변경 후에 존재한 객체가 전송원의 컨텍스트 (getEventContext())에 관련된 경우, 바인딩은 null 이외일 필요가 있습니다. 즉, OBJECT_ADDED 및 OBJECT_CHANGED에 대해서는 null 외로의해 주세요. OBJECT_RENAMED에 대해서는 이름 변경전의 객체가 전달 대상을 리스너로 등록한 범위외에 있는 경우는 null 로 해, 객체가 이름 변경 다음에는 범위내에 있는 경우는 null 외로의해 주세요.

바인딩의 이름은 이벤트 소스 getEventContext()에 관련된 것으로서 해결됩니다. Binding.getObject()로 리턴된 객체는 정보를 사용할 수 없는 경우는 null이 됩니다.

반환값:

변경 후의 객체로 null 가능성이 있는 바인딩

getChangeInfo

public Object  getChangeInfo()

이 이벤트의 변경 정보를 취득합니다. 변경 정보의 값은 서비스 특유가 됩니다. 예를 들어 값은 서버의 변경 로그에 있는 변경을 식별하는 ID가 됩니다.

반환값:

이 이벤트의, null 가능성이 있는 변경 정보

dispatch

public void dispatch(NamingListener  listener)

이 이벤트로 최적인 리스너 메서드를 호출합니다. 이 메서드의 디폴트 구현에서는 다음의 이벤트형을 처리합니다. OBJECT_ADDED, OBJECT_REMOVED, OBJECT_RENAMED 및 OBJECT_CHANGED 입니다.

리스너 메서드는 이 메서드와 같은 thread로 실행됩니다. thread 문제의자세한 내용은 「패키지의 설명」을 참조하십시오.

파라미터:

listener - null 이외의 리스너