/* * @(#)SolarisPrincipal.java 1.17 04/05/18 * * Copyright 2004 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package com.sun.security.auth; import java.security.Principal; /** *
This class implements the Principal
interface
* and represents a Solaris user.
*
*
Principals such as this SolarisPrincipal
* 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
.
*
* @deprecated As of JDK 1.4, replaced by
* {@link UnixPrincipal}.
* This class is entirely deprecated.
* @version 1.17, 05/18/04
* @see java.security.Principal
* @see javax.security.auth.Subject
*/
@Deprecated
public class SolarisPrincipal implements Principal, java.io.Serializable {
private static final long serialVersionUID = -7840670002439379038L;
private static final java.util.ResourceBundle rb =
(java.util.ResourceBundle)java.security.AccessController.doPrivileged
(new java.security.PrivilegedAction() {
public Object run() {
return (java.util.ResourceBundle.getBundle
("sun.security.util.AuthResources"));
}
});
/**
* @serial
*/
private String name;
/**
* Create a SolarisPrincipal with a Solaris username.
*
*
*
* @param name the Unix username for this user.
*
* @exception NullPointerException if the name
* is null
.
*/
public SolarisPrincipal(String name) {
if (name == null)
throw new NullPointerException(rb.getString("provided null name"));
this.name = name;
}
/**
* Return the Unix username for this SolarisPrincipal
.
*
*
*
* @return the Unix username for this SolarisPrincipal
*/
public String getName() {
return name;
}
/**
* Return a string representation of this SolarisPrincipal
.
*
*
*
* @return a string representation of this SolarisPrincipal
.
*/
public String toString() {
return(rb.getString("SolarisPrincipal: ") + name);
}
/**
* Compares the specified Object with this SolarisPrincipal
* for equality. Returns true if the given object is also a
* SolarisPrincipal
and the two SolarisPrincipals
* have the same username.
*
*
*
* @param o Object to be compared for equality with this
* SolarisPrincipal
.
*
* @return true if the specified Object is equal equal to this
* SolarisPrincipal
.
*/
public boolean equals(Object o) {
if (o == null)
return false;
if (this == o)
return true;
if (!(o instanceof SolarisPrincipal))
return false;
SolarisPrincipal that = (SolarisPrincipal)o;
if (this.getName().equals(that.getName()))
return true;
return false;
}
/**
* Return a hash code for this SolarisPrincipal
.
*
*
*
* @return a hash code for this SolarisPrincipal
.
*/
public int hashCode() {
return name.hashCode();
}
}