public class Beans extends Object
- 導入されたバージョン:
- 1.1
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 Beans()
-
メソッドのサマリー
修飾子と型 メソッド 説明 static Object
getInstanceOf(Object bean, Class<?> targetType)
指定されたBeanから、そのソース・オブジェクトの指定されたタイプのビューを表すオブジェクトを取得します。static Object
instantiate(ClassLoader cls, String beanName)
Beanのインスタンスを生成します。static Object
instantiate(ClassLoader cls, String beanName, BeanContext beanContext)
Beanのインスタンスを生成します。static Object
instantiate(ClassLoader cls, String beanName, BeanContext beanContext, AppletInitializer initializer)
非推奨。アプレットAPIは推奨されていないため、instantiate(ClassLoader, String, BeanContext)
を使用することをお勧めします。static boolean
isDesignTime()
デザイン・モードであるかどうかを判定します。static boolean
isGuiAvailable()
BeanがGUIを利用できる環境で動作しているかどうかを判定します。static boolean
isInstanceOf(Object bean, Class<?> targetType)
Beanが、指定されたタイプのターゲットとして表示できるかどうかを判定します。static void
setDesignTime(boolean isDesignTime)
アプリケーション構築環境で動作しているかどうかを示します。static void
setGuiAvailable(boolean isGuiAvailable)
GUI操作が使用可能な環境で動作しているかどうかを示します。
-
コンストラクタの詳細
-
Beans
public Beans()
-
-
メソッドの詳細
-
instantiate
public static Object instantiate(ClassLoader cls, String beanName) throws IOException, ClassNotFoundExceptionBeanのインスタンスを生成します。
- パラメータ:
cls
- Beanの作成元にすべきクラス・ローダー。 これがnullの場合は、システム・クラス・ローダーを使用する。beanName
- クラス・ローダー内のBeanの名前。 たとえば、"sun.beanbox.foobah"- 戻り値:
- JavaBean
- 例外:
ClassNotFoundException
- 直列化されたオブジェクトのクラスが見つからなかった場合。IOException
- 入出力エラーが発生した場合。
-
instantiate
public static Object instantiate(ClassLoader cls, String beanName, BeanContext beanContext) throws IOException, ClassNotFoundExceptionBeanのインスタンスを生成します。
- パラメータ:
cls
- Beanの作成元にすべきクラス・ローダー。 これがnullの場合は、システム・クラス・ローダーを使用する。beanName
- クラス・ローダー内のBeanの名前。 たとえば、"sun.beanbox.foobah"beanContext
- 新しいBeanの入れ子先となるBeanContext- 戻り値:
- JavaBean
- 例外:
ClassNotFoundException
- 直列化されたオブジェクトのクラスが見つからなかった場合。IOException
- 入出力エラーが発生した場合。- 導入されたバージョン:
- 1.2
-
instantiate
@Deprecated(since="9")public static Object instantiate(ClassLoader cls, String beanName, BeanContext beanContext, AppletInitializer initializer) throws IOException, ClassNotFoundException非推奨。アプレットAPIは推奨されていないため、instantiate(ClassLoader, String, BeanContext)
を使用することをお勧めします。 詳細については、「java.appletパッケージのドキュメント」を参照してください。Beanのインスタンスを生成します。Beanは、クラス・ローダーに関係付けられた名前を基に作成されます。 この名前は、「a.b.c」のように点で区切った名前でなければいけません。
Beans 1.0では、名前は、直列化されたオブジェクトまたはクラスを示すことができます。 将来、ほかのメカニズムが追加される可能性があります。 Beans 1.0では、まずbeanNameを直列化されたオブジェクトとして処理を試み、次にクラス名として処理します。
beanNameを直列化されたオブジェクトの名前として使用する場合、指定されたbeanNameをリソース・パス名に変換して接尾辞「.ser」を追加します。 次にそのリソースから、直列化されたオブジェクトのロードを試みます。
たとえば、beanNameに"x.y"が指定されると、Beans.instantiateはまずリソース"x/y.ser"から直列化されたオブジェクトの読込みを試み、失敗したらクラス"x.y"のロードを試みてそのクラスのインスタンスを生成します。
Beanがjava.applet.Appletのサブタイプである場合は、特殊な初期化が行われます。 まず、デフォルトのAppletStubとAppletContextが提供されます。 次にクラス名からインスタンスが生成されると、アプレットの「init」メソッドが呼び出されます。 (Beanが直列化復元されていれば、このステップはスキップされる)。
アプレットであるBeanでは、アプレットで「start」を呼び出すのは呼出し側の役割です。 正しい動作のためには、アプレットが可視AWTコンテナに追加されてからこの処理を行うようにします。
beans.instantiateで作成したアプレットは、ブラウザ内で動作するアプレットとは多少異なる環境で動作します。 特に、Beanアプレットは「パラメータ」にアクセスできないため、パラメータ値を設定するために、プロパティの取得/設定メソッドを提供することがあります。 Beanアプレットの開発者は、BeanアプレットをJDK appletviewer (リファレンス・ブラウザ環境用)およびBDK BeanBox (リファレンスBeanコンテナ用)でテストすることをお薦めします。
- パラメータ:
cls
- Beanの作成元にすべきクラス・ローダー。 これがnullの場合は、システム・クラス・ローダーを使用する。beanName
- クラス・ローダー内のBeanの名前。 たとえば、"sun.beanbox.foobah"beanContext
- 新しいBeanの入れ子先となるBeanContextinitializer
- 新しいBeanのAppletInitializer- 戻り値:
- JavaBean
- 例外:
ClassNotFoundException
- 直列化されたオブジェクトのクラスが見つからなかった場合。IOException
- 入出力エラーが発生した場合。- 導入されたバージョン:
- 1.2
-
getInstanceOf
指定されたBeanから、そのソース・オブジェクトの指定されたタイプのビューを表すオブジェクトを取得します。結果は、同じオブジェクトまたは異なるオブジェクトです。 要求されたターゲット・ビューがない場合は、指定されたBeanが返されます。
このメソッドはBeans 1.0で将来、より柔軟なBean動作を追加するためのフックとして用意されています。
- パラメータ:
bean
- ビューを取得するオブジェクト。targetType
- 取得するビューのタイプ。- 戻り値:
- ソース・オブジェクトの指定されたタイプのビューを表すオブジェクト
-
isInstanceOf
Beanが、指定されたタイプのターゲットとして表示できるかどうかを判定します。 指定されたBeanに対して、Beans.getInstanceofメソッドを使用して、指定されたtargetTypeタイプのビューを表すオブジェクトを取得できる場合は、結果はtrueとなります。- パラメータ:
bean
- ビューを取得するBean。targetType
- 取得するビューのタイプ。- 戻り値:
- 指定されたBeanが指定されたtargetTypeをサポートする場合はtrue。
-
isDesignTime
public static boolean isDesignTime()デザイン・モードであるかどうかを判定します。- 戻り値:
- アプリケーション構築環境で動作している場合はtrue。
- 関連項目:
DesignMode
-
isGuiAvailable
public static boolean isGuiAvailable()BeanがGUIを利用できる環境で動作しているかどうかを判定します。- 戻り値:
- Beanが対話型GUIを利用可能で、ダイアログ・ボックスをポップアップできると考えられる環境で実行されている場合はtrue。通常、ウィンドウのある環境ではtrueであり、サーバー環境の場合またはアプリケーションがバッチ・ジョブの一部として実行されている場合は、falseが返される。
- 関連項目:
Visibility
-
setDesignTime
public static void setDesignTime(boolean isDesignTime) throws SecurityExceptionアプリケーション構築環境で動作しているかどうかを示します。このメソッドは、セキュリティをチェックするので、信頼できないアプレットなどでは使用できません。 つまり、セキュリティ・マネージャがある場合は、その
checkPropertiesAccess
メソッドが呼び出されます。 この結果、SecurityExceptionがスローされることがあります。- パラメータ:
isDesignTime
- アプリケーション構築ツールで動作している場合はtrue。- 例外:
SecurityException
- セキュリティ・マネージャが存在し、そのcheckPropertiesAccess
メソッドがシステム・プロパティの設定を許可しない場合。- 関連項目:
SecurityManager.checkPropertiesAccess()
-
setGuiAvailable
public static void setGuiAvailable(boolean isGuiAvailable) throws SecurityExceptionGUI操作が使用可能な環境で動作しているかどうかを示します。このメソッドは、セキュリティをチェックするので、信頼できないアプレットなどでは使用できません。 つまり、セキュリティ・マネージャがある場合は、その
checkPropertiesAccess
メソッドが呼び出されます。 この結果、SecurityExceptionがスローされることがあります。- パラメータ:
isGuiAvailable
- GUI操作が可能な場合はtrue。- 例外:
SecurityException
- セキュリティ・マネージャが存在し、そのcheckPropertiesAccess
メソッドがシステム・プロパティの設定を許可しない場合。- 関連項目:
SecurityManager.checkPropertiesAccess()
-