< prev index next >

## src/java.base/share/classes/java/security/DomainCombiner.java

Print this page

     60  * of ProtectionDomains and returns a single array containing the updated
     61  * ProtectionDomains.  In the simplest case, the {@code combine}
     62  * method merges the two stacks into one.  In more complex cases,
     63  * the {@code combine} method returns a modified
     64  * stack of ProtectionDomains.  The modification may have added new
     65  * ProtectionDomains, removed certain ProtectionDomains, or simply
     66  * updated existing ProtectionDomains.  Re-ordering and other optimizations
     67  * to the ProtectionDomains are also permitted.  Typically the
     68  * {@code combine} method bases its updates on the information
     69  * encapsulated in the {@code DomainCombiner}.
     70  *
     71  * <p> After the {@code AccessController.getContext} method
     72  * receives the combined stack of ProtectionDomains back from
     73  * the {@code DomainCombiner}, it returns a new
     74  * AccessControlContext that has both the combined ProtectionDomains
     75  * as well as the {@code DomainCombiner}.
     76  *
     77  * @see AccessController
     78  * @see AccessControlContext
     79  * @since 1.3

     80  */

     81 public interface DomainCombiner {
     82
     83     /**
     84      * Modify or update the provided ProtectionDomains.
     85      * ProtectionDomains may be added to or removed from the given
     86      * ProtectionDomains.  The ProtectionDomains may be re-ordered.
     87      * Individual ProtectionDomains may be modified (with a new
     88      * set of Permissions, for example).
     89      *
     90      * @param currentDomains the ProtectionDomains associated with the
     91      *          current execution Thread, up to the most recent
     92      *          privileged {@code ProtectionDomain}.
     93      *          The ProtectionDomains are listed in order of execution,
     94      *          with the most recently executing {@code ProtectionDomain}
     95      *          residing at the beginning of the array. This parameter may
     96      *          be {@code null} if the current execution Thread
     97      *          has no associated ProtectionDomains.
     98      *
     99      * @param assignedDomains an array of inherited ProtectionDomains.
    100      *          ProtectionDomains may be inherited from a parent Thread,
     60  * of ProtectionDomains and returns a single array containing the updated
     61  * ProtectionDomains.  In the simplest case, the {@code combine}
     62  * method merges the two stacks into one.  In more complex cases,
     63  * the {@code combine} method returns a modified
     64  * stack of ProtectionDomains.  The modification may have added new
     65  * ProtectionDomains, removed certain ProtectionDomains, or simply
     66  * updated existing ProtectionDomains.  Re-ordering and other optimizations
     67  * to the ProtectionDomains are also permitted.  Typically the
     68  * {@code combine} method bases its updates on the information
     69  * encapsulated in the {@code DomainCombiner}.
     70  *
     71  * <p> After the {@code AccessController.getContext} method
     72  * receives the combined stack of ProtectionDomains back from
     73  * the {@code DomainCombiner}, it returns a new
     74  * AccessControlContext that has both the combined ProtectionDomains
     75  * as well as the {@code DomainCombiner}.
     76  *
     77  * @see AccessController
     78  * @see AccessControlContext
     79  * @since 1.3
     80  * @deprecated This class is only useful in conjunction with
     81  *       {@linkplain SecurityManager the Security Manager}, which is deprecated
     82  *       and subject to removal in a future release. Consequently, this class
     83  *       is also deprecated and subject to removal. There is no replacement for
     84  *       the Security Manager or this class.
     85  */
     86 @Deprecated(since="17", forRemoval=true)
     87 public interface DomainCombiner {
     88
     89     /**
     90      * Modify or update the provided ProtectionDomains.
     91      * ProtectionDomains may be added to or removed from the given
     92      * ProtectionDomains.  The ProtectionDomains may be re-ordered.
     93      * Individual ProtectionDomains may be modified (with a new
     94      * set of Permissions, for example).
     95      *
     96      * @param currentDomains the ProtectionDomains associated with the
     97      *          current execution Thread, up to the most recent
     98      *          privileged {@code ProtectionDomain}.
     99      *          The ProtectionDomains are listed in order of execution,
    100      *          with the most recently executing {@code ProtectionDomain}
    101      *          residing at the beginning of the array. This parameter may
    102      *          be {@code null} if the current execution Thread
    103      *          has no associated ProtectionDomains.
    104      *
    105      * @param assignedDomains an array of inherited ProtectionDomains.
    106      *          ProtectionDomains may be inherited from a parent Thread,

< prev index next >