javax.swing.event
클래스 EventListenerList

java.lang.Object 
  javax.swing.event.EventListenerList

모든 구현된 인터페이스:

Serializable

public class EventListenerList
extends Object 
implements Serializable 

EventListener 리스트를 포함하는 클래스입니다. 1개의 인스턴스를 사용해, 이 리스트를 사용하고 있는 인스턴스의 (모든 타입의) 모든 리스너를 포함할 수 있습니다. 타입 보증된 API (JavaBeans 사양에의 준거가 바람직하다) 및 이벤트 통지 메서드를 리스트내의 적절한 EventListener에 송신하는 메서드의 제공은 EventListenerList를 사용하고 있는 클래스가 실시합니다. 이 클래스가 제공하는 주된 이점은 리스너가 없는 경우에는 비교적 싸게 들어, 이벤트 리스너의 리스트를 1개의 장소에서 직렬화해, 올바르게 사용했을 경우에는 어느 정도의 multi-thread에 대한 안전성이 제공되는 것입니다. 사용예: 예를 들어 FooEvent를 송출하는 클래스를 정의해, 그 클래스의 사용자가 FooListener를 등록해, FooEvent가 발생하면 통지를 받을 수가 있도록 하는 경우는 클래스의 정의에 다음의 코드를 추가할 필요가 있습니다.

 EventListenerList listenerList = new EventListenerList();
 FooEvent fooEvent = null;

 public void addFooListener(FooListener l) {
     listenerList.add(FooListener.class, l);
 }

 public void removeFooListener(FooListener l) {
     listenerList.remove(FooListener.class, l);
 }


 // Notify all listeners that have registered interest for
 // notification on this event type.   The event instance 
 // is lazily created using the parameters passed into 
 // the fire method.

 protected void fireFooXXX() {
     // Guaranteed to return a non-null array
     Object[] listeners = listenerList.getListenerList();
     // Process the listeners last to first, notifying
     // those that are interested in this event
     for (int i = listeners.length-2; i>=0; i-=2) {
         if (listeners[i]==FooListener.class) {
             // Lazily create the event:
             if (fooEvent == null)
                 fooEvent = new FooEvent(this);
             ((FooListener) listeners[i+1]). fooXXX(fooEvent);
         }
     }
 }
 

foo는 적절한 이름에 fireFooXxx는 적절한 메서드명에 각각 변경할 필요가 있습니다. FooListener 인터페이스의 통지 메서드 마다 시작 메서드가 필요합니다.

경고: 이 클래스의 직렬화 된 객체는 향후의 Swing 릴리즈와 호환되지 않을 예정입니다. 현재의 직렬화의 지원은 단기간의 운용이나, 같은 버전의 Swing를 실행하는 어플리케이션간의 RMI에 적절하고 있습니다. JDK 버전 1.4 이후, 모든 JavaBeans^™ 장기간의 운용 지원은 java.beans 패키지에 추가되고 있습니다. 자세한 내용은 XMLEncoder를 참조하십시오.

필드 개요

protected Object []

listenerList

생성자 개요

EventListenerList ()

메서드 개요

<T extends EventListener > void	add (Class <T> t, T l) 지정된 타입의 리스너로서 리스너를 추가합니다.
int	getListenerCount () 이 리스너 리스트의 리스너의 총수를 리턴합니다.
int	getListenerCount (Class <? > t) 이 리스너 리스트의, 지정된 타입의 리스너의 총수를 리턴합니다.
Object []	getListenerList () 이벤트 리스너의 리스트를, 리스너와 리스너 타입의 페어의 배열로서 리턴합니다.
<T extends EventListener > T[]	getListeners (Class <T> t) 지정된 타입의 모든 리스너의 배열을 리턴합니다.
<T extends EventListener > void	remove (Class <T> t, T l) 지정된 타입의 리스너로서 리스너를 삭제합니다.
String	toString () EventListenerList 캐릭터 라인 표현을 리턴합니다.

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

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

필드의 상세

listenerList

protected transient Object [] listenerList

생성자 상세

EventListenerList

public EventListenerList()

메서드의 상세

getListenerList

public Object [] getListenerList()

이벤트 리스너의 리스트를, 리스너와 리스너 타입의 페어의 배열로서 리턴합니다. 퍼포먼스 향상을 위해, 이 구현은 리스너 데이터가 내부에 포함되고 있는 실제의 데이터 구조체를 리턴합니다. 이 메서드는 null 이외의 배열을 돌려주는 것이 보증되고 있으므로 시작 메서드에서의 null 체크는 필요 없습니다. 현재 리스너가 없는 경우는 Object 길이가 0 배열이 리턴됩니다 . 경고: 이 배열에 포함되고 있는 데이터의 변경을 행하지 말아 주세요. 그러한 조작이 필요한 경우는 배열 그 자체가 아니고, 리턴된 배열의 카피에 대해서가 주세요.

getListeners

public <T extends EventListener > T[] getListeners(Class <T> t)

지정된 타입의 모든 리스너의 배열을 리턴합니다.

반환값:

지정된 타입의 모든 리스너

예외:

ClassCastException - 지정된 클래스가 EventListener에 할당할 수 없는 경우

도입된 버전 :

1.3

getListenerCount

public int getListenerCount()

이 리스너 리스트의 리스너의 총수를 리턴합니다.

getListenerCount

public int getListenerCount(Class <? > t)

이 리스너 리스트의, 지정된 타입의 리스너의 총수를 리턴합니다.

add

public <T extends EventListener > void add(Class <T> t,
                                          T l)

지정된 타입의 리스너로서 리스너를 추가합니다.

파라미터:

t - 추가되는 리스너의 타입

l - 추가되는 리스너

remove

public <T extends EventListener > void remove(Class <T> t,
                                             T l)

지정된 타입의 리스너로서 리스너를 삭제합니다.

파라미터:

t - 삭제되는 리스너의 타입

l - 삭제되는 리스너

toString

public String  toString()

EventListenerList 캐릭터 라인 표현을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 객체의 캐릭터 라인 표현