java.beans
클래스 PropertyChangeSupport

java.lang.Object 
  java.beans.PropertyChangeSupport

모든 구현된 인터페이스:

Serializable

알려진 직계 서브 클래스:

SwingPropertyChangeSupport

public class PropertyChangeSupport
extends Object 
implements Serializable 

바운드 프로퍼티를 지원하는 bean 로 사용할 수 있는 유틸리티 클래스입니다. 이 클래스의 인스턴스를 bean 멤버 필드로서 사용해, 다양한 처리를 위양 할 수 있습니다 .이 클래스는 직렬화 가능합니다. 직렬화했을 경우, 이 클래스는 직렬화 가능한 임의의 리스너를 보존 ( 및 복원)합니다. 직렬화 가능하지 않은 리스너는 직렬화 시에 스킵 됩니다.

관련 항목:

직렬화 된 형식

생성자 개요

PropertyChangeSupport (Object sourceBean)
PropertyChangeSupport 객체를 구축합니다.

메서드 개요

void	addPropertyChangeListener (PropertyChangeListener listener) PropertyChangeListener를 리스너 리스트에 추가합니다.
void	addPropertyChangeListener (String propertyName, PropertyChangeListener listener) 특정의 프로퍼티의 PropertyChangeListener를 추가합니다.
void	fireIndexedPropertyChange (String propertyName, int index, boolean oldValue, boolean newValue) 등록되어 있는 리스너에게, boolean 바운드 인덱스 첨부 프로퍼티의 갱신을 통지합니다.
void	fireIndexedPropertyChange (String propertyName, int index, int oldValue, int newValue) 등록되어 있는 리스너에게, int 바운드 인덱스 첨부 프로퍼티의 갱신을 통지합니다.
void	fireIndexedPropertyChange (String propertyName, int index, Object oldValue, Object newValue) 등록되어 있는 리스너에게, 바운드 인덱스 첨부 프로퍼티의 갱신을 통지합니다.
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가 null인 경우, 예외가 발생되지 않고 아무것도 처리는 행해지지 않습니다.

파라미터:

listener - 추가하는 PropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener  listener)

리스너 리스트로부터 PropertyChangeListener를 삭제합니다. 이것은 모든 프로퍼티로 등록된 PropertyChangeListener를 삭제합니다. listener가 같은 이벤트 소스에 대해서 여러 차례 추가되었을 경우는 삭제된 뒤에 1회 분 적게 통지됩니다. listener가 null인 경우, 또는 한번도 추가되지 않았던 경우는 예외가 발생되지 않고 아무것도 처리는 행해지지 않습니다.

파라미터:

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가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 행해지지 않습니다.

파라미터:

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

listener - 추가하는 PropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(String  propertyName,
                                         PropertyChangeListener  listener)

특정의 프로퍼티의 PropertyChangeListener를 삭제합니다. listener가 지정의 프로퍼티의 같은 이벤트 소스에 대해서 여러 차례 추가되었을 경우는 삭제된 뒤에 1회 분 적게 통지됩니다. propertyName가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 행해지지 않습니다. listener가 null인 경우, 또는 지정의 프로퍼티에 대해서 한번도 추가되지 않았던 경우는 예외가 발생되지 않고 아무것도 처리는 행해지지 않습니다.

파라미터:

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

listener - 삭제하는 PropertyChangeListener

getPropertyChangeListeners

public PropertyChangeListener [] getPropertyChangeListeners(String  propertyName)

지정된 프로퍼티에 관련된 모든 리스너의 배열을 리턴합니다.

파라미터:

propertyName - 대기하고 있는 프로퍼티명

반환값:

이름 첨부 프로퍼티에 관련된 모든 PropertyChangeListeners. 이러한 리스너가 추가되어 있지 않은 경우, 또는 propertyName가 null인 경우는 비어있는 배열이 리턴된다

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 객체

fireIndexedPropertyChange

public void fireIndexedPropertyChange(String  propertyName,
                                      int index,
                                      Object  oldValue,
                                      Object  newValue)

등록되어 있는 리스너에게, 바운드 인덱스 첨부 프로퍼티의 갱신을 통지합니다.

낡은 값과 새로운 값이 동일하고, null이 아닌 경우, 이벤트는 트리거 되지 않습니다.

파라미터:

propertyName - 변경된 프로퍼티의 프로그램상의 이름

index - 변경된 프로퍼티 요소의 인덱스

oldValue - 프로퍼티의 낡은 값

newValue - 프로퍼티의 새로운 값

도입된 버전 :

1.5

fireIndexedPropertyChange

public void fireIndexedPropertyChange(String  propertyName,
                                      int index,
                                      int oldValue,
                                      int newValue)

등록되어 있는 리스너에게, int 바운드 인덱스 첨부 프로퍼티의 갱신을 통지합니다.

낡은 값과 새로운 값이 동일하고, null이 아닌 경우, 이벤트는 트리거 되지 않습니다.

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

파라미터:

propertyName - 변경된 프로퍼티의 프로그램상의 이름

index - 변경된 프로퍼티 요소의 인덱스

oldValue - 프로퍼티의 낡은 값

newValue - 프로퍼티의 새로운 값

도입된 버전 :

1.5

fireIndexedPropertyChange

public void fireIndexedPropertyChange(String  propertyName,
                                      int index,
                                      boolean oldValue,
                                      boolean newValue)

등록되어 있는 리스너에게, boolean 바운드 인덱스 첨부 프로퍼티의 갱신을 통지합니다.

낡은 값과 새로운 값이 동일하고, null이 아닌 경우, 이벤트는 트리거 되지 않습니다.

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

파라미터:

propertyName - 변경된 프로퍼티의 프로그램상의 이름

index - 변경된 프로퍼티 요소의 인덱스

oldValue - 프로퍼티의 낡은 값

newValue - 프로퍼티의 새로운 값

도입된 버전 :

1.5

hasListeners

public boolean hasListeners(String  propertyName)

모든 프로퍼티에 등록된 리스너도 포함해 특정의 프로퍼티에 리스너가 있을지 어떨지를 판정합니다. propertyName가 null인 경우는 모든 프로퍼티에 등록된 리스너만을 확인합니다.

파라미터:

propertyName - 프로퍼티명

반환값:

지정한 프로퍼티에 1개 이상의 리스너가 있는 경우는 true