Module  java.base
软件包  java.security

Class AccessController


  • public final class AccessController
extends Object

    AccessController类用于访问控制操作和决策。

    更具体地说，AccessController类用于三个目的：

    • 根据当前有效的安全策略来决定是否允许或拒绝对关键系统资源的访问，
    • 将代码标记为“特权”，从而影响随后的访问确定
    • 为了获得当前呼叫上下文的“快照”，可以针对保存的上下文进行来自不同上下文的访问控制决定。

    checkPermission方法确定是否应该授予或拒绝由指定权限指定的访问请求。 以下示例呼叫。 在此示例中， checkPermission将确定是否授予“读取”对“/ temp”目录中名为“testFile”的文件的访问权限。 

      FilePermission perm = new FilePermission("/temp/testFile", "read");
 AccessController.checkPermission(perm);

    如果允许访问请求，则checkPermission返回。 如果被拒绝，则抛出AccessControlException。 如果请求的权限类型不正确或包含无效值，则也可以抛出AccessControlException。 尽可能提供这些信息。 假设当前线程遍历m个呼叫者，按照呼叫者1到呼叫者2到呼叫者m的顺序。 然后调用者m调用了checkPermission方法。 checkPermission方法基于以下算法确定是否授予或拒绝访问： 

       for (int i = m; i > 0; i--) { if (caller i's domain does not have the permission) throw AccessControlException else if (caller i is marked as privileged) { if (a context was specified in the call to doPrivileged) context.checkPermission(permission) if (limited permissions were specified in the call to doPrivileged) { for (each limited permission) { if (the limited permission implies the requested permission) return; } } else return; } } // Next, check the context inherited when the thread was created. // Whenever a new thread is created, the AccessControlContext at // that time is stored and associated with the new thread, as the // "inherited" context. inheritedContext.checkPermission(permission);

    主叫方可以被标记为“特权”（见doPrivileged及以下）。 进行访问控制决定时， checkPermission方法将停止检查是否通过没有上下文参数的doPrivileged呼叫到达被标记为“特权”的doPrivileged （有关上下文参数的信息，请参阅下文）。 如果该呼叫者的域具有指定的权限，并且至少有一个限制许可参数（如果有的话）意味着请求的权限，则不进行进一步的检查，并且checkPermission返回，表示允许请求的访问。 如果该域没有指定的权限，那么会照常抛出异常。 如果来电者的域名具有指定的许可权，但是在调用doPrivileged给出的任何限制权限参数并不暗示权限检查，直到没有更多的呼叫者或其他doPrivileged呼叫与所请求的权限匹配并且正常返回。

    正常使用“特权”功能如下。 如果您不需要从“特权”块中返回值，请执行以下操作： 

       somemethod() { ...normal code here... AccessController.doPrivileged(new PrivilegedAction<Void>() { public Void run() { // privileged code goes here, for example: System.loadLibrary("awt"); return null; // nothing to return } }); ...normal code here... }

    PrivilegedAction是一种具有单一方法的接口，名称为run 。 上面的例子显示了该接口的实现的创建; 提供了run方法的具体实现。 当调用doPrivileged时， doPrivileged PrivilegedAction实现的实例传递给它。 doPrivileged方法在启用权限后从PrivilegedAction实现调用run方法，并返回run方法的返回值作为doPrivileged返回值（在此示例doPrivileged被忽略）。

    如果需要返回值，可以执行以下操作： 

       somemethod() { ...normal code here... String user = AccessController.doPrivileged( new PrivilegedAction<String>() { public String run() { return System.getProperty("user.name"); } }); ...normal code here... }

    如果您的run方法中执行的操作可能会引发“检查”异常（方法的throws子句中列出的异常），则需要使用PrivilegedExceptionAction接口，而不是PrivilegedAction接口： 

       somemethod() throws FileNotFoundException { ...normal code here... try { FileInputStream fis = AccessController.doPrivileged( new PrivilegedExceptionAction<FileInputStream>() { public FileInputStream run() throws FileNotFoundException { return new FileInputStream("someFile"); } }); } catch (PrivilegedActionException e) { // e.getException() should be an instance of FileNotFoundException, // as only "checked" exceptions will be "wrapped" in a // PrivilegedActionException. throw (FileNotFoundException) e.getException(); } ...normal code here... }

    在使用“特权”结构时，请注意*，并始终记住使特权代码部分尽可能小。 您可以通过Permission参数来进一步限制“特权”的范围（见下文）。

    请注意， checkPermission始终在当前正在执行的线程的上下文中执行安全检查。 有时，在特定上下文中应该进行的安全检查实际上需要在不同的上下文（例如，从工作线程中）完成。 为这种情况提供了getContext方法和AccessControlContext类。 getContext方法使用当前调用上下文的“快照”，并将其放置在AccessControlContext对象中，该对象返回。 示例呼叫如下： 

      AccessControlContext acc = AccessController.getContext()

    AccessControlContext本身具有一个checkPermission方法，可以根据其封装的上下文而不是当前执行线程进行访问决策。 因此，不同上下文中的代码可以在先前保存的AccessControlContext对象上调用该方法。 示例呼叫如下： 

      acc.checkPermission(permission)

    还有一些时间，您不知道先验哪些权限来检查上下文。 在这些情况下，您可以使用采用上下文的doPrivileged方法。 您也可以传递额外的Permission参数来限制特权代码的范围。 

       somemethod() { AccessController.doPrivileged(new PrivilegedAction<Object>() { public Object run() { // Code goes here. Any permission checks within this // run method will require that the intersection of the // caller's protection domain and the snapshot's // context have the desired permission. If a requested // permission is not implied by the limiting FilePermission // argument then checking of the thread continues beyond the // caller of doPrivileged. } }, acc, new FilePermission("/temp/*", read)); ...normal code here... }

    传递限制Permission的一个实例的参数AllPermission相当于调用等效doPrivileged而不限制方法Permission参数。 传递Permission的零长度数组将禁用代码权限，以便检查始终超出doPrivileged方法的调用者。

    从以下版本开始：
    1.2
    另请参见：
    AccessControlContext

    • 方法详细信息

      • doPrivilegedWithCombiner

        public static <T> T doPrivilegedWithCombiner​(PrivilegedAction<T> action)
        执行指定的PrivilegedAction启用特权。 该操作是由呼叫者的保护域拥有的所有权限执行的。

        如果动作的run方法抛出（未选中）异常，它将通过此方法传播。

        该方法在执行操作时保留当前的AccessControlContext的DomainCombiner（可能为null）。

        参数类型
        T - PrivilegedAction的 run方法返回的值的类型。
        参数
        action - 要执行的动作。
        结果
        由该操作的 run方法返回的值。
        异常
        NullPointerException - 如果操作是 null
        从以下版本开始：
        1.6
        另请参见：
        doPrivileged(PrivilegedAction) ， DomainCombiner

      • doPrivileged

        public static <T> T doPrivileged​(PrivilegedAction<T> action,
                                 AccessControlContext context)
        执行指定的PrivilegedAction具有启用和限制的特定AccessControlContext 。 该操作是由呼叫者的保护域所拥有的权限与由指定的AccessControlContext表示的域所拥有的权限进行AccessControlContext 。

        如果动作的run方法抛出一个（未经检查的）异常，它将通过此方法传播。

        如果安装了一个安全管理器，并且系统代码未创建指定的AccessControlContext ，并且调用方的ProtectionDomain尚未被授予“createAccessControlContext” SecurityPermission ，那么该操作将在没有权限的情况下执行。

        参数类型
        T - PrivilegedAction的 run方法返回的值的类型。
        参数
        action - 要执行的动作。
        context - 表示在执行指定操作之前应用于调用方域的权限的限制的访问控制上下文 。 如果上下文为null ，则不再应用其他限制。
        结果
        由操作的 run方法返回的值。
        异常
        NullPointerException - 如果动作是 null
        另请参见：
        doPrivileged(PrivilegedAction) ， doPrivileged(PrivilegedExceptionAction,AccessControlContext)

      • doPrivileged

        public static <T> T doPrivileged​(PrivilegedAction<T> action,
                                 AccessControlContext context,
                                 Permission... perms)
        执行指定的PrivilegedAction ，该权限启用并受指定的AccessControlContext限制，特权范围受指定的Permission参数限制。 该行为是由呼叫者的保护域所拥有的权限与由指定的AccessControlContext表示的域所拥有的权限进行AccessControlContext 。

        如果动作的run方法抛出（未选中）异常，它将通过此方法传播。

        如果安装了一个安全管理器，并且没有由系统代码创建指定的AccessControlContext ，并且调用方的ProtectionDomain尚未被授予“createAccessControlContext” SecurityPermission ，则该操作将在没有权限的情况下执行。

        参数类型
        T - PrivilegedAction的 run方法返回的值的类型。
        参数
        action - 要执行的动作。
        context - 表示在执行指定操作之前应用于调用方域的权限的限制的访问控制上下文 。 如果上下文是null ，则不应用附加限制。
        perms - Permission参数，限制了调用者权限的范围。 参数的数量是可变的。
        结果
        由该操作的 run方法返回的值。
        异常
        NullPointerException - 如果动作或 NullPointerException或任何perms元素是 null
        从以下版本开始：
        1.8
        另请参见：
        doPrivileged(PrivilegedAction) ， doPrivileged(PrivilegedExceptionAction,AccessControlContext)

      • doPrivilegedWithCombiner

        public static <T> T doPrivilegedWithCombiner​(PrivilegedAction<T> action,
                                             AccessControlContext context,
                                             Permission... perms)
        执行指定的PrivilegedAction ，启用并受限于指定的AccessControlContext ，并且特权范围受指定的Permission参数限制。 该行为是由呼叫者的保护域所拥有的权限与由指定的AccessControlContext表示的域所拥有的权限进行AccessControlContext 。

        如果动作的run方法抛出（未选中）异常，它将通过此方法传播。

        该方法在执行操作时保留当前的AccessControlContext的DomainCombiner（可能为null）。

        如果安装了安全管理器，并且系统代码未创建指定的AccessControlContext并且未通过调用方的ProtectionDomain授予“createAccessControlContext” SecurityPermission ，则该操作将以无权限执行。

        参数类型
        T - PrivilegedAction的 run方法返回的值的类型。
        参数
        action - 要执行的动作。
        context - 表示在执行指定操作之前应用于调用方域的权限的限制的访问控制上下文 。 如果上下文是null ，则不应用附加限制。
        perms - 限制调用者权限范围的Permission参数。 参数的数量是可变的。
        结果
        由该操作的 run方法返回的值。
        异常
        NullPointerException - 如果动作或perms或任何perms元素是 null
        从以下版本开始：
        1.8
        另请参见：
        doPrivileged(PrivilegedAction) ， doPrivileged(PrivilegedExceptionAction,AccessControlContext) ， DomainCombiner

      • doPrivileged

        public static <T> T doPrivileged​(PrivilegedExceptionAction<T> action,
                                 AccessControlContext context)
                          throws PrivilegedActionException
        执行指定的PrivilegedExceptionAction ，其特权被启用并受指定的AccessControlContext限制。 该操作是由呼叫者的保护域所拥有的权限和由指定的AccessControlContext表示的域拥有的AccessControlContext 。

        如果动作的run方法抛出未经检查的异常，它将通过此方法传播。

        如果安装了安全管理器，并且系统代码未创建指定的AccessControlContext ，并且调用方的ProtectionDomain尚未被授予“createAccessControlContext” SecurityPermission ，则该操作将以无权限执行。

        参数类型
        T - 由PrivilegedExceptionAction的 run方法返回的值的类型。
        参数
        action - 要执行的操作
        context - 表示在执行指定操作之前应用于调用方域的权限的限制的访问控制上下文 。 如果上下文为null ，则不再应用其他限制。
        结果
        由该操作的 run方法返回的值
        异常
        PrivilegedActionException - 如果指定的动作的 run方法抛出一个 被检查的异常
        NullPointerException - 如果动作是 null
        另请参见：
        doPrivileged(PrivilegedAction) ， doPrivileged(PrivilegedAction,AccessControlContext)

      • doPrivileged

        public static <T> T doPrivileged​(PrivilegedExceptionAction<T> action,
                                 AccessControlContext context,
                                 Permission... perms)
                          throws PrivilegedActionException
        执行指定的PrivilegedExceptionAction ，该权限启用并受指定的AccessControlContext限制，特权范围受指定的Permission参数限制。 该操作是由呼叫者的保护域所拥有的权限与由指定的AccessControlContext表示的域所拥有的权限进行AccessControlContext 。

        如果动作的run方法抛出（未检查）异常，它将通过此方法传播。

        如果安装了一个安全管理器，并且系统代码没有创建指定的AccessControlContext ，并且调用者的ProtectionDomain尚未被授予“createAccessControlContext” SecurityPermission ，那么该操作将在没有权限的情况下执行。

        参数类型
        T - PrivilegedExceptionAction的 run方法返回的值的类型。
        参数
        action - 要执行的动作。
        context - 表示在执行指定操作之前应用于调用方域的权限的限制的访问控制上下文 。 如果上下文是null ，则不应用附加限制。
        perms - 限制调用者权限范围的Permission参数。 参数的数量是可变的。
        结果
        该操作返回的值为 run方法。
        异常
        PrivilegedActionException - 如果指定的动作的 run方法抛出一个 被检查的异常
        NullPointerException - 如果动作或perms或任何perms元素是 null
        从以下版本开始：
        1.8
        另请参见：
        doPrivileged(PrivilegedAction) ， doPrivileged(PrivilegedAction,AccessControlContext)

      • doPrivilegedWithCombiner

        public static <T> T doPrivilegedWithCombiner​(PrivilegedExceptionAction<T> action,
                                             AccessControlContext context,
                                             Permission... perms)
                                      throws PrivilegedActionException
        执行指定的PrivilegedExceptionAction具有启用并受指定的AccessControlContext限制的特权，特权范围受指定的Permission参数限制。 该操作是由呼叫者的保护域所拥有的权限与由指定的AccessControlContext表示的域所拥有的权限进行AccessControlContext 。

        如果动作的run方法抛出（未检查）异常，它将通过此方法传播。

        该方法在执行操作时保留当前的AccessControlContext的DomainCombiner（可能为null）。

        如果安装了一个安全管理器，并且没有由系统代码创建指定的AccessControlContext ，并且调用者的ProtectionDomain尚未被授予“createAccessControlContext” SecurityPermission ，则该操作将在没有权限的情况下执行。

        参数类型
        T - 由PrivilegedExceptionAction的 run方法返回的值的类型。
        参数
        action - 要执行的动作。
        context - 表示在执行指定操作之前应用于调用方域的权限的限制的访问控制上下文 。 如果上下文为null ，则不再应用其他限制。
        perms - 限制呼叫者权限范围的Permission参数。 参数的数量是可变的。
        结果
        由该操作的 run方法返回的值。
        异常
        PrivilegedActionException - 如果指定的动作的 run方法抛出一个 被检查的异常
        NullPointerException - 如果动作或 NullPointerException或任何 null元素是 null
        从以下版本开始：
        1.8
        另请参见：
        doPrivileged(PrivilegedAction) ， doPrivileged(PrivilegedAction,AccessControlContext) ， DomainCombiner

      • getContext

        public static AccessControlContext getContext​()
        此方法将获取当前调用上下文的“快照”，其中包括当前Thread的继承的AccessControlContext和任何有限权限范围，并将其放置在AccessControlContext对象中。 然后可以在稍后的点可能在另一个线程中检查该上下文。
        结果
        基于当前上下文的AccessControlContext。
        另请参见：
        AccessControlContext

      • checkPermission

        public static void checkPermission​(Permission perm)
                            throws AccessControlException
        根据当前的AccessControlContext和安全策略确定是否允许或拒绝由指定的权限指定的访问请求。 如果允许访问请求，此方法静默返回，否则抛出AccessControlException。 AccessControlException的getPermission方法返回perm权限对象实例。
        参数
        perm - 请求的权限。
        异常
        AccessControlException - 如果不允许指定的权限，则基于当前的安全策略。
        NullPointerException - if the specified permission is null and is checked based on the security policy currently in effect.