commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From pste...@apache.org
Subject svn commit: r280152 - in /jakarta/commons/sandbox/id/trunk: ./ src/java/org/apache/commons/id/uuid/ src/java/org/apache/commons/id/uuid/clock/ src/java/org/apache/commons/id/uuid/state/
Date Sun, 11 Sep 2005 17:15:15 GMT
Author: psteitz
Date: Sun Sep 11 10:15:08 2005
New Revision: 280152

URL: http://svn.apache.org/viewcvs?rev=280152&view=rev
Log:
Javadoc only.
Change UUID referenced to RFC 4122.
PR# 35820 
Submitted by Jukka Zitting
Also fixed numerous javadoc errors.

Modified:
    jakarta/commons/sandbox/id/trunk/project.xml
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/Bytes.java
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUID.java
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUIDFormatException.java
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionFourGenerator.java
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionOneGenerator.java
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/Clock.java
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/SystemClockImpl.java
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/ThreadClockImpl.java
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/package.html
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/package.html
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/InMemoryStateImpl.java
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadOnlyResourceStateImpl.java
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadWriteFileStateImpl.java
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/State.java
    jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/StateHelper.java

Modified: jakarta/commons/sandbox/id/trunk/project.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/project.xml?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/project.xml (original)
+++ jakarta/commons/sandbox/id/trunk/project.xml Sun Sep 11 10:15:08 2005
@@ -73,7 +73,7 @@
     <developer>
       <name>Phil Steitz</name>
       <id>psteitz</id>
-      <email>psteitz@apache.org</email>
+      <email>psteitz at apache dot org</email>
       <organization></organization>
       <timezone>-9</timezone>
       <roles>
@@ -103,12 +103,6 @@
   </developers>
 
   <contributors>
-	  <contributor>
-	  	<name>Rory Winston</name>
-	  	<id>rwinston</id>
-	  	<email>rwinston@eircom.net</email>
-	  	<organization></organization>
-  	  </contributor>
   	  <contributor>
   	  <name>Eric Crampton</name>
 	  	<email></email>
@@ -119,6 +113,15 @@
 	  	<email></email>
 	  	<organization></organization>
 	  </contributor>
