|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.beans.Beans
このクラスは、いくつかの多目的 bean 制御メソッドを提供します。
コンストラクタの概要 | |
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)
bean のインスタンスを生成します。 |
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 操作が使用可能な環境で動作しているかどうかを示します。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
public Beans()
メソッドの詳細 |
public static Object instantiate(ClassLoader cls, String beanName) throws IOException, ClassNotFoundException
bean のインスタンスを生成します。
beanName
- クラスローダ内の bean の名前。たとえば、"sun.beanbox.foobah"
ClassNotFoundException
- 直列化されたオブジェクトのクラスが見つからなかった場合
IOException
- 入出力エラーが発生した場合public static Object instantiate(ClassLoader cls, String beanName, BeanContext beanContext) throws IOException, ClassNotFoundException
bean のインスタンスを生成します。
beanName
- クラスローダ内の bean の名前。たとえば、"sun.beanbox.foobah"beanContext
- 新しい bean の入れ子先となる BeanContext
ClassNotFoundException
- 直列化されたオブジェクトのクラスが見つからなかった場合
IOException
- 入出力エラーが発生した場合public static Object instantiate(ClassLoader cls, String beanName, BeanContext beanContext, AppletInitializer initializer) throws IOException, ClassNotFoundException
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 アプレットを SDK appletviewer (リファレンスブラウザ環境用) および BDK BeanBox (リファレンス bean コンテナ用) でテストすることをお勧めします。
beanName
- クラスローダ内の bean の名前。たとえば、"sun.beanbox.foobah"beanContext
- 新しい bean の入れ子先となる BeanContextinitializer
- 新しい bean の AppletInitializer
ClassNotFoundException
- 直列化されたオブジェクトのクラスが見つからなかった場合
IOException
- 入出力エラーが発生した場合public static Object getInstanceOf(Object bean, Class targetType)
結果は、同じオブジェクトまたは異なるオブジェクトです。要求されたターゲットビューがない場合は、指定された bean が返されます。
このメソッドは Beans 1.0 で将来、より柔軟な bean 動作を追加するためのフックとして用意されています。
targetType
- 取得するビューのタイプpublic static boolean isInstanceOf(Object bean, Class targetType)
bean
- ビューを取得する beantargetType
- 取得するビューのタイプ
public static boolean isDesignTime()
DesignMode
public static boolean isGuiAvailable()
Visibility
public static void setDesignTime(boolean isDesignTime) throws SecurityException
このメソッドは、セキュリティをチェックするので、信頼できないアプレットなどでは使用できません。つまり、セキュリティマネージャが存在する場合は、セキュリティマネージャの checkPropertiesAccess
メソッドが呼び出されます。これによって、SecurityException がスローされる場合があります。
isDesignTime
- アプリケーション構築ツールで動作している場合は true
SecurityException
- セキュリティマネージャが存在し、セキュリティマネージャの checkPropertiesAccess
メソッドがシステムプロパティの設定を許可しない場合SecurityManager.checkPropertiesAccess()
public static void setGuiAvailable(boolean isGuiAvailable) throws SecurityException
このメソッドは、セキュリティをチェックするので、信頼できないアプレットなどでは使用できません。つまり、セキュリティマネージャが存在する場合は、セキュリティマネージャの checkPropertiesAccess
メソッドが呼び出されます。これによって、SecurityException がスローされる場合があります。
isGuiAvailable
- GUI 操作が可能な場合は true
SecurityException
- セキュリティマネージャが存在し、セキュリティマネージャの checkPropertiesAccess
メソッドがシステムプロパティの設定を許可しない場合SecurityManager.checkPropertiesAccess()
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.