javax.security.auth.x500
public final class X500Principal extends Object implements Principal, Serializable
Modifier and Type | Field and Description |
---|---|
static String |
CANONICAL |
static String |
RFC1779 |
static String |
RFC2253 |
Constructor and Description |
---|
X500Principal(byte[] encoded) |
X500Principal(InputStream encoded) |
X500Principal(String name) |
Modifier and Type | Method and Description |
---|---|
boolean |
equals(Object o)
Determine whether this Object is semantically equal
to another Object.
|
byte[] |
getEncoded() |
String |
getName()
This method returns a
String that names this
Principal . |
String |
getName(String format) |
int |
hashCode()
Get a value that represents this Object, as uniquely as
possible within the confines of an int.
|
String |
toString()
Convert this Object to a human-readable String.
|
public static final String CANONICAL
public static final String RFC1779
public static final String RFC2253
public X500Principal(String name)
public X500Principal(byte[] encoded)
public X500Principal(InputStream encoded)
public int hashCode()
Object
There are some requirements on this method which
subclasses must follow:
a.equals(b)
is true, then
a.hashCode() == b.hashCode()
must be as well.
However, the reverse is not necessarily true, and two
objects may have the same hashcode without being equal.Notice that since hashCode
is used in
Hashtable
and other hashing classes,
a poor implementation will degrade the performance of hashing
(so don't blindly implement it as returning a constant!). Also,
if calculating the hash is time-consuming, a class may consider
caching the results.
The default implementation returns
System.identityHashCode(this)
hashCode
in interface Principal
hashCode
in class Object
Object.equals(Object)
,
System.identityHashCode(Object)
public boolean equals(Object o)
Object
There are some fairly strict requirements on this
method which subclasses must follow:
a.equals(b)
and
b.equals(c)
, then a.equals(c)
must be true as well.a.equals(b)
and
b.equals(a)
must have the same value.a.equals(a)
must
always be true.a.equals(null)
must be false.a.equals(b)
must imply
a.hashCode() == b.hashCode()
.
The reverse is not true; two objects that are not
equal may have the same hashcode, but that has
the potential to harm hashing performance.This is typically overridden to throw a ClassCastException
if the argument is not comparable to the class performing
the comparison, but that is not a requirement. It is legal
for a.equals(b)
to be true even though
a.getClass() != b.getClass()
. Also, it
is typical to never cause a NullPointerException
.
In general, the Collections API (java.util
) use the
equals
method rather than the ==
operator to compare objects. However, IdentityHashMap
is an exception to this rule, for its own good reasons.
The default implementation returns this == o
.
equals
in interface Principal
equals
in class Object
o
- the Object to compare toObject.hashCode()
public byte[] getEncoded()
public String getName()
Principal
String
that names this
Principal
.public String toString()
Object
System.out.println()
and such.
It is typical, but not required, to ensure that this method
never completes abruptly with a RuntimeException
.
This method will be called when performing string
concatenation with this object. If the result is
null
, string concatenation will instead
use "null"
.
The default implementation returns
getClass().getName() + "@" +
Integer.toHexString(hashCode())
.
toString
in interface Principal
toString
in class Object
Object.getClass()
,
Object.hashCode()
,
Class.getName()
,
Integer.toHexString(int)