You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by ps...@apache.org on 2005/09/11 19:15:15 UTC
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/
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