Class AccessController

java.lang.Object
java.security.AccessController
@Deprecated(since="17",forRemoval=true)public final classAccessControllerextendsObject
Deprecated, for removal: This API element is subject to removal in a future version.
This class was only useful in conjunction withthe Security Manager, which is no longer supported. There is no replacement for the Security Manager or this class.
AccessController was used with the Security Manager for access control operations and decisions. This feature no longer exists.
Since:
1.2

  • Method Details

    • doPrivileged

      public static <T> T doPrivileged(PrivilegedAction<T> action)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Performs the specified action.

      If the action'srun method throws an (unchecked) exception, it will propagate through this method.

      API Note:
      This method originally performed the specifiedPrivilegedAction with privileges enabled. Running the action with privileges enabled was only useful in conjunction withthe Security Manager, which is no longer supported. This method has been changed to run the action as is, and has equivalent behavior as if there were no Security Manager enabled. There is no replacement for the Security Manager or this method.
      Type Parameters:
      T - the type of the value returned by the PrivilegedAction'srun method
      Parameters:
      action - the action to be performed
      Returns:
      the value returned by the action'srun method
      Throws:
      NullPointerException - if the action isnull
      See Also:

    • doPrivilegedWithCombiner

      public static <T> T doPrivilegedWithCombiner(PrivilegedAction<T> action)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Performs the specified action.

      If the action'srun method throws an (unchecked) exception, it will propagate through this method.

      API Note:
      This method originally performed the specifiedPrivilegedAction with privileges enabled and with the current access control context's domain combiner preserved. Running the action with privileges enabled was only useful in conjunction withthe Security Manager, which is no longer supported. This method has been changed to run the action as is, and has equivalent behavior as if there were no Security Manager enabled. There is no replacement for the Security Manager or this method.
      Type Parameters:
      T - the type of the value returned by the PrivilegedAction'srun method
      Parameters:
      action - the action to be performed
      Returns:
      the value returned by the action'srun method
      Throws:
      NullPointerException - if the action isnull
      Since:
      1.6

    • doPrivileged

      public static <T> T doPrivileged(PrivilegedAction<T> action,AccessControlContext context)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Performs the specified action.

      If the action'srun method throws an (unchecked) exception, it will propagate through this method.

      API Note:
      This method originally performed the specifiedPrivilegedAction with privileges enabled and restricted by the specifiedAccessControlContext. Running the action with privileges enabled was only useful in conjunction withthe Security Manager, which is no longer supported. This method has been changed to run the action as is, and has equivalent behavior as if there were no Security Manager enabled. There is no replacement for the Security Manager or this method.
      Type Parameters:
      T - the type of the value returned by the PrivilegedAction'srun method
      Parameters:
      action - the action to be performed.
      context - ignored
      Returns:
      the value returned by the action'srun method
      Throws:
      NullPointerException - if the action isnull

    • doPrivileged

      public static <T> T doPrivileged(PrivilegedAction<T> action,AccessControlContext context,Permission... perms)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Performs the specified action.

      If the action'srun method throws an (unchecked) exception, it will propagate through this method.

      API Note:
      This method originally performed the specifiedPrivilegedAction with privileges enabled and restricted by the specifiedAccessControlContext and with a privilege scope limited by the specifiedPermission arguments. Running the action with privileges enabled was only useful in conjunction withthe Security Manager, which is no longer supported. This method has been changed to run the action as is, and has equivalent behavior as if there were no Security Manager enabled. There is no replacement for the Security Manager or this method.
      Type Parameters:
      T - the type of the value returned by the PrivilegedAction'srun method
      Parameters:
      action - the action to be performed
      context - ignored
      perms - ignored
      Returns:
      the value returned by the action'srun method
      Throws:
      NullPointerException - if action isnull
      Since:
      1.8

    • doPrivilegedWithCombiner

      public static <T> T doPrivilegedWithCombiner(PrivilegedAction<T> action,AccessControlContext context,Permission... perms)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Performs the specified action.

      If the action'srun method throws an (unchecked) exception, it will propagate through this method.

      API Note:
      This method originally performed the specifiedPrivilegedAction with privileges enabled and restricted by the specifiedAccessControlContext and with a privilege scope limited by the specifiedPermission arguments. This method also originally preserved the current access control context's domain combiner while the action was performed. Running the action with privileges enabled was only useful in conjunction withthe Security Manager, which is no longer supported. This method has been changed to run the action as is, and has equivalent behavior as if there were no Security Manager enabled. There is no replacement for the Security Manager or this method.
      Type Parameters:
      T - the type of the value returned by the PrivilegedAction'srun method
      Parameters:
      action - the action to be performed
      context - ignored
      perms - ignored
      Returns:
      the value returned by the action'srun method
      Throws:
      NullPointerException - if action isnull
      Since:
      1.8

    • doPrivileged

      public static <T> T doPrivileged(PrivilegedExceptionAction<T> action) throwsPrivilegedActionException
      Deprecated, for removal: This API element is subject to removal in a future version.
      Performs the specified action.

      If the action'srun method throws anunchecked exception, it will propagate through this method.

      API Note:
      This method originally performed the specifiedPrivilegedExceptionAction with privileges enabled. Running the action with privileges enabled was only useful in conjunction withthe Security Manager, which is no longer supported. This method has been changed to run the action as is, and has equivalent behavior as if there were no Security Manager enabled. There is no replacement for the Security Manager or this method.
      Type Parameters:
      T - the type of the value returned by the PrivilegedExceptionAction'srun method
      Parameters:
      action - the action to be performed
      Returns:
      the value returned by the action'srun method
      Throws:
      PrivilegedActionException - if the specified action'srun method threw achecked exception
      NullPointerException - if the action isnull

    • doPrivilegedWithCombiner

      public static <T> T doPrivilegedWithCombiner(PrivilegedExceptionAction<T> action) throwsPrivilegedActionException
      Deprecated, for removal: This API element is subject to removal in a future version.
      Performs the specified action.

      If the action'srun method throws anunchecked exception, it will propagate through this method.

      API Note:
      This method originally performed the specifiedPrivilegedExceptionAction with privileges enabled and with the current access control context's domain combiner preserved. Running the action with privileges enabled was only useful in conjunction withthe Security Manager, which is no longer supported. This method has been changed to run the action as is, and has equivalent behavior as if there were no Security Manager enabled. There is no replacement for the Security Manager or this method.
      Type Parameters:
      T - the type of the value returned by the PrivilegedExceptionAction'srun method
      Parameters:
      action - the action to be performed
      Returns:
      the value returned by the action'srun method
      Throws:
      PrivilegedActionException - if the specified action'srun method threw achecked exception
      NullPointerException - if the action isnull
      Since:
      1.6

    • doPrivileged

      public static <T> T doPrivileged(PrivilegedExceptionAction<T> action,AccessControlContext context) throwsPrivilegedActionException
      Deprecated, for removal: This API element is subject to removal in a future version.
      Performs the specified action.

      If the action'srun method throws anunchecked exception, it will propagate through this method.

      API Note:
      This method originally performed the specifiedPrivilegedExceptionAction with privileges enabled and restricted by the specifiedAccessControlContext. Running the action with privileges enabled was only useful in conjunction withthe Security Manager, which is no longer supported. This method has been changed to run the action as is, and has equivalent behavior as if there were no Security Manager enabled. There is no replacement for the Security Manager or this method.
      Type Parameters:
      T - the type of the value returned by the PrivilegedExceptionAction'srun method
      Parameters:
      action - the action to be performed
      context - ignored
      Returns:
      the value returned by the action'srun method
      Throws:
      PrivilegedActionException - if the specified action'srun method threw achecked exception
      NullPointerException - if the action isnull
      See Also:

    • doPrivileged

      public static <T> T doPrivileged(PrivilegedExceptionAction<T> action,AccessControlContext context,Permission... perms) throwsPrivilegedActionException
      Deprecated, for removal: This API element is subject to removal in a future version.
      Performs the specified action.

      If the action'srun method throws an (unchecked) exception, it will propagate through this method.

      API Note:
      This method originally performed the specifiedPrivilegedExceptionAction with privileges enabled and restricted by the specifiedAccessControlContext and with a privilege scope limited by the specifiedPermission arguments. Running the action with privileges enabled was only useful in conjunction withthe Security Manager, which is no longer supported. This method has been changed to run the action as is, and has equivalent behavior as if there were no Security Manager enabled. There is no replacement for the Security Manager or this method.
      Type Parameters:
      T - the type of the value returned by the PrivilegedExceptionAction'srun method
      Parameters:
      action - the action to be performed
      context - ignored
      perms - ignored
      Returns:
      the value returned by the action'srun method
      Throws:
      PrivilegedActionException - if the specified action'srun method threw achecked exception
      NullPointerException - if action isnull
      Since:
      1.8

    • doPrivilegedWithCombiner

      public static <T> T doPrivilegedWithCombiner(PrivilegedExceptionAction<T> action,AccessControlContext context,Permission... perms) throwsPrivilegedActionException
      Deprecated, for removal: This API element is subject to removal in a future version.
      Performs the specified action.

      If the action'srun method throws an (unchecked) exception, it will propagate through this method.

      API Note:
      This method originally performed the specifiedPrivilegedExceptionAction with privileges enabled and restricted by the specifiedAccessControlContext and with a privilege scope limited by the specifiedPermission arguments. This method also preserved the current access control context's domain combiner while the action was performed. Running the action with privileges enabled was only useful in conjunction withthe Security Manager, which is no longer supported. This method has been changed to run the action as is, and has equivalent behavior as if there were no Security Manager enabled. There is no replacement for the Security Manager or this method.
      Type Parameters:
      T - the type of the value returned by the PrivilegedExceptionAction'srun method
      Parameters:
      action - the action to be performed
      context - ignored
      perms - ignored
      Returns:
      the value returned by the action'srun method
      Throws:
      PrivilegedActionException - if the specified action'srun method threw achecked exception
      NullPointerException - if action isnull
      Since:
      1.8

    • getContext

      public static AccessControlContext getContext()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Returns anAccessControlContext where thecheckPermission method always throws anAccessControlException and thegetDomainCombiner method always returnsnull.
      API Note:
      This method originally returned a snapshot of the current calling context, which included the current thread's access control context and any limited privilege scope. This method has been changed to always return an innocuousAccessControlContext that fails all permission checks. This method was only useful in conjunction withthe Security Manager, which is no longer supported. There is no replacement for the Security Manager or this method.
      Returns:
      anAccessControlContext as specified above
      See Also:

    • checkPermission

      public static void checkPermission(Permission perm) throwsAccessControlException
      Deprecated, for removal: This API element is subject to removal in a future version.
      ThrowsAccessControlException.
      API Note:
      This method originally determined whether the access request indicated by the specified permission should be allowed or denied, based on the currentAccessControlContext and security policy. This method has been changed to always throwAccessControlException. This method was only useful in conjunction withthe Security Manager, which is no longer supported. There is no replacement for the Security Manager or this method.
      Parameters:
      perm - ignored
      Throws:
      AccessControlException - always