+	  <contributor>
+	  	<name>Rory Winston</name>
+	  	<id>rwinston</id>
+	  	<email>rwinston@eircom.net</email>
+	  	<organization></organization>
+  	  </contributor>
+  	  <contributor>
+	  	<name>Jukka Zitting</name>
+  	  </contributor>
   </contributors>
 
   <dependencies>

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/Bytes.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/Bytes.java?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/Bytes.java (original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/Bytes.java Sun Sep
11 10:15:08 2005
@@ -21,7 +21,6 @@
  *
  * @author Commons-Id Team
  * @version $Id$
- * {@link http://jakarta.apache.org/turbine/turbine-2.3/}
  */
 public final class Bytes {
 

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUID.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUID.java?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUID.java (original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUID.java Sun Sep
11 10:15:08 2005
@@ -27,11 +27,10 @@
 
 
 /**
- * <p><code>UUID</code> represents a Universally Unique Identifier per
IETF
- * Draft specification. For more information regarding the IETF Draft UUID
- * specification</p>
- *
- * <p>See: http://www.ietf.org/internet-drafts/draft-mealling-uuid-urn-01.txt</p>
+ * <p><code>UUID</code> represents a Universally Unique Identifier per
RFC 4122.
+ * See the <a href="ftp://ftp.rfc-editor.org/in-notes/rfc4122.txt">RFC 4122:
+ * A Universally Unique IDentifier (UUID) URN Namespace</a>
+ * for more information.</p>
  *
  * @author Commons-Id Team
  * @version $Revision$ $Date$
@@ -252,7 +251,7 @@
 	}
 	
 	/**
-	 * <p>Compares two UUID's for equality</p>
+	 * <p>Compares two UUID's for equality.</p>
 	 *
 	 * @see Comparable#compareTo(Object)
 	 */

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUIDFormatException.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUIDFormatException.java?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUIDFormatException.java
(original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/UUIDFormatException.java
Sun Sep 11 10:15:08 2005
@@ -20,7 +20,6 @@
  * string does not have the appropriate format.</p>
  *
  * @see     UUID#toString()
- * @see     UUID#parseString(String)
  * @see     UUID#UUID(String)
  *
  * @author Commons-Id Team

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionFourGenerator.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionFourGenerator.java?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionFourGenerator.java
(original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionFourGenerator.java
Sun Sep 11 10:15:08 2005
@@ -23,8 +23,8 @@
 import org.apache.commons.id.IdentifierGenerator;
 
 /**
- * <p>Class is responsible for generating version 4 UUID's per the IETF draft
- * specification. This class attempts to use a java.security.SecureRandom with
+ * <p>Class is responsible for generating version 4 UUID's per RFC 4122.
+ * This class attempts to use a java.security.SecureRandom with
  * the following instantiation
  * <code>SecureRandom.getInstance("SHA1PRNG", "SUN")</code>. If neither secure
  * random implementation is avialable or an Exception is raised a java.util.Random

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionOneGenerator.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionOneGenerator.java?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionOneGenerator.java
(original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/VersionOneGenerator.java
Sun Sep 11 10:15:08 2005
@@ -23,12 +23,14 @@
 import org.apache.commons.id.uuid.state.Node;
 
 /**
- * Class is responsible for generating version 1 UUID's per the IETF draft
- * specification. This class attempts to locate the machine's node identifier
+ * Class is responsible for generating version 1 UUID's per RFC 4122.
+ * This class attempts to locate the machine's node identifier
  * first by attempting to loading the properties file UUID.properties
  * from the system classpath. If the UUID.properties file does not exist
  * then the generator will create a node identifier from random information as
- * defined in the IEFT UUID Draft specification.
+ * defined in the
+ * <a href="ftp://ftp.rfc-editor.org/in-notes/rfc4122.txt">RFC 4122:
+ * A Universally Unique IDentifier (UUID) URN Namespace</a>.
  *
  * @author Commons-Id team
  * @version $Revision$ $Date$

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/Clock.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/Clock.java?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/Clock.java
(original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/Clock.java
Sun Sep 11 10:15:08 2005
@@ -18,13 +18,14 @@
 
 
 /**
- * <p>Clock.java provides a timing mechanism for returning the current time in
- * 100-nano second intervals since 00:00:00.00, 15 October 1582</p>
+ * <p>Provides a timing mechanism for returning the current time in
+ * 100-nano second intervals since 00:00:00.00, 15 October 1582.</p>
  *
  * <p>As described below this is useful for generating Version 1 UUIDs</p>
  *
- * <p>For more information regarding the IETF Draft UUID specification
- * see http://www.ietf.org/internet-drafts/draft-mealling-uuid-urn-01.txt</p>
+ * <p>See the <a href="ftp://ftp.rfc-editor.org/in-notes/rfc4122.txt">RFC 4122:
+ * A Universally Unique IDentifier (UUID) URN Namespace</a>
+ * for more information.</p>
  *
  * <p>Selected quotes from IETF document pertaining to this class:</p>
  *
@@ -36,51 +37,38 @@
  * nanosecond intervals since 00:00:00.00, 15 October 1582 (the date of
  * Gregorian reform to the Christian calendar)."</dd>
  *
- * <dt>Clock Adjustment</dt>
- * <dd>"UUIDs may be created at a rate greater than the system clock resolution.
- * Therefore, the system must also maintain an adjustment value to be added to
- * the lower-order bits of the time. Logically, each time the system clock
- * ticks, the adjustment value is cleared. Every time a UUID is generated,
- * the current adjustment value is read and incremented atomically, then added
- * to the UTC time field of the UUID."</dd>
- *
- * <dt>Clock Overrun</dt>
- * <dd>"The 100 nanosecond granularity of time should prove sufficient even for
- * bursts of UUID creation in the next generation of high-performance
- * multiprocessors. If a system overruns the clock adjustment by requesting
- * too many UUIDs within a single system clock tick, the UUID service may
- * raise an exception, handled in a system or process-dependent manner
- * either by:
- * terminating the request
- * reissuing the request until it succeeds
- * stalling the UUID generator until the system clock catches up.
- * <br>...<br>
- * If the processors overrun the UUID generation frequently, additional node
- * identifiers and clocks may need to be added."</dd>
+ * <dt>System Clock Resolution</dt>
+ * <dd>"If a system overruns the generator by requesting too many UUIDs
+ * within a single system time interval, the UUID service MUST either
+ * return an error, or stall the UUID generator until the system clock
+ * catches up.<br>
+ * <br>
+ * A high resolution timestamp can be simulated by keeping a count of
+ * the number of UUIDs that have been generated with the same value of
+ * the system time, and using it to construct the low order bits of the
+ * timestamp.  The count will range between zero and the number of
+ * 100-nanosecond intervals per system time interval.<br>
+ * <br>
+ * Note: If the processors overrun the UUID generation frequently,
+ * additional node identifiers can be allocated to the system, which
+ * will permit higher speed allocation by making multiple UUIDs
+ * potentially available for each time stamp value."</dd>
  *
  * <p>The above quotations are protected under the following copyright notice </p>
- * <p><code>Copyright (C) The Internet Society (2003). All Rights Reserved.
- * This document and translations of it may be copied and furnished to
- * others, and derivative works that comment on or otherwise explain it
- * or assist in its implementation may be prepared, copied, published
- * and distributed, in whole or in part, without restriction of any
- * kind, provided that the above copyright notice and this paragraph are
- * included on all such copies and derivative works. However, this
- * document itself may not be modified in any way, such as by removing
- * the copyright notice or references to the Internet Society or other
- * Internet organizations, except as needed for the purpose of
- * developing Internet standards in which case the procedures for
- * copyrights defined in the Internet Standards process must be
- * followed, or as required to translate it into languages other than
- * English.</p>
- * <p>The limited permissions granted above are perpetual and will not be
- * revoked by the Internet Society or its successors or assignees.
- * This document and the information contained herein is provided on an
- * "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
- * TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
- * BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
- * HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
- * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.</code></p>
+ * <p><code>Copyright (C) The Internet Society (2005).<br>
+ * <br>
+ * This document is subject to the rights, licenses and restrictions
+ * contained in BCP 78, and except as set forth therein, the authors
+ * retain all their rights.<br>
+ * <br>
+ * This document and the information contained herein are provided on an
+ * "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
+ * OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
+ * ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
+ * INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
+ * WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
+ * </code></p>
  *
  * ====================================================================
  *

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/SystemClockImpl.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/SystemClockImpl.java?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/SystemClockImpl.java
(original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/SystemClockImpl.java
Sun Sep 11 10:15:08 2005
@@ -21,7 +21,7 @@
  * current time in 100-nano second intervals since 00:00:00.00, 15 October 1582.
  * </p>
  *
- * @see org.apache.commons.uid.uuid.Clock
+ * @see org.apache.commons.id.uuid.clock.Clock
  * @author Commons-Id Team
  * @version $Revision$ $Date$
  */
@@ -40,7 +40,7 @@
         super();
     }
 
-    /** @see org.apache.commons.uid.uuid#getCurrentTime() */
+    /** @see org.apache.commons.id.uuid.clock.Clock#getUUIDTime() */
     public long getUUIDTime() throws OverClockedException {
         return getTimeSynchronized();
     }

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/ThreadClockImpl.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/ThreadClockImpl.java?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/ThreadClockImpl.java
(original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/ThreadClockImpl.java
Sun Sep 11 10:15:08 2005
@@ -18,19 +18,17 @@
 
 
 /**
- * Clock.java provides a timing mechanism for returning the current time in
- * 100-nano second intervals since 00:00:00.00, 15 October 1582
+ * <p>{@link Clock} provides a timing mechanism for returning the current time in
+ * 100-nano second intervals since 00:00:00.00, 15 October 1582.</p>
  *
- * @see org.apache.commons.uid.uuid.Clock
- *
- * This Class consumes a single thread which will die off if not utilized before
+ * <p>This Class consumes a single thread which will die off if not utilized before
  * the expiration. Subsequent calls after a thread expires start a new thread.
  * Compensates for jvm time resolution issues. This clock should be used in
  * instances where the system resolution does not perform adequately - the
  * clocking resolution on some windows virtual machines can range from 10 to 50
  * milliseconds before the System.currentTimeMillis changes. In instances where
  * 10,000 or more uuid's may be generated in a millisecond this Clock
- * implementation may be required.
+ * implementation may be required.</p>
  *
  * @author Commons-Id Team
  * @version $Revision$ $Date$

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/package.html
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/package.html?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/package.html
(original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/clock/package.html
Sun Sep 11 10:15:08 2005
@@ -24,8 +24,8 @@
       general; the Clock interface is introduced to allow different or custom 
       strategies in timestamp generation. The IETF (Internet Engineering Task Force)
       specification details some of these approaches. For more information see
-      <a href="http://www.ietf.org/internet-drafts/draft-mealling-uuid-urn-02.txt">
-      IETF Draft UUID specification</a>.
+      the <a href="ftp://ftp.rfc-editor.org/in-notes/rfc4122.txt">RFC 4122:
+      A Universally Unique IDentifier (UUID) URN Namespace</a>.
   </p>
   <p>
     Two provided implementation are:

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/package.html
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/package.html?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/package.html (original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/package.html Sun
Sep 11 10:15:08 2005
@@ -15,13 +15,14 @@
   -->
 <body>
   <p>
-    <p>
       This package contains UUID (Universally Unique Identifier)
-      generator implementations and supporting classes. A UUID is 128-bits
-      long and can provide an extremely high likelihood of uniqueness. For more
-      information see the Internet Engineering Task Force
-      <a href="http://www.ietf.org/internet-drafts/draft-mealling-uuid-urn-03.txt">
-      IETF Draft UUID specification</a>.
+      generator implementations and supporting classes. 
+  </p>
+  <p>
+      A UUID is 128-bits long and can provide an extremely high likelihood
+      of uniqueness. For more information see the Internet Engineering Task
+      Force <a href="ftp://ftp.rfc-editor.org/in-notes/rfc4122.txt">RFC 4122:
+      A Universally Unique IDentifier (UUID) URN Namespace</a>.
   </p>
   <p>
      The version 1 uuid generator collaborates with various interfaces that 

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/InMemoryStateImpl.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/InMemoryStateImpl.java?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/InMemoryStateImpl.java
(original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/InMemoryStateImpl.java
Sun Sep 11 10:15:08 2005
@@ -20,8 +20,9 @@
 import java.util.Set;
 
 /**
- * <p>The <code>InMemoryStateImpl</code> is an implementation of the <code>State</code>
- * interface. This implementation is the <b>worst-case</b> scenario and provides
+ * <p>The <code>InMemoryStateImpl</code> is an implementation of the
+ * <code>State</code> interface.</p> 
+ * <p>This implementation is the <b>worst-case</b> scenario and provides
  * the least guarantee of no UUID duplication. This implementation is provided for
  * systems that truly have no other means of writing to or reading from stable
  * storage.</p>
@@ -43,7 +44,7 @@
     }
 
     /**
-     * @see org.apache.commons.id.uuid.state.State#getNode()
+     * @see org.apache.commons.id.uuid.state.State#getNodes()
      */
     public Set getNodes() {
        return nodes;

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadOnlyResourceStateImpl.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadOnlyResourceStateImpl.java?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadOnlyResourceStateImpl.java
(original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadOnlyResourceStateImpl.java
Sun Sep 11 10:15:08 2005
@@ -56,7 +56,7 @@
     public static final String CONFIG_FILENAME_KEY = "org.apache.commons.id.uuid.config.resource.filename";
 
     /**
-     * <p>Constructs a ReadOnlyResouceStateImpl</p>
+     * <p>Constructs a ReadOnlyResouceStateImpl.</p>
      */
     public ReadOnlyResourceStateImpl() {
         super();
@@ -137,7 +137,7 @@
     }
 
     /**
-     * @see org.apache.commons.id.uuid.state.State#store(java.util.Collection)
+     * @see org.apache.commons.id.uuid.state.State#store(java.util.Set)
      */
     public void store(Set nodeSet) throws IOException {
         // Nothing to do - this is a ReadOnly implementation.
@@ -145,7 +145,7 @@
     }
 
     /**
-     * @see org.apache.commons.id.uuid.state.State#store(java.util.Collection, long)
+     * @see org.apache.commons.id.uuid.state.State#store(java.util.Set, long)
      */
     public void store(Set nodeSet, long timestamp) {
         // Nothing to do - this is a ReadOnly implementation.

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadWriteFileStateImpl.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadWriteFileStateImpl.java?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadWriteFileStateImpl.java
(original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/ReadWriteFileStateImpl.java
Sun Sep 11 10:15:08 2005
@@ -37,7 +37,7 @@
     /**
      * Persists the UUID generator state to file.
      *
-     * @see org.apache.commons.id.uuid.state.State#store(java.util.Collection)
+     * @see org.apache.commons.id.uuid.state.State#store(java.util.Set)
      */
     public void store(Set nodes) throws IOException {
         writeXML(genXML(nodes));

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/State.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/State.java?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/State.java
(original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/State.java
Sun Sep 11 10:15:08 2005
@@ -57,7 +57,7 @@
     Set getNodes(  );
 
     /**
-     * <p>Stores the state information</p>
+     * <p>Stores the state information.</p>
      *
      * <p>To increase the quality of the UUID uniqueness, a system that may
      * write to stable storage SHOULD perist the state of the UUIDGenerator in

Modified: jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/StateHelper.java
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/StateHelper.java?rev=280152&r1=280151&r2=280152&view=diff
==============================================================================
--- jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/StateHelper.java
(original)
+++ jakarta/commons/sandbox/id/trunk/src/java/org/apache/commons/id/uuid/state/StateHelper.java
Sun Sep 11 10:15:08 2005
@@ -35,7 +35,7 @@
 
 /**
  * <p><code>StateHelper</code> provides helper methods for the uuid state
- * implementations</p>
+ * implementations.</p>
  *
  * @author Commons-Id team
  * @version $Id$
@@ -204,9 +204,9 @@
 
     /**
      * <p>Utility method decodes a valid MAC address in the form of
-     * XX-XX-XX-XX-XX-XX where each XX represents a hexidecimal value. Returns
-     * null if the address can not be decoded.
-     * </p>
+     * XX-XX-XX-XX-XX-XX where each XX represents a hexidecimal value.</p>
+     * 
+     * <p> Returns null if the address can not be decoded. </p>
      *
      * @param address the String hexidecimal dash separated MAC address.
      * @return a byte array representing the the address. Null if not a valid address.



---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message