1. /*

  2.  * @(#)PrivilegedExceptionAction.java	1.6 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.security;

  12. 

  13. 

  14. /**

  15.  * A computation to be performed with privileges enabled, that throws one or

  16.  * more checked exceptions.  The computation is performed by invoking

  17.  * <code>AccessController.doPrivileged</code> on the

  18.  * <code>PrivilegedExceptionAction</code> object.  This interface is

  19.  * used only for computations that throw checked exceptions;

  20.  * computations that do not throw

  21.  * checked exceptions should use <code>PrivilegedAction</code> instead.

  22.  *

  23.  * @see AccessController

  24.  * @see AccessController#doPrivileged(PrivilegedExceptionAction)

  25.  * @see AccessController#doPrivileged(PrivilegedExceptionAction,

  26.  *                                              AccessControlContext)

  27.  * @see PrivilegedAction

  28.  */

  29. 

  30. public interface PrivilegedExceptionAction {

  31.     /**

  32.      * Performs the computation.  This method will be called by

  33.      * <code>AccessController.doPrivileged</code> after enabling privileges.

  34.      *

  35.      * @return a class-dependent value that may represent the results of the

  36.      *	       computation.  Each class that implements

  37.      *	       <code>PrivilegedExceptionAction</code> should document what

  38.      *         (if anything) this value represents.

  39.      * @throws Exception an exceptional condition has occurred.  Each class

  40.      *	       that implements <code>PrivilegedExceptionAction</code> should

  41.      *         document the exceptions that its run method can throw.

  42.      * @see AccessController#doPrivileged(PrivilegedExceptionAction)

  43.      * @see AccessController#doPrivileged(PrivilegedExceptionAction,AccessControlContext)

  44.      */

  45. 

  46.     Object run() throws Exception;

  47. }