content/release-doc/current/internals/net/jini/id/Uuid.html - river-site - Git at Google

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <!-- NewPage -->
 <html lang="en">
 <head>
 <!-- Generated by javadoc (1.8.0) on Sun Aug 28 20:42:03 EST 2016 -->
 <title>Uuid (Apache River v3.0.0 API Documentation (internals))</title>
 <meta name="date" content="2016-08-28">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
             parent.document.title="Uuid (Apache River v3.0.0 API Documentation (internals))";
         }
     }
     catch(err) {
     }
 //-->
 var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":9,"i13":10};
 var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
 var tableTab = "tableTab";
 var activeTableTab = "activeTableTab";
 </script>
 <noscript>
 <div>JavaScript is disabled on your browser.</div>
 </noscript>
 <!-- ========= START OF TOP NAVBAR ======= -->
 <div class="topNav"><a name="navbar.top">
 <!--   -->
 </a>
 <div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
 <a name="navbar.top.firstrow">
 <!--   -->
 </a>
 <ul class="navList" title="Navigation">
 <li><a href="../../../overview-summary.html">Overview</a></li>
 <li><a href="package-summary.html">Package</a></li>
 <li class="navBarCell1Rev">Class</li>
 <li><a href="class-use/Uuid.html">Use</a></li>
 <li><a href="package-tree.html">Tree</a></li>
 <li><a href="../../../deprecated-list.html">Deprecated</a></li>
 <li><a href="../../../index-all.html">Index</a></li>
 <li><a href="../../../help-doc.html">Help</a></li>
 </ul>
 </div>
 <div class="subNav">
 <ul class="navList">
 <li><a href="../../../net/jini/id/ReferentUuids.html" title="class in net.jini.id"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
 <li><a href="../../../net/jini/id/UuidFactory.html" title="class in net.jini.id"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
 </ul>
 <ul class="navList">
 <li><a href="../../../index.html?net/jini/id/Uuid.html" target="_top">Frames</a></li>
 <li><a href="Uuid.html" target="_top">No&nbsp;Frames</a></li>
 </ul>
 <ul class="navList" id="allclasses_navbar_top">
 <li><a href="../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
 </ul>
 <div>
 <script type="text/javascript"><!--
   allClassesLink = document.getElementById("allclasses_navbar_top");
   if(window==top) {
     allClassesLink.style.display = "block";
   }
   else {
     allClassesLink.style.display = "none";
   }
   //-->
 </script>
 </div>
 <div>
 <ul class="subNavList">
 <li>Summary:&nbsp;</li>
 <li>Nested&nbsp;|&nbsp;</li>
 <li><a href="#field.summary">Field</a>&nbsp;|&nbsp;</li>
 <li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
 <li><a href="#method.summary">Method</a></li>
 </ul>
 <ul class="subNavList">
 <li>Detail:&nbsp;</li>
 <li><a href="#field.detail">Field</a>&nbsp;|&nbsp;</li>
 <li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
 <li><a href="#method.detail">Method</a></li>
 </ul>
 </div>
 <a name="skip.navbar.top">
 <!--   -->
 </a></div>
 <!-- ========= END OF TOP NAVBAR ========= -->
 <!-- ======== START OF CLASS DATA ======== -->
 <div class="header">
 <div class="subTitle">net.jini.id</div>
 <h2 title="Class Uuid" class="title">Class Uuid</h2>
 </div>
 <div class="contentContainer">
 <ul class="inheritance">
 <li><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
 <li>
 <ul class="inheritance">
 <li>net.jini.id.Uuid</li>
 </ul>
 </li>
 </ul>
 <div class="description">
 <ul class="blockList">
 <li class="blockList">
 <dl>
 <dt>All Implemented Interfaces:</dt>
 <dd><a href="http://docs.oracle.com/javase/6/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</a></dd>
 </dl>
 <dl>
 <dt>Direct Known Subclasses:</dt>
 <dd><a href="../../../net/jini/id/UuidFactory.Impl.html" title="class in net.jini.id">UuidFactory.Impl</a></dd>
 </dl>
 <hr>
 <br>
 <pre>public class <span class="typeNameLabel">Uuid</span>
 extends <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>
 implements <a href="http://docs.oracle.com/javase/6/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</a></pre>
 <div class="block">A 128-bit value to serve as a universally unique identifier.  Two
  <code>Uuid</code>s are equal if they have the same 128-bit value.
  <code>Uuid</code> instances can be created using the static methods
  of the <a href="../../../net/jini/id/UuidFactory.html" title="class in net.jini.id"><code>UuidFactory</code></a> class.

  <p>The design of this class is intended to support the use of
  universally unique identifiers that

  <ol>
  <li>have a high likelihood of uniqueness over space and time and
  <li>are computationally difficult to guess.
  </ol>

  The second goal is intended to support the treatment of data
  containing a <code>Uuid</code> as a capability.  Note that not all
  defined <code>Uuid</code> values imply a generation algorithm that
  supports this goal.

  <p>The most significant 64 bits of the value can be decomposed into
  unsigned integer fields according to the following bit masks:

  <pre>
  0xFFFFFFFF00000000     time_low
  0x00000000FFFF0000     time_mid
  0x000000000000F000     version
  0x0000000000000FFF     time_hi
  </pre>

  <p>The least significant 64 bits of the value can be decomposed
  into unsigned integer fields according to the following bit masks:

  <pre>
  0xC000000000000000     variant
  0x3FFF000000000000     clock_seq
  0x0000FFFFFFFFFFFF     node
  </pre>

  <p>This specification defines the meaning (and implies aspects of
  the generation algorithm) of <code>Uuid</code> values if the
  variant field is <code>0x2</code> and the <code>version</code>
  field is either <code>0x1</code> or <code>0x4</code>.

  <p>If the <code>version</code> field is <code>0x1</code>, then

  <ul>

  <li>the <code>time_low</code>, <code>time_mid</code>, and
  <code>time_hi</code> fields are the least, middle, and most
  significant bits (respectively) of a 60-bit timestamp of
  100-nanosecond intervals since midnight, October 15, 1582 UTC,

  <li>the <code>clock_seq</code> field is a 14-bit number chosen to
  help avoid duplicate <code>Uuid</code> values in the event of a
  changed node address or a backward system clock adjustment (such as
  a random number when in doubt, or the previously used number
  incremented by one if just a backward clock adjustment is
  detected), and

  <li>the <code>node</code> field is an IEEE 802 address (a 48-bit
  value).

  <p>As an alternative to an IEEE 802 address (such as if one is not
  available to the generation algorithm), the <code>node</code> field
  may also be a 48-bit number for which the most significant bit is
  set to <code>1</code> and the remaining bits were produced from a
  cryptographically strong random sequence.

  </ul>

  <p>If the <code>version</code> field is <code>0x4</code>, then the
  <code>time_low</code>, <code>time_mid</code>, <code>time_hi</code>,
  <code>clock_seq</code>, and <code>node</code> fields are values
  that were produced from a cryptographically strong random sequence.

  <p>Only <code>Uuid</code> values with a <code>version</code> field
  of <code>0x4</code> are considered computationally difficult to
  guess.  A <code>Uuid</code> value with a <code>version</code> field
  of <code>0x1</code> should not be treated as a capability.

  <p>A subclass of <code>Uuid</code> must not implement <a href="http://docs.oracle.com/javase/6/docs/api/java/io/Externalizable.html?is-external=true" title="class or interface in java.io"><code>Externalizable</code></a>; this restriction is enforced by this class's
  constructor and <code>readObject</code> methods.</div>
 <dl>
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>2.0</dd>
 <dt><span class="simpleTagLabel">Author:</span></dt>
 <dd>Sun Microsystems, Inc.</dd>
 <dt><span class="seeLabel">See Also:</span></dt>
 <dd><a href="../../../serialized-form.html#net.jini.id.Uuid">Serialized Form</a></dd>
 </dl>
 </li>
 </ul>
 </div>
 <div class="summary">
 <ul class="blockList">
 <li class="blockList">
 <!-- =========== FIELD SUMMARY =========== -->
 <ul class="blockList">
 <li class="blockList"><a name="field.summary">
 <!--   -->
 </a>
 <h3>Field Summary</h3>
 <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation">
 <caption><span>Fields</span><span class="tabEnd">&nbsp;</span></caption>
 <tr>
 <th class="colFirst" scope="col">Modifier and Type</th>
 <th class="colLast" scope="col">Field and Description</th>
 </tr>
 <tr class="altColor">
 <td class="colFirst"><code>private long</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#bits0">bits0</a></span></code>
 <div class="block">The most significant 64 bits of the 128-bit value.</div>
 </td>
 </tr>
 <tr class="rowColor">
 <td class="colFirst"><code>private long</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#bits1">bits1</a></span></code>
 <div class="block">The least significant 64 bits of the 128-bit value.</div>
 </td>
 </tr>
 <tr class="altColor">
 <td class="colFirst"><code>private static long</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#serialVersionUID">serialVersionUID</a></span></code>&nbsp;</td>
 </tr>
 </table>
 </li>
 </ul>
 <!-- ======== CONSTRUCTOR SUMMARY ======== -->
 <ul class="blockList">
 <li class="blockList"><a name="constructor.summary">
 <!--   -->
 </a>
 <h3>Constructor Summary</h3>
 <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
 <caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
 <tr>
 <th class="colFirst" scope="col">Modifier</th>
 <th class="colLast" scope="col">Constructor and Description</th>
 </tr>
 <tr class="altColor">
 <td class="colFirst"><code>protected </code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#Uuid-long-long-">Uuid</a></span>(long&nbsp;bits0,
     long&nbsp;bits1)</code>
 <div class="block">Creates a new <code>Uuid</code> with the specified 128-bit
  value.</div>
 </td>
 </tr>
 </table>
 </li>
 </ul>
 <!-- ========== METHOD SUMMARY =========== -->
 <ul class="blockList">
 <li class="blockList"><a name="method.summary">
 <!--   -->
 </a>
 <h3>Method Summary</h3>
 <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
 <caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t1" class="tableTab"><span><a href="javascript:show(1);">Static Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
 <tr>
 <th class="colFirst" scope="col">Modifier and Type</th>
 <th class="colLast" scope="col">Method and Description</th>
 </tr>
 <tr id="i0" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#equals-java.lang.Object-">equals</a></span>(<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;obj)</code>
 <div class="block">Compares the specified object with this <code>Uuid</code> for
  equality.</div>
 </td>
 </tr>
 <tr id="i1" class="rowColor">
 <td class="colFirst"><code>protected void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#finalize--">finalize</a></span>()</code>
 <div class="block">Delegates to the superclass's <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang"><code>finalize</code></a>
  method.</div>
 </td>
 </tr>
 <tr id="i2" class="altColor">
 <td class="colFirst"><code>long</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#getLeastSignificantBits--">getLeastSignificantBits</a></span>()</code>
 <div class="block">Returns the least significant 64 bits of this
  <code>Uuid</code>'s 128-bit value.</div>
 </td>
 </tr>
 <tr id="i3" class="rowColor">
 <td class="colFirst"><code>long</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#getMostSignificantBits--">getMostSignificantBits</a></span>()</code>
 <div class="block">Returns the most significant 64 bits of this
  <code>Uuid</code>'s 128-bit value.</div>
 </td>
 </tr>
 <tr id="i4" class="altColor">
 <td class="colFirst"><code>int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#hashCode--">hashCode</a></span>()</code>
 <div class="block">Returns the hash code value for this <code>Uuid</code>.</div>
 </td>
 </tr>
 <tr id="i5" class="rowColor">
 <td class="colFirst"><code>private boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#isValid--">isValid</a></span>()</code>&nbsp;</td>
 </tr>
 <tr id="i6" class="altColor">
 <td class="colFirst"><code>private void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#readObject-java.io.ObjectInputStream-">readObject</a></span>(<a href="http://docs.oracle.com/javase/6/docs/api/java/io/ObjectInputStream.html?is-external=true" title="class or interface in java.io">ObjectInputStream</a>&nbsp;in)</code>&nbsp;</td>
 </tr>
 <tr id="i7" class="rowColor">
 <td class="colFirst"><code>private void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#readObjectNoData--">readObjectNoData</a></span>()</code>&nbsp;</td>
 </tr>
 <tr id="i8" class="altColor">
 <td class="colFirst"><code>protected <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#readResolve--">readResolve</a></span>()</code>
 <div class="block">Returns this object.</div>
 </td>
 </tr>
 <tr id="i9" class="rowColor">
 <td class="colFirst"><code>private <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#toHexString-long-int-">toHexString</a></span>(long&nbsp;value,
            int&nbsp;digits)</code>
 <div class="block">Returns the specified number of the least significant digits of
  the hexadecimal representation of the given value, discarding
  more significant digits or padding with zeros as necessary.</div>
 </td>
 </tr>
 <tr id="i10" class="altColor">
 <td class="colFirst"><code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#toString--">toString</a></span>()</code>
 <div class="block">Returns a string representation of this <code>Uuid</code>.</div>
 </td>
 </tr>
 <tr id="i11" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#write-java.io.OutputStream-">write</a></span>(<a href="http://docs.oracle.com/javase/6/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;out)</code>
 <div class="block">Marshals a binary representation of this <code>Uuid</code> to
  an <code>OutputStream</code>.</div>
 </td>
 </tr>
 <tr id="i12" class="altColor">
 <td class="colFirst"><code>private static void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#writeLong-long-java.io.OutputStream-">writeLong</a></span>(long&nbsp;value,
          <a href="http://docs.oracle.com/javase/6/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;out)</code>
 <div class="block">Write a long value to an OutputStream in big-endian byte order.</div>
 </td>
 </tr>
 <tr id="i13" class="rowColor">
 <td class="colFirst"><code>protected <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../net/jini/id/Uuid.html#writeReplace--">writeReplace</a></span>()</code>
 <div class="block">Returns this object.</div>
 </td>
 </tr>
 </table>
 <ul class="blockList">
 <li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
 <!--   -->
 </a>
 <h3>Methods inherited from class&nbsp;java.lang.<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
 <code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li>
 </ul>
 </li>
 </ul>
 </li>
 </ul>
 </div>
 <div class="details">
 <ul class="blockList">
 <li class="blockList">
 <!-- ============ FIELD DETAIL =========== -->
 <ul class="blockList">
 <li class="blockList"><a name="field.detail">
 <!--   -->
 </a>
 <h3>Field Detail</h3>
 <a name="serialVersionUID">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>serialVersionUID</h4>
 <pre>private static final&nbsp;long serialVersionUID</pre>
 <dl>
 <dt><span class="seeLabel">See Also:</span></dt>
 <dd><a href="../../../constant-values.html#net.jini.id.Uuid.serialVersionUID">Constant Field Values</a></dd>
 </dl>
 </li>
 </ul>
 <a name="bits0">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>bits0</h4>
 <pre>private final&nbsp;long bits0</pre>
 <div class="block">The most significant 64 bits of the 128-bit value.</div>
 </li>
 </ul>
 <a name="bits1">
 <!--   -->
 </a>
 <ul class="blockListLast">
 <li class="blockList">
 <h4>bits1</h4>
 <pre>private final&nbsp;long bits1</pre>
 <div class="block">The least significant 64 bits of the 128-bit value.</div>
 </li>
 </ul>
 </li>
 </ul>
 <!-- ========= CONSTRUCTOR DETAIL ======== -->
 <ul class="blockList">
 <li class="blockList"><a name="constructor.detail">
 <!--   -->
 </a>
 <h3>Constructor Detail</h3>
 <a name="Uuid-long-long-">
 <!--   -->
 </a>
 <ul class="blockListLast">
 <li class="blockList">
 <h4>Uuid</h4>
 <pre>protected&nbsp;Uuid(long&nbsp;bits0,
                long&nbsp;bits1)</pre>
 <div class="block">Creates a new <code>Uuid</code> with the specified 128-bit
  value.</div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
 <dd><code>bits0</code> - the most significant 64 bits of the 128-bit value</dd>
 <dd><code>bits1</code> - the least significant 64 bits of the 128-bit value</dd>
 <dt><span class="throwsLabel">Throws:</span></dt>
 <dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/SecurityException.html?is-external=true" title="class or interface in java.lang">SecurityException</a></code> - if the class of this object
  implements <code>Externalizable</code></dd>
 </dl>
 </li>
 </ul>
 </li>
 </ul>
 <!-- ============ METHOD DETAIL ========== -->
 <ul class="blockList">
 <li class="blockList"><a name="method.detail">
 <!--   -->
 </a>
 <h3>Method Detail</h3>
 <a name="getMostSignificantBits--">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>getMostSignificantBits</h4>
 <pre>public final&nbsp;long&nbsp;getMostSignificantBits()</pre>
 <div class="block">Returns the most significant 64 bits of this
  <code>Uuid</code>'s 128-bit value.</div>
 <dl>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>the most significant 64 bits of the 128-bit value</dd>
 </dl>
 </li>
 </ul>
 <a name="getLeastSignificantBits--">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>getLeastSignificantBits</h4>
 <pre>public final&nbsp;long&nbsp;getLeastSignificantBits()</pre>
 <div class="block">Returns the least significant 64 bits of this
  <code>Uuid</code>'s 128-bit value.</div>
 <dl>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>the least significant 64 bits of the 128-bit value</dd>
 </dl>
 </li>
 </ul>
 <a name="hashCode--">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>hashCode</h4>
 <pre>public final&nbsp;int&nbsp;hashCode()</pre>
 <div class="block">Returns the hash code value for this <code>Uuid</code>.</div>
 <dl>
 <dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
 <dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a></code>&nbsp;in class&nbsp;<code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>the hash code value for this <code>Uuid</code></dd>
 </dl>
 </li>
 </ul>
 <a name="equals-java.lang.Object-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>equals</h4>
 <pre>public final&nbsp;boolean&nbsp;equals(<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;obj)</pre>
 <div class="block">Compares the specified object with this <code>Uuid</code> for
  equality.

  This method returns <code>true</code> if and only if the
  specified object is a <code>Uuid</code> instance with the same
  128-bit value as this one.</div>
 <dl>
 <dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
 <dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a></code>&nbsp;in class&nbsp;<code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
 <dt><span class="paramLabel">Parameters:</span></dt>
 <dd><code>obj</code> - the object to compare this <code>Uuid</code> to</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd><code>true</code> if the given object is equivalent to
  this one, and <code>false</code> otherwise</dd>
 </dl>
 </li>
 </ul>
 <a name="toString--">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>toString</h4>
 <pre>public final&nbsp;<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;toString()</pre>
 <div class="block">Returns a string representation of this <code>Uuid</code>.

  <p>The string representation is 36 characters long, with five
  fields of zero-filled, lowercase hexadecimal numbers separated
  by hyphens.  The fields of the string representation are
  derived from the components of the 128-bit value in the
  following order:

  <ul>

  <li><code>time_low</code> (8 hexadecimal digits)

  <li><code>time_mid</code> (4 hexadecimal digits)

  <li><code>version</code> and <code>time_hi</code> treated as a
  single field (4 hexadecimal digits)

  <li><code>variant</code> and <code>clock_seq</code> treated as
  a single field (4 hexadecimal digits)

  <li><code>node</code> (12 hexadecimal digits)

  </ul>

  <p>As an example, a <code>Uuid</code> with the 128-bit value

  <pre>0x0123456789ABCDEF0123456789ABCDEF</pre>

  would have the following string representation:

  <pre>01234567-89ab-cdef-0123-456789abcdef</pre></div>
 <dl>
 <dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
 <dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a></code>&nbsp;in class&nbsp;<code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>a string representation of this <code>Uuid</code></dd>
 </dl>
 </li>
 </ul>
 <a name="toHexString-long-int-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>toHexString</h4>
 <pre>private&nbsp;<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;toHexString(long&nbsp;value,
                            int&nbsp;digits)</pre>
 <div class="block">Returns the specified number of the least significant digits of
  the hexadecimal representation of the given value, discarding
  more significant digits or padding with zeros as necessary.
  Only lowercase letters are used in the returned hexadecimal
  representation.</div>
 </li>
 </ul>
 <a name="write-java.io.OutputStream-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>write</h4>
 <pre>public final&nbsp;void&nbsp;write(<a href="http://docs.oracle.com/javase/6/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;out)
                  throws <a href="http://docs.oracle.com/javase/6/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
 <div class="block">Marshals a binary representation of this <code>Uuid</code> to
  an <code>OutputStream</code>.

  <p>Specifically, this method writes the 128-bit value to the
  stream as 16 bytes in network (big-endian) byte order.</div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
 <dd><code>out</code> - the <code>OutputStream</code> to write this
  <code>Uuid</code> to</dd>
 <dt><span class="throwsLabel">Throws:</span></dt>
 <dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - if an I/O exception occurs while performing
  this operation</dd>
 <dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if <code>out</code> is
  <code>null</code></dd>
 </dl>
 </li>
 </ul>
 <a name="writeLong-long-java.io.OutputStream-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>writeLong</h4>
 <pre>private static&nbsp;void&nbsp;writeLong(long&nbsp;value,
                               <a href="http://docs.oracle.com/javase/6/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;out)
                        throws <a href="http://docs.oracle.com/javase/6/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
 <div class="block">Write a long value to an OutputStream in big-endian byte order.</div>
 <dl>
 <dt><span class="throwsLabel">Throws:</span></dt>
 <dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code></dd>
 </dl>
 </li>
 </ul>
 <a name="finalize--">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>finalize</h4>
 <pre>protected final&nbsp;void&nbsp;finalize()
                        throws <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a></pre>
 <div class="block">Delegates to the superclass's <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang"><code>finalize</code></a>
  method.  This method prevents a subclass from declaring an
  overriding <code>finalize</code> method.</div>
 <dl>
 <dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
 <dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a></code>&nbsp;in class&nbsp;<code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
 <dt><span class="throwsLabel">Throws:</span></dt>
 <dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a></code> - if the superclass's <code>finalize</code>
  method throws a <code>Throwable</code></dd>
 </dl>
 </li>
 </ul>
 <a name="writeReplace--">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>writeReplace</h4>
 <pre>protected final&nbsp;<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;writeReplace()</pre>
 <div class="block">Returns this object.  This method prevents a subclass from
  declaring a <code>writeReplace</code> method with an alternate
  implementation.</div>
 <dl>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>this object</dd>
 </dl>
 </li>
 </ul>
 <a name="readResolve--">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>readResolve</h4>
 <pre>protected final&nbsp;<a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;readResolve()</pre>
 <div class="block">Returns this object.  This method prevents a subclass from
  declaring a <code>readResolve</code> method with an alternate
  implementation.</div>
 <dl>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>this object</dd>
 </dl>
 </li>
 </ul>
 <a name="readObject-java.io.ObjectInputStream-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>readObject</h4>
 <pre>private&nbsp;void&nbsp;readObject(<a href="http://docs.oracle.com/javase/6/docs/api/java/io/ObjectInputStream.html?is-external=true" title="class or interface in java.io">ObjectInputStream</a>&nbsp;in)
                  throws <a href="http://docs.oracle.com/javase/6/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a>,
                         <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/ClassNotFoundException.html?is-external=true" title="class or interface in java.lang">ClassNotFoundException</a></pre>
 <dl>
 <dt><span class="throwsLabel">Throws:</span></dt>
 <dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/io/InvalidObjectException.html?is-external=true" title="class or interface in java.io">InvalidObjectException</a></code> - if the class of this object
  implements <code>Externalizable</code></dd>
 <dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code></dd>
 <dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/lang/ClassNotFoundException.html?is-external=true" title="class or interface in java.lang">ClassNotFoundException</a></code></dd>
 </dl>
 </li>
 </ul>
 <a name="readObjectNoData--">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>readObjectNoData</h4>
 <pre>private&nbsp;void&nbsp;readObjectNoData()
                        throws <a href="http://docs.oracle.com/javase/6/docs/api/java/io/InvalidObjectException.html?is-external=true" title="class or interface in java.io">InvalidObjectException</a></pre>
 <dl>
 <dt><span class="throwsLabel">Throws:</span></dt>
 <dd><code><a href="http://docs.oracle.com/javase/6/docs/api/java/io/InvalidObjectException.html?is-external=true" title="class or interface in java.io">InvalidObjectException</a></code> - unconditionally</dd>
 </dl>
 </li>
 </ul>
 <a name="isValid--">
 <!--   -->
 </a>
 <ul class="blockListLast">
 <li class="blockList">
 <h4>isValid</h4>
 <pre>private&nbsp;boolean&nbsp;isValid()</pre>
 </li>
 </ul>
 </li>
 </ul>
 </li>
 </ul>
 </div>
 </div>
 <!-- ========= END OF CLASS DATA ========= -->
 <!-- ======= START OF BOTTOM NAVBAR ====== -->
 <div class="bottomNav"><a name="navbar.bottom">
 <!--   -->
 </a>
 <div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
 <a name="navbar.bottom.firstrow">
 <!--   -->
 </a>
 <ul class="navList" title="Navigation">
 <li><a href="../../../overview-summary.html">Overview</a></li>
 <li><a href="package-summary.html">Package</a></li>
 <li class="navBarCell1Rev">Class</li>
 <li><a href="class-use/Uuid.html">Use</a></li>
 <li><a href="package-tree.html">Tree</a></li>
 <li><a href="../../../deprecated-list.html">Deprecated</a></li>
 <li><a href="../../../index-all.html">Index</a></li>
 <li><a href="../../../help-doc.html">Help</a></li>
 </ul>
 </div>
 <div class="subNav">
 <ul class="navList">
 <li><a href="../../../net/jini/id/ReferentUuids.html" title="class in net.jini.id"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
 <li><a href="../../../net/jini/id/UuidFactory.html" title="class in net.jini.id"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
 </ul>
 <ul class="navList">
 <li><a href="../../../index.html?net/jini/id/Uuid.html" target="_top">Frames</a></li>
 <li><a href="Uuid.html" target="_top">No&nbsp;Frames</a></li>
 </ul>
 <ul class="navList" id="allclasses_navbar_bottom">
 <li><a href="../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
 </ul>
 <div>
 <script type="text/javascript"><!--
   allClassesLink = document.getElementById("allclasses_navbar_bottom");
   if(window==top) {
     allClassesLink.style.display = "block";
   }
   else {
     allClassesLink.style.display = "none";
   }
   //-->
 </script>
 </div>
 <div>
 <ul class="subNavList">
 <li>Summary:&nbsp;</li>
 <li>Nested&nbsp;|&nbsp;</li>
 <li><a href="#field.summary">Field</a>&nbsp;|&nbsp;</li>
 <li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
 <li><a href="#method.summary">Method</a></li>
 </ul>
 <ul class="subNavList">
 <li>Detail:&nbsp;</li>
 <li><a href="#field.detail">Field</a>&nbsp;|&nbsp;</li>
 <li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
 <li><a href="#method.detail">Method</a></li>
 </ul>
 </div>
 <a name="skip.navbar.bottom">
 <!--   -->
 </a></div>
 <!-- ======== END OF BOTTOM NAVBAR ======= -->
 <p class="legalCopy"><small>Copyright 2007-2013, multiple authors.<br>Licensed under the <a href=http://www.apache.org/licenses/LICENSE-2.0 target=child >Apache License, Version 2.0</a>, see the <a href=../../../doc-files/NOTICE target=child >NOTICE</a> file for attributions.</small></p>
 </body>
 </html>