java.beans
클래스 PropertyChangeSupport

java.lang.Object 
  |
  +--java.beans.PropertyChangeSupport

모든 구현 인터페이스:

Serializable

직계의 기존의 서브 클래스:

SwingPropertyChangeSupport

public class PropertyChangeSupport

extends Object

implements Serializable

바운드 프로퍼티를 서포트하는 bean 에 의해 사용되는 유틸리티 클래스입니다. 이 클래스의 인스턴스를 bean 의 멤버 필드로서 사용해, 다양한 처리를 delegate 할 수가 있습니다. 이 클래스는 직렬화 가능합니다. 직렬화했을 경우, 직렬화 가능한 청취자가 보존 및 복원됩니다. 직렬화때, 비직렬화 가능한 청취자는 스킵 됩니다.

관련 항목:

직렬화 된 형식

생성자의 개요

PropertyChangeSupport (Object sourceBean)
PropertyChangeSupport 오브젝트를 구축합니다.

메소드의 개요

void	addPropertyChangeListener (PropertyChangeListener listener) PropertyChangeListener 를 청취자 리스트에 추가합니다.
void	addPropertyChangeListener (String propertyName, PropertyChangeListener listener) 특정의 프로퍼티의 PropertyChangeListener 를 추가합니다.
void	firePropertyChange (PropertyChangeEvent evt) 등록되어 있는 청취자에 대해서, 기존의 PropertyChangeEvent 를 방아쇠 합니다.
void	firePropertyChange (String propertyName, boolean oldValue, boolean newValue) 등록되어 모든 청취자에게 boolean 바운드 프로퍼티의 갱신을 통지합니다.
void	firePropertyChange (String propertyName, int oldValue, int newValue) 등록되어 모든 청취자에게 int 바운드 프로퍼티의 갱신을 통지합니다.
void	firePropertyChange (String propertyName, Object oldValue, Object newValue) 등록되어 있는 청취자에게, 바운드 프로퍼티의 갱신을 통지합니다.
PropertyChangeListener []	getPropertyChangeListeners () addPropertyChangeListener()에 의해 PropertyChangeSupport 오브젝트에 추가된 모든 청취자의 배열을 돌려줍니다.
PropertyChangeListener []	getPropertyChangeListeners (String propertyName) 지정된 프로퍼티에 관련 붙일 수 있어 모든 청취자의 배열을 돌려줍니다.
boolean	hasListeners (String propertyName) 특정의 프로퍼티의 청취자가 있을지 어떨지를 판정합니다.
void	removePropertyChangeListener (PropertyChangeListener listener) PropertyChangeListener 를 청취자 리스트로부터 삭제합니다.
void	removePropertyChangeListener (String propertyName, PropertyChangeListener listener) 특정의 프로퍼티의 PropertyChangeListener 를 삭제합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

PropertyChangeSupport

public PropertyChangeSupport(Object  sourceBean)

PropertyChangeSupport 오브젝트를 구축합니다.

파라미터:

sourceBean - 모든 이벤트의 발생원으로서 지정되는 bean

메소드의 상세

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener  listener)

PropertyChangeListener 를 청취자 리스트에 추가합니다. 청취자는 모든 프로퍼티에 대해서 등록됩니다.

파라미터:

listener - 추가되는 PropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener  listener)

PropertyChangeListener 를 청취자 리스트로부터 삭제합니다. 이렇게 하는 것으로, 모든 프로퍼티에 대해서 등록된 PropertyChangeListener 가 삭제됩니다.

파라미터:

listener - 삭제되는 PropertyChangeListener

getPropertyChangeListeners

public PropertyChangeListener [] getPropertyChangeListeners()

addPropertyChangeListener()에 의해 PropertyChangeSupport 오브젝트에 추가된 모든 청취자의 배열을 돌려줍니다.

지정된 프로퍼티에 의해 추가된 청취자가 있는 경우, PropertyChangeListener 와 PropertyChangeListenerProxy 로부터 되는 배열이 돌려주어집니다. 청취자의 식별로 관계하고 있는 호출원메소드는 개개의 요소를 테스트해 PropertyChangeListenerProxy 일지 어떨지의 확인, 캐스트, 파라미터의 확인을 실시할 필요가 있습니다.

 PropertyChangeListener[] listeners = bean.getPropertyChangeListeners();
 for (int i = 0; i < listeners.length; i++) {
	 if (listeners[i] instanceof PropertyChangeListenerProxy) {
     PropertyChangeListenerProxy proxy = 
                    (PropertyChangeListenerProxy) listeners[i];
     if (proxy.getPropertyName(). equals("foo")) {
       // proxy is a PropertyChangeListener which was associated
       // with the property named "foo"
     }
   }
 }

