jdk/src/share/classes/java/security/AccessController.java
changeset 19828 b4f91bc595fe
parent 18579 b678846778ad
child 21321 923ca53e6572
equal deleted inserted replaced
19827:082c76535c1f 19828:b4f91bc595fe
   277      * exception, it will propagate through this method.
   277      * exception, it will propagate through this method.
   278      *
   278      *
   279      * <p> Note that any DomainCombiner associated with the current
   279      * <p> Note that any DomainCombiner associated with the current
   280      * AccessControlContext will be ignored while the action is performed.
   280      * AccessControlContext will be ignored while the action is performed.
   281      *
   281      *
       
   282      * @param <T> the type of the value returned by the PrivilegedAction's
       
   283      *                  {@code run} method.
       
   284      *
   282      * @param action the action to be performed.
   285      * @param action the action to be performed.
   283      *
   286      *
   284      * @return the value returned by the action's {@code run} method.
   287      * @return the value returned by the action's {@code run} method.
   285      *
   288      *
   286      * @exception NullPointerException if the action is {@code null}
   289      * @exception NullPointerException if the action is {@code null}
   302      * <p> If the action's {@code run} method throws an (unchecked)
   305      * <p> If the action's {@code run} method throws an (unchecked)
   303      * exception, it will propagate through this method.
   306      * exception, it will propagate through this method.
   304      *
   307      *
   305      * <p> This method preserves the current AccessControlContext's
   308      * <p> This method preserves the current AccessControlContext's
   306      * DomainCombiner (which may be null) while the action is performed.
   309      * DomainCombiner (which may be null) while the action is performed.
       
   310      *
       
   311      * @param <T> the type of the value returned by the PrivilegedAction's
       
   312      *                  {@code run} method.
   307      *
   313      *
   308      * @param action the action to be performed.
   314      * @param action the action to be performed.
   309      *
   315      *
   310      * @return the value returned by the action's {@code run} method.
   316      * @return the value returned by the action's {@code run} method.
   311      *
   317      *
   342      * was not created by system code and the caller's {@code ProtectionDomain}
   348      * was not created by system code and the caller's {@code ProtectionDomain}
   343      * has not been granted the {@literal "createAccessControlContext"}
   349      * has not been granted the {@literal "createAccessControlContext"}
   344      * {@link java.security.SecurityPermission}, then the action is performed
   350      * {@link java.security.SecurityPermission}, then the action is performed
   345      * with no permissions.
   351      * with no permissions.
   346      *
   352      *
       
   353      * @param <T> the type of the value returned by the PrivilegedAction's
       
   354      *                  {@code run} method.
   347      * @param action the action to be performed.
   355      * @param action the action to be performed.
   348      * @param context an <i>access control context</i>
   356      * @param context an <i>access control context</i>
   349      *                representing the restriction to be applied to the
   357      *                representing the restriction to be applied to the
   350      *                caller's domain's privileges before performing
   358      *                caller's domain's privileges before performing
   351      *                the specified action.  If the context is
   359      *                the specified action.  If the context is
   375      * {@code AccessControlContext}.
   383      * {@code AccessControlContext}.
   376      * <p>
   384      * <p>
   377      * If the action's {@code run} method throws an (unchecked) exception,
   385      * If the action's {@code run} method throws an (unchecked) exception,
   378      * it will propagate through this method.
   386      * it will propagate through this method.
   379      *
   387      *
       
   388      * @param <T> the type of the value returned by the PrivilegedAction's
       
   389      *                  {@code run} method.
   380      * @param action the action to be performed.
   390      * @param action the action to be performed.
   381      * @param context an <i>access control context</i>
   391      * @param context an <i>access control context</i>
   382      *                representing the restriction to be applied to the
   392      *                representing the restriction to be applied to the
   383      *                caller's domain's privileges before performing
   393      *                caller's domain's privileges before performing
   384      *                the specified action.  If the context is
   394      *                the specified action.  If the context is
   427      * it will propagate through this method.
   437      * it will propagate through this method.
   428      *
   438      *
   429      * <p> This method preserves the current AccessControlContext's
   439      * <p> This method preserves the current AccessControlContext's
   430      * DomainCombiner (which may be null) while the action is performed.
   440      * DomainCombiner (which may be null) while the action is performed.
   431      *
   441      *
       
   442      * @param <T> the type of the value returned by the PrivilegedAction's
       
   443      *                  {@code run} method.
   432      * @param action the action to be performed.
   444      * @param action the action to be performed.
   433      * @param context an <i>access control context</i>
   445      * @param context an <i>access control context</i>
   434      *                representing the restriction to be applied to the
   446      *                representing the restriction to be applied to the
   435      *                caller's domain's privileges before performing
   447      *                caller's domain's privileges before performing
   436      *                the specified action.  If the context is
   448      *                the specified action.  If the context is
   477      * exception, it will propagate through this method.
   489      * exception, it will propagate through this method.
   478      *
   490      *
   479      * <p> Note that any DomainCombiner associated with the current
   491      * <p> Note that any DomainCombiner associated with the current
   480      * AccessControlContext will be ignored while the action is performed.
   492      * AccessControlContext will be ignored while the action is performed.
   481      *
   493      *
       
   494      * @param <T> the type of the value returned by the
       
   495      *                  PrivilegedExceptionAction's {@code run} method.
       
   496      *
   482      * @param action the action to be performed
   497      * @param action the action to be performed
   483      *
   498      *
   484      * @return the value returned by the action's {@code run} method
   499      * @return the value returned by the action's {@code run} method
   485      *
   500      *
   486      * @exception PrivilegedActionException if the specified action's
   501      * @exception PrivilegedActionException if the specified action's
   506      * <p> If the action's {@code run} method throws an <i>unchecked</i>
   521      * <p> If the action's {@code run} method throws an <i>unchecked</i>
   507      * exception, it will propagate through this method.
   522      * exception, it will propagate through this method.
   508      *
   523      *
   509      * <p> This method preserves the current AccessControlContext's
   524      * <p> This method preserves the current AccessControlContext's
   510      * DomainCombiner (which may be null) while the action is performed.
   525      * DomainCombiner (which may be null) while the action is performed.
       
   526      *
       
   527      * @param <T> the type of the value returned by the
       
   528      *                  PrivilegedExceptionAction's {@code run} method.
   511      *
   529      *
   512      * @param action the action to be performed.
   530      * @param action the action to be performed.
   513      *
   531      *
   514      * @return the value returned by the action's {@code run} method
   532      * @return the value returned by the action's {@code run} method
   515      *
   533      *
   583      * was not created by system code and the caller's {@code ProtectionDomain}
   601      * was not created by system code and the caller's {@code ProtectionDomain}
   584      * has not been granted the {@literal "createAccessControlContext"}
   602      * has not been granted the {@literal "createAccessControlContext"}
   585      * {@link java.security.SecurityPermission}, then the action is performed
   603      * {@link java.security.SecurityPermission}, then the action is performed
   586      * with no permissions.
   604      * with no permissions.
   587      *
   605      *
       
   606      * @param <T> the type of the value returned by the
       
   607      *                  PrivilegedExceptionAction's {@code run} method.
   588      * @param action the action to be performed
   608      * @param action the action to be performed
   589      * @param context an <i>access control context</i>
   609      * @param context an <i>access control context</i>
   590      *                representing the restriction to be applied to the
   610      *                representing the restriction to be applied to the
   591      *                caller's domain's privileges before performing
   611      *                caller's domain's privileges before performing
   592      *                the specified action.  If the context is
   612      *                the specified action.  If the context is
   620      * {@code AccessControlContext}.
   640      * {@code AccessControlContext}.
   621      * <p>
   641      * <p>
   622      * If the action's {@code run} method throws an (unchecked) exception,
   642      * If the action's {@code run} method throws an (unchecked) exception,
   623      * it will propagate through this method.
   643      * it will propagate through this method.
   624      *
   644      *
       
   645      * @param <T> the type of the value returned by the
       
   646      *                  PrivilegedExceptionAction's {@code run} method.
   625      * @param action the action to be performed.
   647      * @param action the action to be performed.
   626      * @param context an <i>access control context</i>
   648      * @param context an <i>access control context</i>
   627      *                representing the restriction to be applied to the
   649      *                representing the restriction to be applied to the
   628      *                caller's domain's privileges before performing
   650      *                caller's domain's privileges before performing
   629      *                the specified action.  If the context is
   651      *                the specified action.  If the context is
   674      * it will propagate through this method.
   696      * it will propagate through this method.
   675      *
   697      *
   676      * <p> This method preserves the current AccessControlContext's
   698      * <p> This method preserves the current AccessControlContext's
   677      * DomainCombiner (which may be null) while the action is performed.
   699      * DomainCombiner (which may be null) while the action is performed.
   678      *
   700      *
       
   701      * @param <T> the type of the value returned by the
       
   702      *                  PrivilegedExceptionAction's {@code run} method.
   679      * @param action the action to be performed.
   703      * @param action the action to be performed.
   680      * @param context an <i>access control context</i>
   704      * @param context an <i>access control context</i>
   681      *                representing the restriction to be applied to the
   705      *                representing the restriction to be applied to the
   682      *                caller's domain's privileges before performing
   706      *                caller's domain's privileges before performing
   683      *                the specified action.  If the context is
   707      *                the specified action.  If the context is