1. /*

  2.  * @(#)PrivilegedExceptionAction.java	1.10 04/05/05

  3.  *

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

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

  6.  */

  7. 

  8. package java.security;

  9. 

  10. 

  11. /**

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

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

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

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

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

  17.  * computations that do not throw

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

  19.  *

  20.  * @see AccessController

  21.  * @see AccessController#doPrivileged(PrivilegedExceptionAction)

  22.  * @see AccessController#doPrivileged(PrivilegedExceptionAction,

  23.  *                                              AccessControlContext)

  24.  * @see PrivilegedAction

  25.  */

  26. 

  27. public interface PrivilegedExceptionAction<T> {

  28.     /**

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

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

  31.      *

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

  33.      *	       computation.  Each class that implements

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

  35.      *         (if anything) this value represents.

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

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

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

  39.      * @see AccessController#doPrivileged(PrivilegedExceptionAction)

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

  41.      */

  42. 

  43.     T run() throws Exception;

  44. }