1. /*

  2.  * @(#)BeanContextProxy.java	1.3 01/11/29

  3.  *

  4.  * Copyright 2002 Sun Microsystems, Inc. All rights reserved.

  5.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  6.  */

  7. 

  8. package java.beans.beancontext;

  9. 

  10. /**

  11.  * <p>

  12.  * This interface is implemented by a JavaBean that does not directly have 

  13.  * a BeanContext(Child) associated with it (via implementing that interface or a subinterface thereof), but has a public BeanContext(Child) delegated from it.

  14.  * For example, a subclass of java.awt.Container may have a BeanContext 

  15.  * associated with it that all Component children of that Container shall

  16.  * be contained within.

  17.  * </p>

  18.  * <p>

  19.  * An Object may not implement this interface and the BeanContextChild interface

  20.  * (or any subinterfaces thereof) they are mutually exclusive.

  21.  * </p>

  22.  * <p>

  23.  * Callers of this interface shall examine the return type in order to 

  24.  * obtain a particular subinterface of BeanContextChild as follows:

  25.  * <code>

  26.  * BeanContextChild bcc = o.getBeanContextProxy();

  27.  *

  28.  * if (bcc instanceof BeanContext) {

  29.  * 	// ...

  30.  * }

  31.  * </code>

  32.  * or

  33.  * <code>

  34.  * BeanContextChild bcc = o.getBeanContextProxy();

  35.  * BeanContext      bc  = null;

  36.  *

  37.  * try {

  38.  *     bc = (BeanContext)bcc; 

  39.  * } catch (ClassCastException cce) {

  40.  *     // cast failed, bcc is not an instanceof BeanContext 

  41.  * }

  42.  * </code>

  43.  * </p>

  44.  * <p>

  45.  * The return value is a constant for the lifetime of the implementing

  46.  * instance

  47.  * </p>

  48.  * @author Laurence P. G. Cable

  49.  * @version 1.1

  50.  * @since JDK1.2

  51.  *

  52.  * @seealso java.beans.beancontext.BeanContextChild

  53.  * @seealso java.beans.beancontext.BeanContextChildSupport

  54.  */

  55. 

  56. public interface BeanContextProxy {

  57. 

  58.     /**

  59.      * @return the BeanContextChild (or subinterface) associated with this Object

  60.      */

  61. 

  62.     BeanContextChild getBeanContextProxy();

  63. }