public class BeanContextSupport extends BeanContextChildSupport implements BeanContext, Serializable, PropertyChangeListener, VetoableChangeListener
このクラスは、BeanContextインタフェースを直接実装するため、この実装をサブクラス化することによって、あるいはほかのインスタンスからこのクラスのインスタンスの特別な委譲を介すことによって使用されることを目的としています。
修飾子と型 | クラスと説明 |
---|---|
protected class |
BeanContextSupport.BCSChild |
protected static class |
BeanContextSupport.BCSIterator
protected finalサブクラス。イテレータをカプセル化しますが、何も行わないremove()メソッドを実装します。
|
修飾子と型 | フィールドと説明 |
---|---|
protected ArrayList |
bcmListeners
protected ArrayList bcmListeners フィールドへのすべてのアクセスはそのオブジェクトに同期されます。 |
protected HashMap |
children
protected HashMap children フィールドへのすべてのアクセスはそのオブジェクトに同期されます。 |
protected boolean |
designTime
このオブジェクトが現在、設計時モードであるかどうかを示すboolean。
|
protected Locale |
locale
BeanContextの現在のロケールです。
|
protected boolean |
okToUseGui
このインスタンスがGUIを描画できるかどうかを示すboolean。
|
beanContext, beanContextChildPeer, pcSupport, rejectedSetBCOnce, vcSupport
globalHierarchyLock
PROPERTYNAME
コンストラクタと説明 |
---|
BeanContextSupport()
ほかのオブジェクトの委譲でないインスタンスを生成します。
|
BeanContextSupport(BeanContext peer)
デフォルトのロケールを使ってインスタンスを生成します。
|
BeanContextSupport(BeanContext peer, Locale lcle)
指定されたロケールを使ってインスタンスを生成します。
|
BeanContextSupport(BeanContext peer, Locale lcle, boolean dtime)
指定されたロケールを使って設計モードでインスタンスを生成します。
|
BeanContextSupport(BeanContext peer, Locale lcle, boolean dTime, boolean visible)
BeanContextSupportのインスタンスを生成します。
|
修飾子と型 | メソッドと説明 |
---|---|
boolean |
add(Object targetChild)
このBeanContext内に子を追加、すなわち入れ子にします。
|
boolean |
addAll(Collection c)
ChildrenのセットにCollectionを追加します(サポートされていない)。実装では、階層のロックおよび「子」のprotectedフィールドについて同期をとる必要があります。
|
void |
addBeanContextMembershipListener(BeanContextMembershipListener bcml)
BeanContextMembershipListenerを追加します。
|
boolean |
avoidingGui()
BeanContextの子がGUIの使用を避けているかどうかを判断するために使われます。
|
protected Iterator |
bcsChildren()
このBeanContextのすべての子のイテレータを返します。
|
protected void |
bcsPreDeserializationHook(ObjectInputStream ois)
defaultReadObject()のあと、子を直列化する前のreadObjectによって呼び出されます。
|
protected void |
bcsPreSerializationHook(ObjectOutputStream oos)
defaultWriteObject()のあと、子を直列化する前のwriteObjectによって呼び出されます。
|
protected void |
childDeserializedHook(Object child, BeanContextSupport.BCSChild bcsc)
新しく直列化復元された子およびBCSChildを使ってreadObjectによって呼び出されます。
|
protected void |
childJustAddedHook(Object child, BeanContextSupport.BCSChild bcsc)
サブクラスはこのメソッドをオーバーライドして、子が追加されて、イベント通知が発生する前に、簡単にadd()セマンティックスを拡張できます。
|
protected void |
childJustRemovedHook(Object child, BeanContextSupport.BCSChild bcsc)
サブクラスはこのメソッドをオーバーライドして、子が削除されて、イベント通知が発生する前に、簡単にremove()セマンティックスを拡張できます。
|
protected static boolean |
classEquals(Class first, Class second)
2つのクラス・オブジェクトまたはそれらの名前が同じかどうかを判定します。
|
void |
clear()
子をクリアします(サポートされていない)。実装では、階層のロックおよび「子」のprotectedフィールドについて同期をとる必要があります。
|
boolean |
contains(Object o)
指定されたオブジェクトが現在このBeanContextの子であるかどうかを判定します。
|
boolean |
containsAll(Collection c)
指定されたCollection内のすべての子がこのBeanContextの子であるかどうかを調べます。
|
boolean |
containsKey(Object o)
指定されたオブジェクトが現在このBeanContextの子であるかどうかを判定します。
|
protected Object[] |
copyChildren()
このBeanContextの子のコピーを取得します。
|
protected BeanContextSupport.BCSChild |
createBCSChild(Object targetChild, Object peer)
サブクラスはこのメソッドをオーバーライドすることにより、セットに子を追加するadd()メソッドやほかのCollectionメソッドをオーバーライドすることなく、Childの独自のサブクラスを挿入することができます。
|
protected void |
deserialize(ObjectInputStream ois, Collection coll)
コレクションを直列化復元するためにreadObjectによって使用されます。
|
void |
dontUseGui()
このインスタンスにGUIを描画できないことを通知します。
|
protected void |
fireChildrenAdded(BeanContextMembershipEvent bcme)
BeanContextMembershipListenerインタフェースのBeanContextshipEventをトリガーします。
|
protected void |
fireChildrenRemoved(BeanContextMembershipEvent bcme)
BeanContextMembershipListenerインタフェースのBeanContextshipEventをトリガーします。
|
BeanContext |
getBeanContextPeer()
このオブジェクトが実装を提供しているBeanContextのインスタンスを取得します。
|
protected static BeanContextChild |
getChildBeanContextChild(Object child)
指定された子のBeanContextChild (存在する場合)を取得します。
|
protected static BeanContextMembershipListener |
getChildBeanContextMembershipListener(Object child)
指定された子のBeanContextMembershipListener (存在する場合)を取得します。
|
protected static PropertyChangeListener |
getChildPropertyChangeListener(Object child)
指定された子のPropertyChangeListener (存在する場合)を取得します。
|
protected static Serializable |
getChildSerializable(Object child)
指定されたChildに関連したSerializable (存在する場合)を取得します。
|
protected static VetoableChangeListener |
getChildVetoableChangeListener(Object child)
指定された子のVetoableChangeListener (存在する場合)を取得します。
|
protected static Visibility |
getChildVisibility(Object child)
指定された子に関連したComponent (存在する場合)を取得します。
|
Locale |
getLocale()
このBeanContextのロケールを取得します。
|
URL |
getResource(String name, BeanContextChild bcc)
java.lang.ClassLoader.getResource() と同じように、このメソッドによってBeanContext 実装で子のComponent とベースとなるClassLoader の間に動作を挿入できます。 |
InputStream |
getResourceAsStream(String name, BeanContextChild bcc)
java.lang.ClassLoader.getResourceAsStream() と同じように、このメソッドによってBeanContext 実装で子のComponent とベースとなるClassLoader の間に動作を挿入できます。 |
protected void |
initialize()
BeanContextSupportインスタンスの過渡状態を初期化するために、コンストラクタおよびreadObjectから呼び出されるprotectedメソッドです。
|
Object |
instantiateChild(String beanName)
instantiateChildメソッドは、Beanを入れ子にしてBeanContextにインスタンスを生成するタスクを単純化するBeanContextの簡易フックです。
|
boolean |
isDesignTime()
このオブジェクトが現在、設計時モードかどうかを報告します。
|
boolean |
isEmpty()
このBeanContextが空かどうかを報告します。
|
boolean |
isSerializing()
このBeanContextは直列化の処理中ですか。
|
Iterator |
iterator()
このBeanContext内で現在入れ子になっているJavaBeanまたはBeanContextのインスタンスをすべて取得します。
|
boolean |
needsGui()
通常、このメソッドは実装側がGUIを必要としているかどうかを判断するために、環境から呼び出されます。
|
void |
okToUseGui()
このインスタンスにGUIを描画できることを通知します。
|
void |
propertyChange(PropertyChangeEvent pce)
サブクラスは、子のプロパティの変更を監視するために包括することがあります。
|
void |
readChildren(ObjectInputStream ois)
このクラスのインスタンスがBeanContextプロトコル(およびそのサブプロトコル)の実装の委譲として使用されるときには、直列化復元の際に「鶏が先か卵が先か」の問題が起こります。
|
boolean |
remove(Object targetChild)
このBeanContextから子を削除します。
|
protected boolean |
remove(Object targetChild, boolean callChildSetBC)
予期しないsetBeanContextあるいはremove()呼出しで削除が行われる場合に使用される内部削除。
|
boolean |
removeAll(Collection c)
指定されたすべての子を削除します(サポートされていない)。実装では、階層のロックおよび「子」のprotectedフィールドについて同期をとる必要があります。
|
void |
removeBeanContextMembershipListener(BeanContextMembershipListener bcml)
BeanContextMembershipListenerを削除します。
|
boolean |
retainAll(Collection c)
指定された子だけを保持します(サポートされていない)。実装では、階層のロックおよび「子」のprotectedフィールドについて同期をとる必要があります。
|
protected void |
serialize(ObjectOutputStream oos, Collection coll)
コレクションを直列化するためにwriteObjectによって使用されます。
|
void |
setDesignTime(boolean dTime)
このBeanContext用に新しい設計時値を設定します。
|
void |
setLocale(Locale newLocale)
このBeanContextのロケールを設定します。
|
int |
size()
このBeanContextで入れ子になった現在の子の個数を取得します。
|
Object[] |
toArray()
このBeanContext内で現在入れ子になっているJavaBeanまたはBeanContextのインスタンスをすべて取得します。
|
Object[] |
toArray(Object[] arry)
arryに含まれる型と一致する、このBeanContextのすべての子を含む配列を取得します。
|
protected boolean |
validatePendingAdd(Object targetChild)
このクラスのサブクラスはこのメソッドをオーバーライドまたは包括して、BeanContextに追加される直前に、BeanContextが子オブジェクトを調べるための検証動作を追加できます。
|
protected boolean |
validatePendingRemove(Object targetChild)
このクラスのサブクラスはこのメソッドをオーバーライドまたは包括して、BeanContextから削除される直前に、BeanContextが子オブジェクトを調べるための検証動作を追加できます。
|
void |
vetoableChange(PropertyChangeEvent pce)
サブクラスは、子の拒否プロパティの変更を監視するために包括することがあります。
|
void |
writeChildren(ObjectOutputStream oos)
このBeanContextのすべての子を直列化するために使用されます。
|
addPropertyChangeListener, addVetoableChangeListener, firePropertyChange, fireVetoableChange, getBeanContext, getBeanContextChildPeer, initializeBeanContextResources, isDelegated, releaseBeanContextResources, removePropertyChangeListener, removeVetoableChangeListener, serviceAvailable, serviceRevoked, setBeanContext, validatePendingSetBeanContext
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
addPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext
equals, hashCode, parallelStream, removeIf, spliterator, stream
protected transient HashMap children
protected HashMap children
フィールドへのすべてのアクセスはそのオブジェクトに同期されます。protected transient ArrayList bcmListeners
protected ArrayList bcmListeners
フィールドへのすべてのアクセスはそのオブジェクトに同期されます。protected Locale locale
protected boolean okToUseGui
protected boolean designTime
public BeanContextSupport(BeanContext peer, Locale lcle, boolean dTime, boolean visible)
peer
- 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnulllcle
- このBeanContextの現在のロケール。lcleがnullの場合は、デフォルトのロケールがBeanContextインスタンスに割り当てられます。dTime
- 初期状態、設計モードの場合はtrue、実行時の場合はfalse。visible
- 初期状態での可視性。Locale.getDefault()
, Locale.setDefault(java.util.Locale)
public BeanContextSupport(BeanContext peer, Locale lcle, boolean dtime)
peer
- 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnulllcle
- このBeanContextの現在のロケール。lcleがnullの場合は、デフォルトのロケールがBeanContextインスタンスに割り当てられます。dtime
- 初期状態、設計モードの場合はtrue、実行時の場合はfalse。Locale.getDefault()
, Locale.setDefault(java.util.Locale)
public BeanContextSupport(BeanContext peer, Locale lcle)
peer
- 実装を提供しているピアBeanContext。このオブジェクトがそれ自身のピアである場合はnulllcle
- このBeanContextの現在のロケール。lcleがnullの場合は、デフォルトのロケールがBeanContextインスタンスに割り当てられます。Locale.getDefault()
, Locale.setDefault(java.util.Locale)
public BeanContextSupport(BeanContext peer)
peer
- 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnullpublic BeanContextSupport()
public BeanContext getBeanContextPeer()
public Object instantiateChild(String beanName) throws IOException, ClassNotFoundException
instantiateChildメソッドは、Beanを入れ子にしてBeanContextにインスタンスを生成するタスクを単純化するBeanContextの簡易フックです。
beanNameパラメータのセマンティックスは、java.beans.Beans.instantiateによって定義されます。
instantiateChild
、インタフェース: BeanContext
beanName
- このBeanContext内でインスタンスを生成するBeanの名前IOException
- Beanの直列化復元中に入出力エラーが発生した場合ClassNotFoundException
- beanNameパラメータによって識別されたクラスが見つからない場合public int size()
size
、インタフェース: Collection
public boolean isEmpty()
isEmpty
、インタフェース: Collection
public boolean contains(Object o)
contains
、インタフェース: Collection
o
- 該当するオブジェクトpublic boolean containsKey(Object o)
o
- 該当するオブジェクトpublic Iterator iterator()
iterator
、インタフェース: Iterable
iterator
、インタフェース: Collection
public Object[] toArray()
toArray
、インタフェース: Collection
public Object[] toArray(Object[] arry)
toArray
、インタフェース: Collection
arry
- 対象となるオブジェクト型の配列。protected BeanContextSupport.BCSChild createBCSChild(Object targetChild, Object peer)
サブクラスはこのメソッドをオーバーライドすることにより、セットに子を追加するadd()メソッドやほかのCollectionメソッドをオーバーライドすることなく、Childの独自のサブクラスを挿入することができます。
targetChild
- 代わりにChildを作成する子peer
- targetChildおよびピアがBeanContextProxyの実装によって関連付けられている場合はピア。戻り値は、コレクション・メソッドをオーバーライドしないChildのサブタイプ固有のサブクラスpublic boolean add(Object targetChild)
java.beans.Beans.instantiate()の副作用として呼び出されます。子オブジェクトを追加する処理が正当でない場合、このメソッドはIllegalStateExceptionをスローします。
add
、インタフェース: Collection
targetChild
- このBeanContext内で入れ子になる子オブジェクトvalidatePendingAdd(java.lang.Object)
public boolean remove(Object targetChild)
remove
、インタフェース: Collection
targetChild
- 削除される子オブジェクトvalidatePendingRemove(java.lang.Object)
protected boolean remove(Object targetChild, boolean callChildSetBC)
targetChild
- 削除されるJavaBean、BeanContext、またはObjectcallChildSetBC
- 子がこのBeanContextの入れ子でなくなったことを通知するべきであると示すために使用される。public boolean containsAll(Collection c)
containsAll
、インタフェース: Collection
c
- 指定されているCollectionCollection.contains(Object)
public boolean addAll(Collection c)
addAll
、インタフェース: Collection
c
- このコレクションに追加される要素を含むコレクションUnsupportedOperationException
がスローされますUnsupportedOperationException
- この実装によって無条件にスローされるCollection.add(Object)
public boolean removeAll(Collection c)
removeAll
、インタフェース: Collection
c
- このコレクションから削除される要素を含むコレクションUnsupportedOperationException
がスローされますUnsupportedOperationException
- この実装によって無条件にスローされるCollection.remove(Object)
, Collection.contains(Object)
public boolean retainAll(Collection c)
retainAll
、インタフェース: Collection
c
- このコレクションで保持される要素を含むコレクションUnsupportedOperationException
がスローされますUnsupportedOperationException
- この実装によって無条件にスローされるCollection.remove(Object)
, Collection.contains(Object)
public void clear()
clear
、インタフェース: Collection
UnsupportedOperationException
- この実装によって無条件にスローされるpublic void addBeanContextMembershipListener(BeanContextMembershipListener bcml)
addBeanContextMembershipListener
、インタフェース: BeanContext
bcml
- 追加されるBeanContextMembershipListenerNullPointerException
- 引数がnullの場合public void removeBeanContextMembershipListener(BeanContextMembershipListener bcml)
removeBeanContextMembershipListener
、インタフェース: BeanContext
bcml
- 削除するBeanContextMembershipListenerNullPointerException
- 引数がnullの場合public InputStream getResourceAsStream(String name, BeanContextChild bcc)
BeanContext
java.lang.ClassLoader.getResourceAsStream()
と同じように、このメソッドによってBeanContext
実装で子のComponent
とベースとなるClassLoader
の間に動作を挿入できます。getResourceAsStream
、インタフェース: BeanContext
name
- リクエストされたリソースの名前。bcc
- リクエストを行う子オブジェクト。NullPointerException
- 引数がnullの場合public URL getResource(String name, BeanContextChild bcc)
BeanContext
java.lang.ClassLoader.getResource()
と同じように、このメソッドによってBeanContext
実装で子のComponent
とベースとなるClassLoader
の間に動作を挿入できます。getResource
、インタフェース: BeanContext
name
- リクエストされたリソースの名前。bcc
- リクエストを行う子オブジェクト。public void setDesignTime(boolean dTime)
setDesignTime
、インタフェース: DesignMode
dTime
- 新規designTime値BeanContext
, BeanContextMembershipListener
, PropertyChangeEvent
public boolean isDesignTime()
isDesignTime
、インタフェース: DesignMode
public void setLocale(Locale newLocale) throws PropertyVetoException
newLocale
- 新規ロケール。newLocaleがnull
の場合、このメソッド呼出しに効果はない。PropertyVetoException
- 新規ロケールが拒否された場合public Locale getLocale()
public boolean needsGui()
通常、このメソッドは実装側がGUIを必要としているかどうかを判断するために、環境から呼び出されます。
ここで使われているアルゴリズムはBeanContextPeerと、現在の子が自身をContainers、Componentsのどちらかを判断するのをテストします。Visibilityを実装している場合は、needsGui()== trueを返します。
needsGui
、インタフェース: Visibility
public void dontUseGui()
dontUseGui
、インタフェース: Visibility
public void okToUseGui()
okToUseGui
、インタフェース: Visibility
public boolean avoidingGui()
avoidingGui
、インタフェース: Visibility
Visibility
public boolean isSerializing()
protected Iterator bcsChildren()
protected void bcsPreSerializationHook(ObjectOutputStream oos) throws IOException
oos
- 直列化中に使用するObjectOutputStream
IOException
- 直列化に失敗した場合protected void bcsPreDeserializationHook(ObjectInputStream ois) throws IOException, ClassNotFoundException
ois
- 直列化復元中に使用するObjectInputStream
IOException
- 直列化復元が失敗した場合ClassNotFoundException
- 必要なクラスが見つからない場合protected void childDeserializedHook(Object child, BeanContextSupport.BCSChild bcsc)
child
- 新たに直列化復元された子bcsc
- 新たに直列化復元されたBCSChildprotected final void serialize(ObjectOutputStream oos, Collection coll) throws IOException
oos
- 直列化中に使用するObjectOutputStreamcoll
- 直列化するCollectionIOException
- 直列化に失敗した場合protected final void deserialize(ObjectInputStream ois, Collection coll) throws IOException, ClassNotFoundException
ois
- 使用するObjectInputStreamcoll
- コレクションIOException
- 直列化復元が失敗した場合ClassNotFoundException
- 必要なクラスが見つからない場合public final void writeChildren(ObjectOutputStream oos) throws IOException
oos
- 直列化中に使用するObjectOutputStreamIOException
- 直列化に失敗した場合public final void readChildren(ObjectInputStream ois) throws IOException, ClassNotFoundException
ois
- 使用するObjectInputStreamIOException
- 直列化復元が失敗した場合ClassNotFoundException
- 必要なクラスが見つからない場合public void vetoableChange(PropertyChangeEvent pce) throws PropertyVetoException
vetoableChange
、インタフェース: VetoableChangeListener
pce
- イベント・ソースと変更されたプロパティを記述したPropertyChangeEvent
オブジェクト。PropertyVetoException
- 受け取り側がプロパティ変更をロールバックすることを望んでいる場合。public void propertyChange(PropertyChangeEvent pce)
propertyChange
、インタフェース: PropertyChangeListener
pce
- イベント・ソースと変更されたプロパティを記述したPropertyChangeEventオブジェクト。protected boolean validatePendingAdd(Object targetChild)
このクラスのサブクラスはこのメソッドをオーバーライドまたは包括して、BeanContextに追加される直前に、BeanContextが子オブジェクトを調べるための検証動作を追加できます。
targetChild
- 代わりにChildを作成する子protected boolean validatePendingRemove(Object targetChild)
このクラスのサブクラスはこのメソッドをオーバーライドまたは包括して、BeanContextから削除される直前に、BeanContextが子オブジェクトを調べるための検証動作を追加できます。
targetChild
- 代わりにChildを作成する子protected void childJustAddedHook(Object child, BeanContextSupport.BCSChild bcsc)
child
- 子bcsc
- BCSChildprotected void childJustRemovedHook(Object child, BeanContextSupport.BCSChild bcsc)
child
- 子bcsc
- BCSChildprotected static final Visibility getChildVisibility(Object child)
child
- 指定された子protected static final Serializable getChildSerializable(Object child)
child
- 指定された子protected static final PropertyChangeListener getChildPropertyChangeListener(Object child)
child
- 指定された子protected static final VetoableChangeListener getChildVetoableChangeListener(Object child)
child
- 指定された子protected static final BeanContextMembershipListener getChildBeanContextMembershipListener(Object child)
child
- 指定された子protected static final BeanContextChild getChildBeanContextChild(Object child)
child
- 指定された子IllegalArgumentException
- 子がBeanContextChildおよびBeanContextProxyの両方を実装している場合protected final void fireChildrenAdded(BeanContextMembershipEvent bcme)
bcme
- トリガーするイベントprotected final void fireChildrenRemoved(BeanContextMembershipEvent bcme)
bcme
- トリガーするイベントprotected void initialize()
protected final Object[] copyChildren()
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.