java.beans.beancontext
類別 BeanContextChildSupport

java.lang.Object
  java.beans.beancontext.BeanContextChildSupport

所有已實作的介面：

BeanContextChild, BeanContextServiceRevokedListener, BeanContextServicesListener, Serializable, EventListener

直接已知子類別：

BeanContextSupport

public class BeanContextChildSupport
extends Object
implements BeanContextChild, BeanContextServicesListener, Serializable

這是一個為實作 BeanContextChild 協議提供支持的一般支持類別。 要為給定的元件實作此介面，可以直接為此類別創建子類別，也可以封裝和委託此類別。

從以下版本開始：

1.2

另請參見：

BeanContext, BeanContextServices, BeanContextChild, 序列化表格

欄位摘要

protected BeanContext	beanContext
BeanContextChild	beanContextChildPeer 在其中巢狀此 BeanContextChild 的 BeanContext。
protected PropertyChangeSupport	pcSupport 與此 BeanContextChildSupport 相關聯的 PropertyChangeSupport。
protected boolean	rejectedSetBCOnce 一個標誌，指示在試圖執行 setBeanContext 操作時，至少已經拋出了一個 PropertyChangeVetoException。
protected VetoableChangeSupport	vcSupport 與此 BeanContextChildSupport 相關聯的 VetoableChangeSupport。

建構子摘要

BeanContextChildSupport()
建構一個 BeanContextChildSupport，其中已經為此類別創建了子類別以便實作 JavaBean 元件自身。

BeanContextChildSupport(BeanContextChild bcc)
建構一個 BeanContextChildSupport，其中 JavaBean 元件自身實作 BeanContextChild 並封裝它，並將該介面委託給此實作

方法摘要

void	addPropertyChangeListener(String name, PropertyChangeListener pcl) 為特定屬性添加一個 PropertyChangeListener。
void	addVetoableChangeListener(String name, VetoableChangeListener vcl) 為特定屬性添加一個 VetoableChangeListener。
void	firePropertyChange(String name, Object oldValue, Object newValue) 向所有已註冊的偵聽器報告綁定 (bound) 屬性更新。
void	fireVetoableChange(String name, Object oldValue, Object newValue) 向所有已註冊的偵聽器報告 vetoable 屬性更新。
BeanContext	getBeanContext() 獲得此 BeanContextChildSupport 的巢狀 BeanContext。
BeanContextChild	getBeanContextChildPeer() 獲得與此 BeanContextChildSupport 相關聯的 BeanContextChild。
protected void	initializeBeanContextResources() 子類別可覆寫此方法來提供它們自己的初始化行為。
boolean	isDelegated() 報告此類別是否是另一個類別的委託。
protected void	releaseBeanContextResources() 子類別可覆寫此方法來提供它們自己的釋放行為。
void	removePropertyChangeListener(String name, PropertyChangeListener pcl) 為特定屬性移除一個 PropertyChangeListener。
void	removeVetoableChangeListener(String name, VetoableChangeListener vcl) 移除一個 VetoableChangeListener。
void	serviceAvailable(BeanContextServiceAvailableEvent bcsae) 可從巢狀 BeanContext 中獲得新的服務。
void	serviceRevoked(BeanContextServiceRevokedEvent bcsre) 由巢狀 BeanContext 提供的服務已經被取消。
void	setBeanContext(BeanContext bc) 設置此 BeanContextChildSupport 的 BeanContext。
boolean	validatePendingSetBeanContext(BeanContext newValue) 從 setBeanContext 調用，以驗證（或相反）巢狀 BeanContext 屬性值中的掛起更改。

從類別 java.lang.Object 繼承的方法

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

欄位詳細資訊

beanContextChildPeer

public BeanContextChild beanContextChildPeer

在其中巢狀此 BeanContextChild 的 BeanContext。

pcSupport

protected PropertyChangeSupport pcSupport

與此 BeanContextChildSupport 相關聯的 PropertyChangeSupport。

vcSupport

protected VetoableChangeSupport vcSupport

與此 BeanContextChildSupport 相關聯的 VetoableChangeSupport。

beanContext

protected transient BeanContext beanContext

rejectedSetBCOnce

protected transient boolean rejectedSetBCOnce

一個標誌，指示在試圖執行 setBeanContext 操作時，至少已經拋出了一個 PropertyChangeVetoException。

建構子詳細資訊

BeanContextChildSupport

public BeanContextChildSupport()

建構一個 BeanContextChildSupport，其中已經為此類別創建了子類別以便實作 JavaBean 元件自身。

BeanContextChildSupport

public BeanContextChildSupport(BeanContextChild bcc)

建構一個 BeanContextChildSupport，其中 JavaBean 元件自身實作 BeanContextChild 並封裝它，並將該介面委託給此實作

方法詳細資訊

setBeanContext

public void setBeanContext(BeanContext bc)
                    throws PropertyVetoException

設置此 BeanContextChildSupport 的 BeanContext。

指定者：

介面 BeanContextChild 中的 setBeanContext

參數：

bc - 分派給 BeanContext 屬性的新值

拋出：

PropertyVetoException - 如果拒絕更改

PropertyVetoException

getBeanContext

public BeanContext getBeanContext()

獲得此 BeanContextChildSupport 的巢狀 BeanContext。

指定者：

