1. /*

  2.  * @(#)NTSidPrimaryGroupPrincipal.java	1.12 03/01/23

  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 primary group SID.

  13.  *

  14.  * <p> Principals such as this <code>NTSidPrimaryGroupPrincipal</code>

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

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

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

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

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

  20.  *

  21.  * @version 1.12, 01/23/03

  22.  * @see java.security.Principal

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

  24.  */

  25. public class NTSidPrimaryGroupPrincipal extends NTSid {  

  26. 

  27.     /**

  28.      * Create an <code>NTSidPrimaryGroupPrincipal</code> with a Windows NT

  29.      * group SID.

  30.      *

  31.      * <p>

  32.      *

  33.      * @param name the primary Windows NT group SID for this user. <p>

  34.      *

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

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

  37.      */

  38.     public NTSidPrimaryGroupPrincipal(String name) {

  39. 	super(name);

  40.     }

  41.     

  42.     /**

  43.      * Return a string representation of this

  44.      * <code>NTSidPrimaryGroupPrincipal</code>.

  45.      *

  46.      * <p>

  47.      *

  48.      * @return a string representation of this

  49.      *		<code>NTSidPrimaryGroupPrincipal</code>.

  50.      */

  51.     public String toString() {

  52. 	java.text.MessageFormat form = new java.text.MessageFormat

  53. 		(sun.security.util.ResourcesMgr.getString

  54. 			("NTSidPrimaryGroupPrincipal: name",

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

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

  57. 	return form.format(source);

  58.     }

  59.     

  60.     /**

  61.      * Compares the specified Object with this

  62.      * <code>NTSidPrimaryGroupPrincipal</code>

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

  64.      * <code>NTSidPrimaryGroupPrincipal</code> and the two

  65.      * NTSidPrimaryGroupPrincipals have the same SID.

  66.      *

  67.      * <p>

  68.      *

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

  70.      *		<code>NTSidPrimaryGroupPrincipal</code>.

  71.      *

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

  73.      *		<code>NTSidPrimaryGroupPrincipal</code>.

  74.      */

  75.     public boolean equals(Object o) {

  76. 	    if (o == null)

  77. 	        return false;

  78. 

  79.         if (this == o)

  80.             return true;

  81.  

  82.         if (!(o instanceof NTSidPrimaryGroupPrincipal))

  83.             return false;

  84.         

  85.         return super.equals(o);

  86.     }

  87.  

  88. }