FileDocCategorySizeDatePackage
NTSid.javaAPI DocJava SE 5 API3991Fri Aug 26 14:56:14 BST 2005com.sun.security.auth

NTSid

public class NTSid extends Object implements Principal, Serializable

This class implements the Principal interface and represents information about a Windows NT user, group or realm.

Windows NT chooses to represent users, groups and realms (or domains) with not only common names, but also relatively unique numbers. These numbers are called Security IDentifiers, or SIDs. Windows NT also provides services that render these SIDs into string forms. This class represents these string forms.

Principals such as this NTSid 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.

version
1.17, 12/19/03
see
java.security.Principal
see
javax.security.auth.Subject

Fields Summary
private static final long
serialVersionUID
private String
sid
Constructors Summary
public NTSid(String stringSid)
Create an NTSid with a Windows NT SID.

param
stringSid the Windows NT SID.

exception
NullPointerException if the String is null.
exception
IllegalArgumentException if the String has zero length.

    
                                                                          
        
        if (stringSid == null) {
	    java.text.MessageFormat form = new java.text.MessageFormat
		(sun.security.util.ResourcesMgr.getString
			("invalid null input: value",
			"sun.security.util.AuthResources"));
	    Object[] source = {"stringSid"};
            throw new NullPointerException(form.format(source));
	}
        if (stringSid.length() == 0) {
            throw new IllegalArgumentException
		(sun.security.util.ResourcesMgr.getString
			("Invalid NTSid value",
			"sun.security.util.AuthResources"));
	}
        sid = new String(stringSid);
    
Methods Summary
public booleanequals(java.lang.Object o)
Compares the specified Object with this NTSid for equality. Returns true if the given object is also a NTSid and the two NTSids have the same String representation.

param
o Object to be compared for equality with this NTSid.
return
true if the specified Object is equal to this NTSid.

	if (o == null)
	    return false;

        if (this == o)
            return true;
 
        if (!(o instanceof NTSid))
            return false;
        NTSid that = (NTSid)o;

	if (sid.equals(that.sid)) {
	    return true;
	}
	return false;
    
public java.lang.StringgetName()
Return a string version of this NTSid.

return
a string version of this NTSid

        return sid;
    
public inthashCode()
Return a hash code for this NTSid.

return
a hash code for this NTSid.

        return sid.hashCode();
    
public java.lang.StringtoString()
Return a string representation of this NTSid.

return
a string representation of this NTSid.

	java.text.MessageFormat form = new java.text.MessageFormat
		(sun.security.util.ResourcesMgr.getString
			("NTSid: name",
			"sun.security.util.AuthResources"));
	Object[] source = {sid};
	return form.format(source);