Class SubjectDomainCombiner
- java.lang.Object
-
- javax.security.auth.SubjectDomainCombiner
- All Implemented Interfaces:
DomainCombiner
public class SubjectDomainCombiner extends Object implements DomainCombiner
A SubjectDomainCombiner
updates ProtectionDomains with Principals from the Subject
associated with this SubjectDomainCombiner
.
- Since:
- 1.4
Constructor Summary
Constructor | Description |
---|---|
SubjectDomainCombiner(Subject subject) | Associate the provided |
Method Summary
Modifier and Type | Method | Description |
---|---|---|
ProtectionDomain[] | combine(ProtectionDomain[] currentDomains,
ProtectionDomain[] assignedDomains) | Update the relevant ProtectionDomains with the Principals from the |
Subject | getSubject() | Get the |
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Constructor Detail
SubjectDomainCombiner
public SubjectDomainCombiner(Subject subject)
Associate the provided Subject
with this SubjectDomainCombiner
.
- Parameters:
-
subject
- theSubject
to be associated with with thisSubjectDomainCombiner
.
Method Detail
getSubject
public Subject getSubject()
Get the Subject
associated with this SubjectDomainCombiner
.
- Returns:
- the
Subject
associated with thisSubjectDomainCombiner
, ornull
if noSubject
is associated with thisSubjectDomainCombiner
. - Throws:
-
SecurityException
- if the caller does not have permission to get theSubject
associated with thisSubjectDomainCombiner
.
combine
public ProtectionDomain[] combine(ProtectionDomain[] currentDomains, ProtectionDomain[] assignedDomains)
Update the relevant ProtectionDomains with the Principals from the Subject
associated with this SubjectDomainCombiner
.
A new ProtectionDomain
instance is created for each non-static ProtectionDomain
( (staticPermissionsOnly() == false) in the currentDomains
array. Each new ProtectionDomain
instance is created using the CodeSource
, Permission
s and ClassLoader
from the corresponding ProtectionDomain
in currentDomains
, as well as with the Principals from the Subject
associated with this SubjectDomainCombiner
. 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 assignedDomains
array 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:
-
combine
in 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 executingProtectionDomain
residing at the beginning of the array. This parameter may benull
if 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 benull
if there were no ProtectionDomains inherited from the parent Thread, or from the privilegedcontext
. - Returns:
- a new array consisting of the updated ProtectionDomains, or
null
.