类 java.beans.Beans

java.lang.Object
   |
   +----java.beans.Beans

public class Beans

extends Object

该类提供通用 beans 控件方法。

构造子索引

Beans()

方法索引

getInstanceOf(Object, Class)

从给定 bean 中获得表示该资源对象的某个特定视图树的一个对象。

instantiate(ClassLoader, String)

实例化某个 bean。

isDesignTime()

测试是否为设计方式。

isGuiAvailable()

isInstanceOf(Object, Class)

检验一个 bean 是否能视为某个给定目标类型。

setDesignTime(boolean)

用来指示用户是否正在某个应用构造器环境中运行。

setGuiAvailable(boolean)

用来指示用户是否正在某个可用 GUI 交互作用的环境中运行。

构造子

 public Beans()

方法

 public static Object instantiate(ClassLoader cls,
                                  String beanName) throws IOException, ClassNotFoundException

实例化某个 bean。

基于相对于类加载器的某名字上创建 bean 。该名应是点分隔的名字，如“a.b.c”。

在 Beans 1.0 中，给定名能指示一个序列化对象或一个类。将来可以添加其它机制。在 beans 1.0 中首先将 beanName 作为一个序列化对象名，然后作为一个类名。

当使用 beanName 作为序列化对象名时，将给定的 beanName 转换成一个资源路径名并添加结尾“.ser” 的后缀。接着试图从该资源中加载一个序列化对象。

例如, 给定一个“x.y”的 beanName , Beans.instantiate 将首先试着从资源“x/y.ser”中读取一个序列化对象并创建该类的一个实例。

若 bean 是 java.applet.Applet 的一个子类型, 则给定一些特殊的的初始化。首先,提供一个缺省的 AppletStub 和 AppletContext。其次, 若从一个类名实例化来的，则调用 Applet 的“init”方法。(若该 bean 被反序列化了则跳过该步。)

注意对于为 applet 的 bean 来说, 调用 applet 上的“启动”是调用方的责任。正确行为应是把 applet 添加到可见的 AWT 容器之后这样做。

注意通过有点不同的环境内运行的 beans.instantiate 而不是浏览器内运行的 applet 来创建 applet 。特别是 bean applet 不能存取“参数” ,因此期望提供特性获取/设置方法来设置参数值。建议 bean-applet 开发者在 JDK appletviewer (一个参考浏览器环境) 和 BDK BeanBox (一个参考 bean 容器) 上测试其 bean-applet 。

参数：

classLoader - 用于创建 bean 的类加载器。若为 null, 则使用系统加载器。

beanName - 类加载器中的 bean 名。例如“sun.beanbox.foobah”

抛出： ClassNotFoundException

若找不到一个序列化对象的类。

抛出： IOException

如果发生某个 I/O 错误。

 public static Object getInstanceOf(Object bean,
                                    Class targetType)

从给定 bean 中获得表示该资源对象的某个特定视图树的一个对象。

结果可能是相同对象或不同对象。若请求的目标视图不可用，则返回给定 bean 。

Beans 1.0 中提供该方法作为将来允许添加更灵活 bean 行为的钩子。

参数：

obj - 要从中获取视图的 Object 。

targetType - 期望获取的视图类型。

 public static boolean isInstanceOf(Object bean,
                                    Class targetType)

检验一个 bean 是否能视为某个给定目标类型。若能在给定 bean 上使用 Beans.getInstanceof 方法获取某表示特定 targetType 类型视图的对象，则结果为 true。

参数：

bean - 要从中获得一个视图的 bean。

targetType - 期望获取的视图类型。

返回值：

若给定 bean 支持该给定 targetType ，则为“true”。

 public static boolean isDesignTime()

测试是否为设计方式。

返回值：

若用户正在应用构造环境中运行，则为 true 。

 public static boolean isGuiAvailable()

返回值：

若运行在一个 bean 假定交互的 GUI 可用从而该 bean 能弹出对话框等的环境中，则为 true 。在窗口环境中通常返回 true ，在服务器中或一个应用正在作为某批处理作业的一部分运行，则为 false。

 public static void setDesignTime(boolean isDesignTime) throws SecurityException

用来指示用户是否正在某个应用构造器环境中运行。注意应对该方法进行安全检验，例如对不可信的 applet 它是不可用的。

参数：

isDesignTime - 若在应用构造器工具中，则为 true。

 public static void setGuiAvailable(boolean isGuiAvailable) throws SecurityException

用来指示用户是否正在某个可用 GUI 交互环境中运行。注意该方法应进行安全检验，例如对不可信的 applet 它是不可用的。

参数：

isGuiAvailable - 若 GUI 交互为可用的，则为 true。