java.beans
클래스 Beans

java.lang.Object 
  java.beans.Beans

public class Beans
extends Object 

이 클래스는 몇개의 다목적 bean 제어 메서드를 제공합니다.

생성자 개요

Beans ()

메서드 개요

static Object	getInstanceOf (Object bean, Class <? > targetType) 지정된 bean 로부터, 그 소스 객체의 지정된 타입의 뷰를 나타내는 객체를 취득합니다.
static Object	instantiate (ClassLoader cls, String beanName) JavaBean 인스턴스를 생성합니다.
static Object	instantiate (ClassLoader cls, String beanName, BeanContext beanContext) JavaBean 인스턴스를 생성합니다.
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

생성자 상세

Beans

public Beans()

메서드의 상세

instantiate

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

                                 ClassNotFoundException 

JavaBean 인스턴스를 생성합니다.

파라미터:

cls - bean를 작성해야 할 클래스 로더. 이것이 null인 경우는 시스템 클래스 로더를 사용하는

beanName - 클래스 로더내의 bean 이름. 예를 들어,"sun.beanbox.foobah"

예외:

ClassNotFoundException - 직렬화 된 객체의 클래스가 발견되지 않았던 경우

IOException - 입출력 에러가 발생했을 경우

instantiate

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

                                 ClassNotFoundException 

JavaBean 인스턴스를 생성합니다.

파라미터:

cls - bean를 작성해야 할 클래스 로더. 이것이 null인 경우는 시스템 클래스 로더를 사용하는

beanName - 클래스 로더내의 bean 이름. 예를 들어,"sun.beanbox.foobah"

beanContext - 새로운 bean 상자처가 되는 BeanContext

예외:

ClassNotFoundException - 직렬화 된 객체의 클래스가 발견되지 않았던 경우

IOException - 입출력 에러가 발생했을 경우

instantiate

public static Object  instantiate(ClassLoader  cls,
                                 String  beanName,
                                 BeanContext  beanContext,
                                 AppletInitializer  initializer)
                          throws IOException,

                                 ClassNotFoundException 

bean 인스턴스를 생성합니다.

bean는 클래스 로더에 관계 붙일 수 있었던 이름을 기본으로 작성됩니다. 이 이름은,"a.b.c"와 같이 점으로써 단락지은 이름이 아니면 안됩니다.

Beans 1.0 에서는 이름은 직렬화 된 객체 또는 클래스를 나타낼 수가 있습니다. 장래, 다른 도구가 추가될 가능성이 있습니다. Beans 1.0 에서는 우선 beanName를 직렬화 된 객체로서 처리를 시도해 다음에 클래스명으로서 처리합니다.

beanName를 직렬화 된 객체의 이름으로서 사용하는 경우, 지정된 beanName를 자원 패스명으로 변환해 접미말 ". ser"를 추가합니다. 다음에 그 자원으로부터, 직렬화 된 객체의 로드를 시도합니다.

예를 들어 beanName에 "x.y"가 지정되면, Beans.instantiate는 우선 자원 "x/y.ser" 로부터 직렬화 된 객체의 read를 시도해 실패하면 클래스 "x.y" 로드를 시도해 그 클래스의 인스턴스를 생성합니다.

bean가 java.applet.Applet 아류형인 경우는 특수한 초기화를 합니다. 우선, 디폴트의 AppletStub와 AppletContext가 제공됩니다. 다음에 클래스명으로부터 인스턴스가 생성되면, 애플릿의 "init" 메서드가 호출됩니다 (bean가 직렬화 복원되고 있으면, 이 스텝은 스킵 된다).

애플릿인 bean 에서는 애플릿으로 "start"를 호출하는 것은 호출측의 역할입니다. 올바른 동작을 위해서는 애플릿이 가시 AWT 컨테이너에 추가되고 나서 이 처리를 실시합니다.

beans.instantiate 로 작성한 애플릿은 브라우저내에서 동작하는 애플릿과는 다소 다른 환경에서 동작합니다. 특히, bean 애플릿은 「파라미터」에 액세스 할 수 없기 때문에 파라미터값를 설정하기 위해서 프로퍼티의 get/set 메서드를 제공하는 일이 있습니다. bean 애플릿의 개발자는 bean 애플릿을 JDK appletviewer (레퍼런스 브라우저 환경용) 및 BDK BeanBox (레퍼런스 bean 컨테이너용)로 테스트하는 것을 추천합니다.

파라미터:

cls - bean를 작성해야 할 클래스 로더. 이것이 null인 경우는 시스템 클래스 로더를 사용하는

beanName - 클래스 로더내의 bean 이름. 예를 들어,"sun.beanbox.foobah"

beanContext - 새로운 bean 상자처가 되는 BeanContext

initializer - 새로운 bean AppletInitializer

예외:

ClassNotFoundException - 직렬화 된 객체의 클래스가 발견되지 않았던 경우

IOException - 입출력 에러가 발생했을 경우

getInstanceOf

public static Object  getInstanceOf(Object  bean,
                                   Class <? > targetType)

지정된 bean 로부터, 그 소스 객체의 지정된 타입의 뷰를 나타내는 객체를 취득합니다.

결과는 같은 객체 또는 다른 객체입니다. 요구된 타겟트뷰가 없는 경우는 지정된 bean가 리턴됩니다 .

이 메서드는 Beans 1.0 으로 장래, 보다 유연한 bean 동작을 추가하기 위한 훅으로서 준비되어 있습니다.

파라미터:

bean - 뷰를 얻는 객체

targetType - 얻는 뷰의 타입

isInstanceOf

public static boolean isInstanceOf(Object  bean,
                                   Class <? > targetType)

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 SecurityException 

GUI 조작이 사용 가능한 환경에서 동작하고 있을지 어떨지를 나타냅니다.

이 메서드는 시큐러티를 체크하므로 신뢰할 수 없는 애플릿등으로는 사용할 수 없습니다. 즉, 시큐러티 매니저가 존재하는 경우는 시큐러티 매니저의 checkPropertiesAccess 메서드가 호출됩니다. 이것에 의해 SecurityException가 발생되는 경우가 있습니다.

파라미터:

isGuiAvailable - GUI 조작이 가능한 경우는 true

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPropertiesAccess 메서드가 시스템 프로퍼티의 설정을 허가하지 않는 경우

관련 항목:

SecurityManager.checkPropertiesAccess()