SubjectDomainCombiner

extends Object
implements DomainCombiner

java.lang.Object
↳	javax.security.auth.SubjectDomainCombiner

Known Direct Subclasses

JMXSubjectDomainCombiner

Class Overview

A SubjectDomainCombiner updates ProtectionDomains with Principals from the Subject associated with this SubjectDomainCombiner.

Summary

Public Constructors
	SubjectDomainCombiner(Subject subject) Associate the provided `Subject` with this `SubjectDomainCombiner`.

Public Methods
ProtectionDomain[]	combine(ProtectionDomain[] currentDomains, ProtectionDomain[] assignedDomains) Update the relevant ProtectionDomains with the Principals from the `Subject` associated with this `SubjectDomainCombiner`.
Subject	getSubject() Get the `Subject` associated with this `SubjectDomainCombiner`.

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this object.
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
final Class<?>	getClass() Returns the runtime class of this `Object`.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
final void	wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.

From interface java.security.DomainCombiner

Public Constructors

public SubjectDomainCombiner (Subject subject)

Associate the provided Subject with this SubjectDomainCombiner.

Parameters

subject	the `Subject` to be associated with with this `SubjectDomainCombiner`.

Public Methods

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 ProtectionDomain in the currentDomains array. Each new ProtectionDomain instance is created using the CodeSource, Permissions and ClassLoader from the corresponding ProtectionDomain in currentDomains, as well as with the Principals from the Subject associated with this SubjectDomainCombiner.

All of the newly instantiated ProtectionDomains 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.

Parameters

currentDomains	the ProtectionDomains associated with the current execution Thread, up to the most recent privileged `ProtectionDomain`. The ProtectionDomains are are listed in order of execution, with the most recently executing `ProtectionDomain` residing at the beginning of the array. This parameter may be `null` if the current execution Thread has no associated ProtectionDomains.
assignedDomains	the ProtectionDomains inherited from the parent Thread, or the ProtectionDomains from the privileged context, if a call to AccessController.doPrivileged(..., context) had occurred This parameter may be `null` if there were no ProtectionDomains inherited from the parent Thread, or from the privileged context.

Returns

a new array consisting of the updated ProtectionDomains, or null.

public Subject getSubject ()

Get the Subject associated with this SubjectDomainCombiner.

Returns

the Subject associated with this SubjectDomainCombiner, or null if no Subject is associated with this SubjectDomainCombiner.

Throws

SecurityException	if the caller does not have permission to get the `Subject` associated with this `SubjectDomainCombiner`.

Interfaces

Classes

Exceptions

SubjectDomainCombiner

Class Overview

Summary

Public Constructors

public SubjectDomainCombiner (Subject subject)

Parameters

Public Methods

public ProtectionDomain[] combine (ProtectionDomain[] currentDomains, ProtectionDomain[] assignedDomains)

Parameters

Returns

public Subject getSubject ()

Returns

Throws