HHH-18377 Fixed Javadoc comments

Author: cigaly

hibernate-core/src/main/java/org/hibernate/id/uuid/UuidV6ValueGenerator.java

@@ -20,7 +20,17 @@
 import org.hibernate.id.UUIDGenerationStrategy;
 
 /**
- * Implements a <a href="https://datatracker.ietf.org/doc/html/rfc9562#name-uuid-version-6">UUID Version 6</a> generation strategy as defined by the {@link UUID#randomUUID()} method.
+ * Implements UUID Version 6 generation strategy as defined by the <a href="https://datatracker.ietf.org/doc/html/rfc9562#name-uuid-version-6">RFC 9562</a>.
+ *
+ * <ul>
+ *     <li>32 bits - the most significant 32 bits of the 60-bit starting timestamp.</li>
+ *     <li>16 bits - the middle 16 bits of the 60-bit starting timestamp.</li>
+ *     <li>4 bits - version field, set to 0b0110 (6).</li>
+ *     <li>12 bits - the least significant 12 bits from the 60-bit starting timestamp.</li>
+ *     <li>2 bits - variant field, set to 0b10.</li>
+ *     <li>14 bits - the clock sequence, resets to 0 when timestamp changes. </li>
+ *     <li>48 bits - pseudorandom data to provide uniqueness.</li>
+ * </ul>
  *
  * @author Cedomir Igaly
  */
@@ -66,7 +76,7 @@ public int getGeneratedVersion() {
 	}
 
 	/**
-	 * Delegates to {@link UUID#randomUUID()}
+	 * Delegates to {@link #generateUuid}
 	 */
 	@Override
 	public UUID generateUUID(SharedSessionContractImplementor session) {
@@ -75,16 +85,6 @@ public UUID generateUUID(SharedSessionContractImplementor session) {
 
 
 	/**
-	 * <ul>
-	 *     <li>32 bits - the most significant 32 bits of the 60-bit starting timestamp.</li>
-	 *     <li>16 bits - the middle 16 bits of the 60-bit starting timestamp.</li>
-	 *     <li>4 bits - version field, set to 0b0110 (6).</li>
-	 *     <li>12 bits - the least significant 12 bits from the 60-bit starting timestamp.</li>
-	 *     <li>2 bits - variant field, set to 0b10.</li>
-	 *     <li>14 bits - the clock sequence, resets to 0 when timestamp changes. </li>
-	 *     <li>48 bits - pseudorandom data to provide uniqueness.</li>
-	 * </ul>
-	 *
 	 * @param session session
 	 *
 	 * @return UUID version 6

hibernate-core/src/main/java/org/hibernate/id/uuid/UuidV7ValueGenerator.java

@@ -21,7 +21,19 @@
 import static java.time.temporal.ChronoUnit.MILLIS;
 
 /**
- * Implements a <a href="https://datatracker.ietf.org/doc/html/rfc9562#name-uuid-version-7">UUID Version 7</a> generation strategy as defined by the {@link UUID#randomUUID()} method.
+ * Implements UUID Version 7 generation strategy as defined by the <a href="https://datatracker.ietf.org/doc/html/rfc9562#name-uuid-version-7">RFC 9562</a>.
+ *
+ * <ul>
+ *     <li>48 bits - 48-bit big-endian unsigned number of the Unix Epoch timestamp in milliseconds.</li>
+ *     <li>4 bits - version field, set to 0b0111 (7).</li>
+ *     <li>
+ *         12 bits - sub-milliseconds part of timestamp (resolution approximately 1/4 of millisecond)
+ *         to guarantee additional monotonicity.
+ *     </li>
+ *     <li>2 bits - variant field, set to 0b10.</li>
+ *     <li>14 bits - counter to guarantee additional monotonicity, resets to 0 when timestamp changes. </li>
+ *     <li>48 bits - pseudorandom data to provide uniqueness.</li>
+ * </ul>
  *
  * @author Cedomir Igaly
  */
@@ -63,26 +75,14 @@ public int getGeneratedVersion() {
 	}
 
 	/**
-	 * Delegates to {@link UUID#randomUUID()}
+	 * Delegates to {@link #generateUuid}
 	 */
 	@Override
 	public UUID generateUUID(SharedSessionContractImplementor session) {
 		return generateUuid( session );
 	}
 
 	/**
-	 * <ul>
-	 *     <li>48 bits - 48-bit big-endian unsigned number of the Unix Epoch timestamp in milliseconds.</li>
-	 *     <li>4 bits - version field, set to 0b0111 (7).</li>
-	 *     <li>
-	 *         12 bits - sub-milliseconds part of timestamp (resolution approximately 1/4 of millisecond)
-	 *         to guarantee additional monotonicity.
-	 *     </li>
-	 *     <li>2 bits - variant field, set to 0b10.</li>
-	 *     <li>14 bits - counter to guarantee additional monotonicity, resets to 0 when timestamp changes. </li>
-	 *     <li>48 bits - pseudorandom data to provide uniqueness.</li>
-	 * </ul>
-	 *
 	 * @param session session
 	 *
 	 * @return UUID version 7