1. /*

  2.  * @(#)Guard.java	1.9 00/02/02

  3.  *

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

  12. 

  13. /**

  14.  * <p> This interface represents a guard, which is an object that is used

  15.  * to protect access to another object.

  16.  *

  17.  * <p>This interface contains a single method, <code>checkGuard</code>,

  18.  * with a single <code>object</code> argument. <code>checkGuard</code> is

  19.  * invoked (by the GuardedObject <code>getObject</code> method)

  20.  * to determine whether or not to allow access to the object.

  21.  *

  22.  * @see GuardedObject

  23.  *

  24.  * @version 1.9 00/02/02

  25.  * @author Roland Schemers

  26.  * @author Li Gong

  27.  */

  28. 

  29. public interface Guard {

  30. 

  31.     /**

  32.      * Determines whether or not to allow access to the guarded object

  33.      * <code>object</code>. Returns silently if access is allowed.

  34.      * Otherwise, throws a SecurityException.

  35.      *

  36.      * @param object the object being protected by the guard.

  37.      *

  38.      * @exception SecurityException if access is denied.

  39.      *

  40.      */

  41.     void checkGuard(Object object) throws SecurityException;

  42. }