com.ibm.security.auth
Class DomainIDPrincipal

java.lang.Object
  |
  +--com.ibm.security.auth.JAASPrincipal
        |
        +--com.ibm.security.auth.DomainIDPrincipal
All Implemented Interfaces:
java.security.Principal, java.io.Serializable

public class DomainIDPrincipal
extends JAASPrincipal

This class extends the JAASPrincipal class and represents the domain ID the user is currently logged onto. The principal is designed to be used in conjunction with NT domain SID data. The DomainPrincipal class should be used when creating Principals based on recognizable domain names such as "WORKGROUP" or "ibm_dom".

Principals such as this DomainIDPrincipal may be associated with a particular Subject to augment that Subject with an additional identity. Refer to the Subject class for more information on how to achieve this. Authorization decisions can then be based upon the Principals associated with a Subject.

Author:
D. Kent Soper, Andrew Gotte
See Also:
Principal, DomainPrincipal, Subject, Serialized Form

Constructor Summary
java.lang.String)">DomainIDPrincipal(java.lang.String name)
          Create an DomainIDPrincipal using a String representation of the domain.
 
Method Summary
 boolean java.lang.Object)">equals(java.lang.Object o)
          Compares the specified Object with this DomainIDPrincipal for equality.
 java.lang.String toString()
          Return a string representation of this DomainIDPrincipal.
 
Methods inherited from class com.ibm.security.auth.JAASPrincipal
getName, hashCode
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail
java.lang.String)">

DomainIDPrincipal

public DomainIDPrincipal(java.lang.String name)
Create an DomainIDPrincipal using a String representation of the domain.

Parameters:
domain - the domain ID.

Throws:
NullPointerException - if the domain is null.
java.lang.RuntimeException - if the name has zero length.
Method Detail

toString

public java.lang.String toString()
Return a string representation of this DomainIDPrincipal.

Overrides:
toString in class JAASPrincipal
Returns:
a string representation of this DomainIDPrincipal.

java.lang.Object)">

equals

public boolean equals(java.lang.Object o)
Compares the specified Object with this DomainIDPrincipal for equality. Returns true if the given object is also a DomainIDPrincipal and the two DomainIDPrincipals have the same domain ID.

Overrides:
java.lang.Object)">equals in class JAASPrincipal
Parameters:
o - Object to be compared for equality with this DomainIDPrincipal.
Returns:
true if the specified Object is equal to this DomainIDPrincipal.