1. /*

  2.  * @(#)NTSidDomainPrincipal.java	1.15 03/12/19

  3.  *

  4.  * Copyright 2004 Sun Microsystems, Inc. All rights reserved.

  5.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  6.  */

  7. 

  8. package com.sun.security.auth;

  9. 

  10. /**

  11.  * <p> This class extends <code>NTSid</code>

  12.  * and represents a Windows NT user's domain SID.

  13.  *

  14.  * <p> An NT user only has a domain SID if in fact they are logged

  15.  * into an NT domain.  If the user is logged into a workgroup or

  16.  * just a standalone configuration, they will NOT have a domain SID.

  17.  *

  18.  * <p> Principals such as this <code>NTSidDomainPrincipal</code>

  19.  * may be associated with a particular <code>Subject</code>

  20.  * to augment that <code>Subject</code> with an additional

  21.  * identity.  Refer to the <code>Subject</code> class for more information

  22.  * on how to achieve this.  Authorization decisions can then be based upon

  23.  * the Principals associated with a <code>Subject</code>.

  24.  *

  25.  * @version 1.15, 12/19/03

  26.  * @see java.security.Principal

  27.  * @see javax.security.auth.Subject

  28.  */

  29. public class NTSidDomainPrincipal extends NTSid {  

  30. 

  31.     private static final long serialVersionUID = 5247810785821650912L;

  32. 

  33.     /**

  34.      * Create an <code>NTSidDomainPrincipal</code> with a Windows NT SID.

  35.      *

  36.      * <p>

  37.      *

  38.      * @param name a string version of the Windows NT SID for this

  39.      *			user's domain.<p>

  40.      *

  41.      * @exception NullPointerException if the <code>name</code>

  42.      *                  is <code>null</code>.

  43.      */

  44.     public NTSidDomainPrincipal(String name) {

  45.         super(name);

  46.     }

  47.     

  48.     /**

  49.      * Return a string representation of this <code>NTSidDomainPrincipal</code>.

  50.      *

  51.      * <p>

  52.      *

  53.      * @return a string representation of this

  54.      *		<code>NTSidDomainPrincipal</code>.

  55.      */

  56.     public String toString() {

  57. 	java.text.MessageFormat form = new java.text.MessageFormat

  58. 		(sun.security.util.ResourcesMgr.getString

  59. 			("NTSidDomainPrincipal: name",

  60. 			"sun.security.util.AuthResources"));

  61. 	Object[] source = {getName()};

  62. 	return form.format(source);

  63.     }

  64.     

  65.     /**

  66.      * Compares the specified Object with this <code>NTSidDomainPrincipal</code>

  67.      * for equality.  Returns true if the given object is also a

  68.      * <code>NTSidDomainPrincipal</code> and the two NTSidDomainPrincipals

  69.      * have the same SID.

  70.      *

  71.      * <p>

  72.      *

  73.      * @param o Object to be compared for equality with this

  74.      *		<code>NTSidDomainPrincipal</code>.

  75.      *

  76.      * @return true if the specified Object is equal equal to this

  77.      *		<code>NTSidDomainPrincipal</code>.

  78.      */

  79.     public boolean equals(Object o) {

  80. 	    if (o == null)

  81. 	        return false;

  82. 

  83.         if (this == o)

  84.             return true;

  85.  

  86.         if (!(o instanceof NTSidDomainPrincipal))

  87.             return false;

  88. 

  89.         return super.equals(o);

  90.     }

  91. }