1. /*

  2.  * @(#)NTSidDomainPrincipal.java	1.13 03/01/27

  3.  *

  4.  * Copyright 2003 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.13, 01/27/03

  26.  * @see java.security.Principal

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

  28.  */

  29. public class NTSidDomainPrincipal extends NTSid {  

  30. 

  31.     /**

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

  33.      *

  34.      * <p>

  35.      *

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

  37.      *			user's domain.<p>

  38.      *

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

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

  41.      */

  42.     public NTSidDomainPrincipal(String name) {

  43.         super(name);

  44.     }

  45.     

  46.     /**

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

  48.      *

  49.      * <p>

  50.      *

  51.      * @return a string representation of this

  52.      *		<code>NTSidDomainPrincipal</code>.

  53.      */

  54.     public String toString() {

  55. 	java.text.MessageFormat form = new java.text.MessageFormat

  56. 		(sun.security.util.ResourcesMgr.getString

  57. 			("NTSidDomainPrincipal: name",

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

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

  60. 	return form.format(source);

  61.     }

  62.     

  63.     /**

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

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

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

  67.      * have the same SID.

  68.      *

  69.      * <p>

  70.      *

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

  72.      *		<code>NTSidDomainPrincipal</code>.

  73.      *

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

  75.      *		<code>NTSidDomainPrincipal</code>.

  76.      */

  77.     public boolean equals(Object o) {

  78. 	    if (o == null)

  79. 	        return false;

  80. 

  81.         if (this == o)

  82.             return true;

  83.  

  84.         if (!(o instanceof NTSidDomainPrincipal))

  85.             return false;

  86. 

  87.         return super.equals(o);

  88.     }

  89. }