java.beans.beancontext
인터페이스 BeanContextChild

기존의 서브 인터페이스의 일람:

BeanContext , BeanContextServices

기존의 구현 클래스의 일람:

BeanContextChildSupport , BeanContextServicesSupport , BeanContextSupport

public interface BeanContextChild

BeanContext 서브 인터페이스에 정의되고 있도록(듯이), 상자가 되어 실행 환경 (문맥)의 참조를 취득하는 것이 필요한 JavaBeans 에는, 이 인터페이스를 구현할 필요가 있습니다.

스펙에 준거해 구현된 BeanContext 는, BeanContextChild 객체 추가의 부작용으로서 이 인터페이스의 setBeanContext() 메소드를 사용해 자신에게로의 참조를 건네줍니다.

BeanContextChild 는, 응답으로서 PropertyVetoedException 를 throw 하는 것에 의해, 상태의 변경을 거부하는 일도 있습니다.

지속성 기구가 다종 다양한 상황에 걸쳐서 BeanContextChild 의 인스턴스로 올바르게 기능하기 위해서, 이 인터페이스를 구현하는 클래스는, 상자가 되어 있는 BeanContext 인스턴스에의 참조, 또는 지정되어 있지 않은 임의의 기구를 개입시켜 BeanContext 로부터 취득된 것 외의 자원을 포함 또는 표현하는 일부 또는 모든 필드나 인스턴스 변수를, 일시적인 것으로 해 정의할 필요가 있습니다.

도입된 버젼:

1.2

관련 항목:

BeanContext , PropertyChangeEvent , PropertyChangeListener , java.beans.PropertyVetoEvent, java.beans.PropertyVetoListener, PropertyVetoException

메소드의 개요

void	addPropertyChangeListener (String name, PropertyChangeListener pcl) 지정된 프로퍼티이 변경이 될 때마다 PropertyChangeEvent 를 수신하기 위해서, 이 BeanContextChild 에 PropertyChangeListener 를 추가합니다.
void	addVetoableChangeListener (String name, VetoableChangeListener vcl) 지정된 프로퍼티이 변경이 될 때마다 이벤트를 수신하기 위해서, 이 BeanContextChild 에 VetoableChangeListener 를 추가합니다.
BeanContext	getBeanContext () 이 BeanContextChild 에 관련한 BeanContext 를 가져옵니다.
void	removePropertyChangeListener (String name, PropertyChangeListener pcl) 이 BeanContextChild 로부터 PropertyChangeListener 를 삭제해, 지정된 프로퍼티이 변경이 되었을 때에 PropertyChangeEvents 를 받지 않게 합니다.
void	removeVetoableChangeListener (String name, VetoableChangeListener vcl) 이 BeanContextChild 로부터 VetoableChangeListener 를 삭제해, 지정된 프로퍼티이 변경이 되었을 때에 이벤트를 받지 않게 합니다.
void	setBeanContext (BeanContext bc) 이 인터페이스를 구현하는 객체입니다.

메소드의 상세

setBeanContext

void setBeanContext(BeanContext  bc)
                    throws PropertyVetoException 

이 인터페이스를 구현하는 객체입니다. 다음의 파라미터를 사용해 java.beans.PropertyChangeEvent 를 트리거합니다. propertyName "beanContext", oldValue (이전에 상자가 되어 있던 BeanContext 인스턴스, 또는 null), newValue (현재 상자가 되어 있는 BeanContext 인스턴스, 또는 null)

이 BeanContextChild 는, 대응하는 예외를 throw 하는 것으로써, 상자가 되어 있는 BeanContext 프로퍼티의 값의 변경을 거부하는 일이 있습니다.

파라미터:

bc - 이 BeanContextChild 에 관련했다 BeanContext

예외:

PropertyVetoException - 지정되었다 BeanContext 의 추가가 거부되었을 경우

PropertyVetoException

getBeanContext

BeanContext  getBeanContext()

이 BeanContextChild 에 관련한 BeanContext 를 가져옵니다.

반환값:

이 BeanContextChild 에 관련했다 BeanContext

addPropertyChangeListener

void addPropertyChangeListener(String  name,
                               PropertyChangeListener  pcl)

지정된 프로퍼티이 변경이 될 때마다 PropertyChangeEvent 를 수신하기 위해서, 이 BeanContextChild 에 PropertyChangeListener 를 추가합니다.

파라미터:

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

pcl - 추가하는 PropertyChangeListener

removePropertyChangeListener

void removePropertyChangeListener(String  name,
                                  PropertyChangeListener  pcl)

이 BeanContextChild 로부터 PropertyChangeListener 를 삭제해, 지정된 프로퍼티이 변경이 되었을 때에 PropertyChangeEvents 를 받지 않게 합니다.

파라미터:

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

pcl - 삭제하는 PropertyChangeListener

addVetoableChangeListener

void addVetoableChangeListener(String  name,
                               VetoableChangeListener  vcl)

지정된 프로퍼티이 변경이 될 때마다 이벤트를 수신하기 위해서, 이 BeanContextChild 에 VetoableChangeListener 를 추가합니다.

파라미터:

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

vcl - 추가하는 VetoableChangeListener

removeVetoableChangeListener

void removeVetoableChangeListener(String  name,
                                  VetoableChangeListener  vcl)

이 BeanContextChild 로부터 VetoableChangeListener 를 삭제해, 지정된 프로퍼티이 변경이 되었을 때에 이벤트를 받지 않게 합니다.

파라미터:

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

vcl - 삭제하는 VetoableChangeListener