介面 BeanContextChild 中的 getBeanContext

返回：

此 BeanContextChildSupport 的巢狀 BeanContext。

addPropertyChangeListener

public void addPropertyChangeListener(String name,
                                      PropertyChangeListener pcl)

為特定屬性添加一個 PropertyChangeListener。可以多次添加同一偵聽器物件。對於每個屬性，該偵聽器被調用的次數與為該屬性添加此偵聽器的次數相同。如果 name 或 pcl 為 null，則不會拋出任何異常並且不執行任何操作。

指定者：

介面 BeanContextChild 中的 addPropertyChangeListener

參數：

name - 要偵聽的屬性的名稱

pcl - 要添加的 PropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(String name,
                                         PropertyChangeListener pcl)

為特定屬性移除一個 PropertyChangeListener。如果將 pcl 多次添加到指定屬性的同一事件源，則在被移除之後，它獲得的通知將減少一次。如果 name 為 null，則不會拋出任何異常並且不執行任何操作。如果 pcl 為 null，或者從不為指定屬性添加 pcl，則不拋出任何異常並且不執行任何操作。

指定者：

介面 BeanContextChild 中的 removePropertyChangeListener

參數：

name - 已被偵聽的屬性的名稱

pcl - 要移除的 PropertyChangeListener

addVetoableChangeListener

public void addVetoableChangeListener(String name,
                                      VetoableChangeListener vcl)

為特定屬性添加一個 VetoableChangeListener。可以多次添加同一偵聽器物件。對於每個屬性，該偵聽器被調用的次數與為該屬性添加此偵聽器的次數相同。如果 name 或 vcl 為 null，則不會拋出任何異常並且不執行任何操作。

指定者：

介面 BeanContextChild 中的 addVetoableChangeListener

參數：

name - 要偵聽的屬性的名稱

vcl - 要添加的 VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(String name,
                                         VetoableChangeListener vcl)

移除一個 VetoableChangeListener。如果將 pcl 多次添加到指定屬性的同一事件源，則在被移除之後，它獲得的通知將減少一次。如果 name 為 null，則不會拋出任何異常並且不執行任何操作。如果 vcl 為 null，或者從不為指定屬性添加 pcl，則不拋出任何異常並且不執行任何操作。

指定者：

介面 BeanContextChild 中的 removeVetoableChangeListener

參數：

name - 已被偵聽的屬性的名稱

vcl - 要移除的 VetoableChangeListener

serviceRevoked

public void serviceRevoked(BeanContextServiceRevokedEvent bcsre)

由巢狀 BeanContext 提供的服務已經被取消。 子類別可以覆寫此方法以便實作自己的行為。

指定者：

介面 BeanContextServiceRevokedListener 中的 serviceRevoked

參數：

bcsre - 由於取消服務而觸發的 BeanContextServiceRevokedEvent

serviceAvailable

public void serviceAvailable(BeanContextServiceAvailableEvent bcsae)

可從巢狀 BeanContext 中獲得新的服務。 子類別可以覆寫此方法以便實作自己的行為。

指定者：

介面 BeanContextServicesListener 中的 serviceAvailable

參數：

bcsae - 由於服務變得可用而觸發的 BeanContextServiceAvailableEvent

getBeanContextChildPeer

public BeanContextChild getBeanContextChildPeer()

獲得與此 BeanContextChildSupport 相關聯的 BeanContextChild。

返回：

此類別的 BeanContextChild 同位體。

isDelegated

public boolean isDelegated()

報告此類別是否是另一個類別的委託。

返回：

true 如果此類別是另一個類別的委託

firePropertyChange

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

向所有已註冊的偵聽器報告綁定 (bound) 屬性更新。如果新屬性和舊屬性相同並且是非 null 的，則不會觸發事件。

參數：

name - 已更改屬性的程式名稱

oldValue - 屬性的舊值

newValue - 屬性的新值

fireVetoableChange

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

向所有已註冊的偵聽器報告 vetoable 屬性更新。如果任何人禁止更改，則觸發一個新的事件，該事件將每個人的屬性還原為舊值，然後再次拋出 PropertyVetoException。

如果新屬性和舊屬性相等並且是非 null 的，則不會觸發事件。

參數：

name - 將更改屬性的程式名稱

oldValue - 屬性的舊值

newValue - 屬性的新值

拋出：

PropertyVetoException - 如果接收方希望回滾屬性更改。

validatePendingSetBeanContext

public boolean validatePendingSetBeanContext(BeanContext newValue)

從 setBeanContext 調用，以驗證（或相反）巢狀 BeanContext 屬性值中的掛起更改。返回 false 將造成 setBeanContext 拋出 PropertyVetoException。

參數：

newValue - 已為 BeanContext 屬性請求的新值

返回：

如果禁止執行更改操作，則返回 true

releaseBeanContextResources

protected void releaseBeanContextResources()

子類別可覆寫此方法來提供它們自己的釋放行為。在調用此方法時，應該釋放此實例從其當前 BeanContext 屬性中獲得的所有資源，因為物件不再巢狀在 BeanContext 中。

initializeBeanContextResources

protected void initializeBeanContextResources()

子類別可覆寫此方法來提供它們自己的初始化行為。在調用此方法時，BeanContextChild 所需的資源應該從當前 BeanContext 中獲得。