1. /*

  2.  * @(#)BeanContextProxy.java	1.7 00/02/02

  3.  *

  4.  * Copyright 1998-2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10. 

  11. package java.beans.beancontext;

  12. 

  13. /**

  14.  * <p>

  15.  * This interface is implemented by a JavaBean that does 

  16.  * not directly have a BeanContext(Child) associated with 

  17.  * it (via implementing that interface or a subinterface thereof), 

  18.  * but has a public BeanContext(Child) delegated from it.

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

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

  21.  * be contained within.

  22.  * </p>

  23.  * <p>

  24.  * An Object may not implement this interface and the 

  25.  * BeanContextChild interface

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

  27.  * </p>

  28.  * <p>

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

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

  31.  * <code>

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

  33.  *

  34.  * if (bcc instanceof BeanContext) {

  35.  * 	// ...

  36.  * }

  37.  * </code>

  38.  * or

  39.  * <code>

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

  41.  * BeanContext      bc  = null;

  42.  *

  43.  * try {

  44.  *     bc = (BeanContext)bcc; 

  45.  * } catch (ClassCastException cce) {

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

  47.  * }

  48.  * </code>

  49.  * </p>

  50.  * <p>

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

  52.  * instance

  53.  * </p>

  54.  * @author Laurence P. G. Cable

  55.  * @version 1.7, 02/02/00

  56.  * @since 1.2

  57.  *

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

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

  60.  */

  61. 

  62. public interface BeanContextProxy {

  63. 

  64.     /**

  65.      * Gets the <code>BeanContextChild</code> (or subinterface) 

  66.      * associated with this object. 

  67.      * @return the <code>BeanContextChild</code> (or subinterface) 

  68.      * associated with this object

  69.      */

  70.     BeanContextChild getBeanContextProxy();

  71. }