1. /*

  2.  * @(#)Visibility.java	1.11 00/02/02

  3.  *

  4.  * Copyright 1996-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;

  12. 

  13. /**

  14.  * Under some circumstances a bean may be run on servers where a GUI

  15.  * is not available.  This interface can be used to query a bean to

  16.  * determine whether it absolutely needs a gui, and to advise the

  17.  * bean whether a GUI is available.

  18.  * <p>

  19.  * This interface is for expert developers, and is not needed

  20.  * for normal simple beans.  To avoid confusing end-users we

  21.  * avoid using getXXX setXXX design patterns for these methods.

  22.  */

  23. 

  24. public interface Visibility {

  25. 

  26.     /**

  27.      * Determines whether this bean needs a GUI.

  28.      *

  29.      * @return True if the bean absolutely needs a GUI available in

  30.      *		order to get its work done.

  31.      */

  32.     boolean needsGui();

  33. 

  34.     /**

  35.      * This method instructs the bean that it should not use the Gui.

  36.      */

  37.     void dontUseGui();

  38. 

  39.     /**

  40.      * This method instructs the bean that it is OK to use the Gui.

  41.      */

  42.     void okToUseGui();

  43. 

  44.     /**

  45.      * Determines whether this bean is avoiding using a GUI.

  46.      *

  47.      * @return true if the bean is currently avoiding use of the Gui.

  48.      *   e.g. due to a call on dontUseGui().

  49.      */

  50.     boolean avoidingGui();

  51. 

  52. }