java.beans
클래스 VetoableChangeSupport

java.lang.Object 
  java.beans.VetoableChangeSupport

모든 구현된 인터페이스:

Serializable

public class VetoableChangeSupport
extends Object 
implements Serializable 

제약 프로퍼티을 지원하는 Bean 로 사용할 수 있는 유틸리티 클래스입니다. 이 클래스의 인스턴스를 Bean 의 멤버 필드로서 사용해, 다양한 처리를 위양 할 수가 있습니다. 이 클래스는 직렬화 가능합니다. 직렬화했을 경우, 직렬화 가능한 청취자가 보존 및 복원됩니다. 직렬화때, 직렬화 가능하지 않은 청취자는 스킵 됩니다.

관련 항목:

직렬화 된 형식

생성자 의 개요

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

메소드의 개요

void	addVetoableChangeListener (String propertyName, VetoableChangeListener listener) 특정의 프로퍼티의 VetoableChangeListener 를 추가합니다.
void	addVetoableChangeListener (VetoableChangeListener listener) VetoableListener 를 청취자 리스트에 추가합니다.
void	fireVetoableChange (PropertyChangeEvent evt) 등록되어 모든 청취자에 대해서, 거부 가능 프로퍼티의 갱신을 트리거합니다.
void	fireVetoableChange (String propertyName, boolean oldValue, boolean newValue) 등록되어 모든 청취자에게 boolean 거부 가능 프로퍼티의 갱신을 통지합니다.
void	fireVetoableChange (String propertyName, int oldValue, int newValue) 등록되어 모든 청취자에게 int 거부 가능 프로퍼티의 갱신을 통지합니다.
void	fireVetoableChange (String propertyName, Object oldValue, Object newValue) 등록되어 모든 청취자에게 거부 가능 프로퍼티의 갱신을 통지합니다.
VetoableChangeListener []	getVetoableChangeListeners () VetoableChangeListener 의 리스트를 돌려줍니다.
VetoableChangeListener []	getVetoableChangeListeners (String propertyName) 지정된 프로퍼티에 관련지을 수 있던 모든 청취자의 배열을 돌려줍니다.
boolean	hasListeners (String propertyName) 특정의 프로퍼티에 청취자가 있을지 어떨지를 판정합니다.
void	removeVetoableChangeListener (String propertyName, VetoableChangeListener listener) 특정의 프로퍼티의 VetoableChangeListener 를 삭제합니다.
void	removeVetoableChangeListener (VetoableChangeListener listener) 청취자 리스트로부터 VetoableChangeListener 를 삭제합니다.

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

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

생성자 의 상세

VetoableChangeSupport

public VetoableChangeSupport(Object  sourceBean)

VetoableChangeSupport 객체를 구축합니다.

파라미터:

sourceBean - 모든 이벤트의 소스로서 지정되는 Bean

메소드의 상세

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener  listener)

VetoableListener 를 청취자 리스트에 추가합니다. 청취자는, 모든 프로퍼티에 대해서 등록됩니다. 같은 청취자 객체를 여러 차례 추가할 수 있어 추가한 회수만 청취자 객체가 불려 갑니다. listener 가 null 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 행해지지 않습니다.

파라미터:

listener - 추가되는 VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener  listener)

청취자 리스트로부터 VetoableChangeListener 를 삭제합니다. 모든 프로퍼티에 등록된 VetoableChangeListener 를 삭제합니다. 같은 이벤트 소스에 listener 가 2 회 이상 추가되었을 경우는, 삭제된 뒤에, 추가된 회수보다 1 회 적은 통지를 합니다. listener 가 null 의 경우, 또는 추가되지 않았던 경우는, 예외는 throw 되지 않고, 아무것도 처리는 행해지지 않습니다.

파라미터:

listener - 삭제되는 VetoableChangeListener

getVetoableChangeListeners

public VetoableChangeListener [] getVetoableChangeListeners()

VetoableChangeListener 의 리스트를 돌려줍니다. 지정된 거부 가능한 변경 청취자가 추가되었을 경우, VetoableChangeListenerProxy 래퍼가 돌려주어집니다.

반환값:

지정된 프로퍼티 변경 청취자가 추가되었을 경우, VetoableChangeListener 및 VetoableChangeListenerProxy 의 리스트

도입된 버젼:

1.4

addVetoableChangeListener

public void addVetoableChangeListener(String  propertyName,
                                      VetoableChangeListener  listener)