반환값:

추가된 모든 PropertyChangeListeners. 청취자가 추가되어 있지 않은 경우는 하늘의 배열

도입된 버젼:

1.4

관련 항목:

PropertyChangeListenerProxy

addPropertyChangeListener

public void addPropertyChangeListener(String  propertyName,
                                      PropertyChangeListener  listener)

특정의 프로퍼티의 PropertyChangeListener 를 추가합니다. 청취자가 불려 가는 것은 firePropertyChange 의 호출에 의해, 그 특정의 프로퍼티가 지정되었을 때 뿐입니다.

파라미터:

propertyName - 대기하고 있는 프로퍼티의 이름

listener - 추가하는 PropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(String  propertyName,
                                         PropertyChangeListener  listener)

특정의 프로퍼티의 PropertyChangeListener 를 삭제합니다.

파라미터:

propertyName - 대기하고 있던 프로퍼티의 이름

listener - 삭제하는 PropertyChangeListener

getPropertyChangeListeners

public PropertyChangeListener [] getPropertyChangeListeners(String  propertyName)

지정된 프로퍼티에 관련 붙일 수 있어 모든 청취자의 배열을 돌려줍니다.

반환값:

지정된 프로퍼티에 관련 붙일 수 있어 모든 PropertyChangeListeners. 청취자가 추가되어 있지 않은 경우는 하늘의 배열

firePropertyChange

public void firePropertyChange(String  propertyName,
                               Object  oldValue,
                               Object  newValue)

등록되어 있는 청취자에게, 바운드 프로퍼티의 갱신을 통지합니다. 이전의 값과 새로운 값이 동일하고, null 가 아닌 경우, 이벤트는 방아쇠 되지 않습니다.

파라미터:

propertyName - 변경된 프로퍼티의 프로그램명

oldValue - 낡은 프로퍼티치

newValue - 새로운 프로퍼티치

firePropertyChange

public void firePropertyChange(String  propertyName,
                               int oldValue,
                               int newValue)

등록되어 모든 청취자에게 int 바운드 프로퍼티의 갱신을 통지합니다. 낡은 값과 새로운 값이 동일하고, null 가 아닌 경우, 이벤트는 방아쇠 되지 않습니다.

이 메소드는 Object 값을 받는 보다 일반적인 firePropertyChange 메소드의 간이 래퍼입니다.

파라미터:

propertyName - 변경된 프로퍼티의 프로그램명

oldValue - 낡은 프로퍼티치

newValue - 새로운 프로퍼티치

firePropertyChange

public void firePropertyChange(String  propertyName,
                               boolean oldValue,
                               boolean newValue)

등록되어 모든 청취자에게 boolean 바운드 프로퍼티의 갱신을 통지합니다. 낡은 값과 새로운 값이 동일하고, null 가 아닌 경우, 이벤트는 방아쇠 되지 않습니다.

이 메소드는 Object 값을 받는 보다 일반적인 firePropertyChange 메소드의 간이 래퍼입니다.

파라미터:

propertyName - 변경된 프로퍼티의 프로그램명

oldValue - 낡은 프로퍼티치

newValue - 새로운 프로퍼티치

firePropertyChange

public void firePropertyChange(PropertyChangeEvent  evt)

등록되어 있는 청취자에 대해서, 기존의 PropertyChangeEvent 를 방아쇠 합니다. 지정된 이벤트의 이전의 값과 새로운 값이 동일하고, null 가 아닌 경우, 이벤트는 방아쇠 되지 않습니다.

파라미터:

evt - PropertyChangeEvent 오브젝트

hasListeners

public boolean hasListeners(String  propertyName)

특정의 프로퍼티의 청취자가 있을지 어떨지를 판정합니다.

파라미터:

propertyName - 프로퍼티명

반환값:

지정의 프로퍼티의 청취자가 1 개 이상 있는 경우는 true