public final class UUID extends Base implements Comparable, Externalizable, ExternalizableLite, PortableObject
Base.LoggingWriter, Base.StackFrame
Constructor and Description |
---|
UUID()
Generate a UUID.
|
UUID(byte[] ab)
Construct a UUID from a byte array.
|
UUID(DataInput stream)
Construct a UUID from a stream.
|
UUID(long lDatetime,
byte[] abIP,
int nPort,
int nCount)
Build a UUID from its constituent members (advanced constructor).
|
UUID(long lDatetime,
InetAddress addr,
int nPort,
int nCount)
Build a UUID from its constituent members (advanced constructor).
|
UUID(String s)
Construct a UUID from a String.
|
Modifier and Type | Method and Description |
---|---|
int |
compareTo(Object o)
Compares this object with the specified object for order.
|
boolean |
equals(Object o)
Determine if two UUIDs are equal.
|
byte[] |
getAddress()
Determine the internet address of the host that generated the UUID
instance.
|
int |
getCount()
Determine the "counter" portion of the UUID that ensures that two UUIDs
generated at the same exact time by the same process are unique.
|
int |
getPort()
Determine the port portion of the UUID.
|
long |
getTimestamp()
Determine the date/time value that the UUID instance was generated.
|
int |
hashCode()
Determine a hash code for the UUID object.
|
boolean |
isAddressIncluded()
This is true if the IP address is a real IP address.
|
boolean |
isGenerated()
This is true if the UUID was generated, and false if it was built.
|
static void |
main(String[] asArgs)
Allow UUID identifiers to be generated or parsed at the command line.
|
void |
readExternal(DataInput in)
Restore the contents of this object by loading the object's state from
the passed DataInput object.
|
void |
readExternal(ObjectInput in)
Read this object from an ObjectInputStream.
|
void |
readExternal(PofReader in)
Restore the contents of a user type instance by reading its state using
the specified PofReader object.
|
byte[] |
toByteArray()
Convert the UUID to a byte array of 32 bytes.
|
String |
toString()
Convert the UUID to a printable String.
|
void |
writeExternal(DataOutput out)
Save the contents of this object by storing the object's state into
the passed DataOutput object.
|
void |
writeExternal(ObjectOutput out)
Write this object to an ObjectOutputStream.
|
void |
writeExternal(PofWriter out)
Save the contents of a POF user type instance by writing its state using
the specified PofWriter object.
|
azzert, azzert, azzert, azzertFailed, breakLines, breakLines, capitalize, checkNotEmpty, checkNotNull, checkRange, computeSafeWaitTime, decimalValue, dup, dup, ensureBigDecimal, ensureClassLoader, ensureRuntimeException, ensureRuntimeException, equals, equalsDeep, err, err, err, err, err, escape, formatDateTime, getCallerStackFrame, getCommonMonitor, getCommonMonitor, getCommonMonitor, getContextClassLoader, getContextClassLoader, getDeepMessage, getErr, getLastSafeTimeMillis, getLog, getMaxDecDigits, getMaxHexDigits, getOriginalException, getOut, getProcessRandom, getRandom, getRandomBinary, getRandomBinary, getRandomString, getSafeTimeMillis, getStackFrame, getStackFrames, getStackTrace, getStackTrace, getThreadFactory, getTimeZone, getUpTimeMillis, hashCode, hexValue, indentString, indentString, isDecimal, isHex, isLogEcho, isOctal, log, log, log, log, log, makeInteger, makeLong, makeThread, mod, mod, octalValue, out, out, out, out, out, pad, parseBandwidth, parseBandwidth, parseDelimitedString, parseHex, parseHex, parseMemorySize, parseMemorySize, parsePercentage, parseTime, parseTime, parseTimeNanos, parseTimeNanos, printStackTrace, randomize, randomize, randomize, randomize, read, read, read, read, read, read, read, replace, setErr, setLog, setLogEcho, setOut, sleep, toBandwidthString, toBandwidthString, toCharEscape, toCrc, toCrc, toCrc, toCrc, toCrc, toDecString, toDelimitedString, toDelimitedString, toDelimitedString, toDelimitedString, toHex, toHex, toHexDump, toHexEscape, toHexEscape, toHexEscape, toHexEscape, toHexString, toMemorySizeString, toMemorySizeString, toQuotedCharEscape, toQuotedStringEscape, toSqlString, toString, toString, toStringEscape, toUnicodeEscape, trace, trace, trace, trace, trace, trace, trace, trace, trace, truncateString, truncateString, wait
public UUID()
public UUID(long lDatetime, InetAddress addr, int nPort, int nCount)
It is guaranteed that a generated UUID will never equal a built UUID.
lDatetime
- the creation date/time millis portion of the UUIDaddr
- the InetAddress portion of the UUIDnPort
- the port number portion of the UUID; a port number
is 16 bits, but up to 28 bits of data from this value
will be maintained by the UUIDnCount
- the counter portion of the UUIDpublic UUID(long lDatetime, byte[] abIP, int nPort, int nCount)
It is guaranteed that a generated UUID will never equal a built UUID.
lDatetime
- the creation date/time millis portion of the UUIDabIP
- the InetAddress portion of the UUIDnPort
- the port number portion of the UUID; a port number
is 16 bits, but up to 28 bits of data from this value
will be maintained by the UUIDnCount
- the counter portion of the UUIDpublic UUID(String s)
s
- a String as would be returned from UUID.toString()public UUID(byte[] ab)
ab
- a byte array as would be returned from UUID.toByteArray()public UUID(DataInput stream) throws IOException
This is a helper constructor that is just a shorthand for a sequence:
UUID uid = new UUID(); uid.readExternal(stream);
stream
- an object implementing java.io.DataInput that contains
the internal information that a previous UID wroteIOException
- if an error occurs reading from the streampublic static void main(String[] asArgs)
public boolean isGenerated()
public long getTimestamp()
public boolean isAddressIncluded()
public byte[] getAddress()
public int getPort()
public int getCount()
public byte[] toByteArray()
public String toString()
public boolean equals(Object o)
public int compareTo(Object o)
compareTo
in interface Comparable
o
- the Object to be compared.ClassCastException
- if the specified object's type prevents it
from being compared to this Objectpublic int hashCode()
public void readExternal(ObjectInput in) throws IOException
readExternal
in interface Externalizable
in
- the ObjectInputStream to read this object fromIOException
- if an exception occurs reading this objectpublic void writeExternal(ObjectOutput out) throws IOException
writeExternal
in interface Externalizable
out
- the ObjectOutputStream to write this object toIOException
- thrown if an exception occurs writing this objectpublic void readExternal(DataInput in) throws IOException
readExternal
in interface ExternalizableLite
in
- the DataInput stream to read data from in order to restore
the state of this objectIOException
- if an I/O exception occursNotActiveException
- if the object is not in its initial
state, and therefore cannot be deserialized intopublic void writeExternal(DataOutput out) throws IOException
writeExternal
in interface ExternalizableLite
out
- the DataOutput stream to write the state of this object toIOException
- if an I/O exception occurspublic void readExternal(PofReader in) throws IOException
readExternal
in interface PortableObject
in
- the PofReader from which to read the object's stateIOException
- if an I/O error occurspublic void writeExternal(PofWriter out) throws IOException
writeExternal
in interface PortableObject
out
- the PofWriter to which to write the object's stateIOException
- if an I/O error occurs