특정의 프로퍼티의 VetoableChangeListener 를 추가합니다. 청취자가 불려 가는 것은, fireVetoableChange 의 호출에 의해, 그 특정의 프로퍼티이 지정되었을 때 뿐입니다. 같은 청취자 객체를 여러 차례 추가할 수 있습니다. 각 프로퍼티에서는, 청취자가 그 프로퍼티에 추가된 회수만 청취자가 불려 갑니다. propertyName 또는 listener 가 null 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 행해지지 않습니다.

파라미터:

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

listener - 추가되는 VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(String  propertyName,
                                         VetoableChangeListener  listener)

특정의 프로퍼티의 VetoableChangeListener 를 삭제합니다. 지정한 프로퍼티의 같은 이벤트 소스에 listener 가 2 회 이상 추가되었을 경우는, 삭제된 뒤에, 추가된 회수보다 1 회 적은 통지를 합니다. propertyName 가 null 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 행해지지 않습니다. listener 가 null 의 경우, 또는 지정된 프로퍼티에 추가되지 않았던 경우는, 예외는 throw 되지 않고, 아무것도 처리는 행해지지 않습니다.

파라미터:

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

listener - 삭제되는 VetoableChangeListener

getVetoableChangeListeners

public VetoableChangeListener [] getVetoableChangeListeners(String  propertyName)

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

파라미터:

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

반환값:

지정된 프로퍼티에 관련지을 수 있던 모든 VetoableChangeListeners. 이러한 청취자가 추가되어 있지 않은 경우, 또는 propertyName 가 null 의 경우는 빈 상태(empty)의 배열이 반환되는

도입된 버젼:

1.4

fireVetoableChange

public void fireVetoableChange(String  propertyName,
                               Object  oldValue,
                               Object  newValue)
                        throws PropertyVetoException 

등록되어 모든 청취자에게 거부 가능 프로퍼티의 갱신을 통지합니다. 변경이 거부되었을 경우는, 모든 것을 낡은 값에 되돌리는 새로운 이벤트를 트리거하고 나서, 재차 PropertyVetoException 를 throw 합니다.

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

파라미터:

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

oldValue - 프로퍼티의 낡은 값

newValue - 프로퍼티의 새로운 값

예외:

PropertyVetoException - 수취하는 측으로 프로퍼티 변경의 롤백(rollback)를 지정하고 있는 경우

fireVetoableChange

public void fireVetoableChange(String  propertyName,
                               int oldValue,
                               int newValue)
                        throws PropertyVetoException 

등록되어 모든 청취자에게 int 거부 가능 프로퍼티의 갱신을 통지합니다. 낡은 값과 새로운 값이 동일한 경우, 이벤트는 트리거되지 않습니다.

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

파라미터:

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

oldValue - 프로퍼티의 낡은 값

newValue - 프로퍼티의 새로운 값

예외:

PropertyVetoException

fireVetoableChange

public void fireVetoableChange(String  propertyName,
                               boolean oldValue,
                               boolean newValue)
                        throws PropertyVetoException 

등록되어 모든 청취자에게 boolean 거부 가능 프로퍼티의 갱신을 통지합니다. 낡은 값과 새로운 값이 동일한 경우, 이벤트는 트리거되지 않습니다.

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

파라미터:

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

oldValue - 프로퍼티의 낡은 값

newValue - 프로퍼티의 새로운 값

예외:

PropertyVetoException

fireVetoableChange

public void fireVetoableChange(PropertyChangeEvent  evt)
                        throws PropertyVetoException 

등록되어 모든 청취자에 대해서, 거부 가능 프로퍼티의 갱신을 트리거합니다. 변경이 거부되었을 경우는, 모든 것을 낡은 값에 되돌리는 새로운 이벤트를 트리거하고 나서, 재차 PropertyVetoException 를 throw 합니다.

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

파라미터:

evt - 트리거되는 PropertyChangeEvent

예외:

PropertyVetoException - 수취하는 측으로 프로퍼티 변경의 롤백(rollback)를 지정하고 있는 경우

hasListeners

public boolean hasListeners(String  propertyName)

특정의 프로퍼티에 청취자가 있을지 어떨지를 판정합니다. 모든 프로퍼티에 등록된 청취자가 포함됩니다. propertyName 가 null 의 경우는, 모든 프로퍼티으로 등록된 청취자의 체크만을 합니다.

파라미터:

propertyName - 프로퍼티명

반환값:

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