- java.lang.Object
-
- javax.security.auth.SubjectDomainCombiner
-
- All Implemented Interfaces:
DomainCombiner
public class SubjectDomainCombiner extends Object implements DomainCombiner
ASubjectDomainCombinerupdates ProtectionDomains with Principals from theSubjectassociated with thisSubjectDomainCombiner.- Since:
- 1.4
-
-
Constructor Summary
Constructors Constructor Description SubjectDomainCombiner(Subject subject)Associate the providedSubjectwith thisSubjectDomainCombiner.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description ProtectionDomain[]combine(ProtectionDomain[] currentDomains, ProtectionDomain[] assignedDomains)Update the relevant ProtectionDomains with the Principals from theSubjectassociated with thisSubjectDomainCombiner.SubjectgetSubject()Get theSubjectassociated with thisSubjectDomainCombiner.
-
-
-
Constructor Detail
-
SubjectDomainCombiner
public SubjectDomainCombiner(Subject subject)
Associate the providedSubjectwith thisSubjectDomainCombiner.- Parameters:
subject- theSubjectto be associated with with thisSubjectDomainCombiner.
-
-
Method Detail
-
getSubject
public Subject getSubject()
Get theSubjectassociated with thisSubjectDomainCombiner.- Returns:
- the
Subjectassociated with thisSubjectDomainCombiner, ornullif noSubjectis associated with thisSubjectDomainCombiner. - Throws:
SecurityException- if the caller does not have permission to get theSubjectassociated with thisSubjectDomainCombiner.
-
combine
public ProtectionDomain[] combine(ProtectionDomain[] currentDomains, ProtectionDomain[] assignedDomains)
Update the relevant ProtectionDomains with the Principals from theSubjectassociated with thisSubjectDomainCombiner.A new
ProtectionDomaininstance is created for each non-staticProtectionDomain( (staticPermissionsOnly() == false) in thecurrentDomainsarray. Each newProtectionDomaininstance is created using theCodeSource,Permissions andClassLoaderfrom the correspondingProtectionDomainincurrentDomains, as well as with the Principals from theSubjectassociated with thisSubjectDomainCombiner. Static ProtectionDomains are combined as-is and no new instance is created.All of the ProtectionDomains (static and newly instantiated) are combined into a new array. The ProtectionDomains from the
assignedDomainsarray are appended to this new array, and the result is returned.Note that optimizations such as the removal of duplicate ProtectionDomains may have occurred. In addition, caching of ProtectionDomains may be permitted.
- Specified by:
combinein interfaceDomainCombiner- Parameters:
currentDomains- the ProtectionDomains associated with the current execution Thread, up to the most recent privilegedProtectionDomain. The ProtectionDomains are listed in order of execution, with the most recently executingProtectionDomainresiding at the beginning of the array. This parameter may benullif the current execution Thread has no associated ProtectionDomains.assignedDomains- the ProtectionDomains inherited from the parent Thread, or the ProtectionDomains from the privilegedcontext, if a call toAccessController.doPrivileged(..., context)had occurred This parameter may benullif there were no ProtectionDomains inherited from the parent Thread, or from the privilegedcontext.- Returns:
- a new array consisting of the updated ProtectionDomains,
or
null.
-
-