1. /*

  2.  * @(#)PrivilegedAction.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.  The computation is

  16.  * performed by invoking <code>AccessController.doPrivileged</code> on the

  17.  * <code>PrivilegedAction</code> object.  This interface is used only for

  18.  * computations that do not throw checked exceptions; computations that

  19.  * throw checked exceptions must use <code>PrivilegedExceptionAction</code>

  20.  * instead.

  21.  *

  22.  * @see AccessController

  23.  * @see AccessController#doPrivileged(PrivilegedAction)

  24.  * @see PrivilegedExceptionAction

  25.  */

  26. 

  27. public interface PrivilegedAction {

  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>PrivilegedAction</code>

  35.      *	       should document what (if anything) this value represents.

  36.      * @see AccessController#doPrivileged(PrivilegedAction)

  37.      * @see AccessController#doPrivileged(PrivilegedAction,

  38.      *                                     AccessControlContext)

  39.      */

  40.     Object run();

  41. }