Class Overview
A principal identified by a distinguished name as specified by
 RFC 2253.
 
 After successful authentication, a user Principal
 can be associated with a particular Subject
 to augment that Subject with an additional identity.
 Authorization decisions can then be based upon the
 Principals that are associated with a Subject.
 
 This class is immutable.
 
Summary
| Public Methods | 
|---|
	 
    
        | boolean | equals(Object object) Compares this principal to the specified object. | 
	 
    
        | String | getName() Returns the name originally used to create this principal. | 
	 
    
        | int | hashCode() Computes the hash code for this principal. | 
	 
    
        | String | toString() Creates a string representation of this principal's name in the format
 defined by RFC 2253 . | 
| [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.Principal 
  
   
    
    
	 
    
        | abstract
            
            
            
            
            boolean | equals(Object another) Compares this principal to the specified object. |  
        | abstract
            
            
            
            
            String | getName() Returns the name of this principal. |  
        | abstract
            
            
            
            
            int | hashCode() Returns a hashcode for this principal. |  
        | abstract
            
            
            
            
            String | toString() Returns a string representation of this principal. |  | 
 
Public Constructors
 
    
      
        public 
         
         
         
         
        
      
      LdapPrincipal
      (String name)
    
      
    
      
  Creates an LDAP principal.
      Parameters
      
        
          | name | The principal's string distinguished name. | 
      
   
  
     
 
Public Methods
 
    
      
        public 
         
         
         
         
        boolean
      
      equals
      (Object object)
    
      
    
      
  Compares this principal to the specified object.
      Parameters
      
        
          | object | The object to compare this principal against. | 
      
   
  
      Returns
      - true if they are equal; false otherwise.
 
     
 
 
    
      
        public 
         
         
         
         
        String
      
      getName
      ()
    
      
    
      
  Returns the name originally used to create this principal.
      Returns
      - The principal's string name.
 
     
 
 
    
      
        public 
         
         
         
         
        int
      
      hashCode
      ()
    
      
    
      
  Computes the hash code for this principal.
      Returns
      - The principal's hash code.
 
     
 
 
    
      
        public 
         
         
         
         
        String
      
      toString
      ()
    
      
    
      
  Creates a string representation of this principal's name in the format
 defined by RFC 2253.
 If the name has zero components an empty string is returned.
      Returns
      - The principal's string name.