Update README.md

Author: honhimW

README.md

@@ -2,38 +2,18 @@
 
 [![Maven Central](https://img.shields.io/maven-central/v/io.github.honhimw/uuid-java.svg)](https://central.sonatype.com/artifact/io.github.honhimw/uuid-java)
 
-## Usage
-
 ```groovy
 implementation 'io.github.honhimw:uuid-java:{latest}'
 ```
 
-```java
-import io.github.honhimw.uuid.*;
-import io.github.honhimw.uuid.gen.*;
+---
 
-void main() {
-    // Using via global shared instances.
-    Generator generator = UUIDs
-        .FAST  // FAST | SECURE default configuration
-        .V7; // V1 | V3 | V4 | V5 | V6 | V7
-    UUID uuid = generator.next(); // Generation
+## Benchmark
 
-    // Customize generator
-    V7 v7 = new V7(Context.builder()
-        .clock(
-            new V7.ClockSequenceV7()   // Reseeding timestamp context
-                .withAdditionalPrecision() // Add 12-bits for timestamp-precision
-        )
-        .random(() -> ThreadLocalRandom.current()) // For fast. `new SecureRandom()` for secure
-        .node(() -> MacAddress.nodeId()) // Using other by specificizing NodeId.of(new byte[] {1, 2, 3, 4, 5, 6})
-        .messageDigest(algorithm -> MessageDigest.getInstance(algorithm)) // MessageDigest provider(getting from thread-local cache?)
-        .build());
-}
+```shell
+./gradlew bench
 ```
 
-## Benchmark
-
 <details>
 <summary>Details</summary>
 
@@ -69,3 +49,60 @@ void main() {
 
 </details>
 
+---
+
+## Usage
+
+```java
+import io.github.honhimw.uuid.*;
+import io.github.honhimw.uuid.gen.*;
+
+void main() {
+    // Using via global shared instances.
+    Generator generator = UUIDs
+        .FAST  // FAST | SECURE default configuration
+        .V7; // V1 | V3 | V4 | V5 | V6 | V7
+    UUID uuid = generator.next(); // Generation
+//    UUID uuid = UUIDs.FAST.V1.now(MacAddress.nodeId());
+//    UUID uuid = UUIDs.FAST.V3.of("foo");
+//    UUID uuid = UUIDs.FAST.V4.next();
+//    UUID uuid = UUIDs.FAST.V5.of("bar");
+//    UUID uuid = UUIDs.FAST.V6.now(MacAddress.nodeId());
+//    UUID uuid = UUIDs.FAST.V7.of(Timestamp.now(CounterSequence.SHARED));
+}
+```
+
+### Customize
+```java
+void main() {
+    V7 v7 = new V7(Context.builder()
+        .clock(
+            new V7.ClockSequenceV7()   // Reseeding timestamp context
+                .withAdditionalPrecision() // Add 12-bits for timestamp-precision
+        )
+        .random(() -> ThreadLocalRandom.current()) // For fast. `new SecureRandom()` for secure
+        .node(() -> MacAddress.nodeId()) // Using other by specificizing NodeId.of(new byte[] {1, 2, 3, 4, 5, 6})
+        .messageDigest(algorithm -> MessageDigest.getInstance(algorithm)) // MessageDigest provider(getting from thread-local cache?)
+        .build());
+    v7.next(); // Generation
+}
+```
+
+### Typed Uuid
+
+```java
+import io.github.honhimw.uuid.Uuid;
+
+void main() {
+    UUID jdkUUID = UUID.randomUUID();
+    Uuid uuid = Uuid.fromUUID(jdkUUID);
+
+    assert Variant.RFC4122 == uuid.variant() : "variant RFC4122";
+    assert Version.RANDOM == uuid.version() : "version 4";
+    assert uuid.timestamp().isEmpty() : "not time based";
+    assert uuid.node().isEmpty() : "no node";
+
+    jdkUUID = uuid.asUUID();
+    byte[] bytes = uuid.asBytes();
+} 
+```

src/main/java/io/github/honhimw/uuid/gen/V7.java

@@ -21,7 +21,7 @@
 /// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 /// |                            rand_b                             |
 /// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
-/// ```
+///```
 ///
 /// - unix_ts_ms: 48-bit big-endian unsigned number of the Unix Epoch timestamp in milliseconds as per Section 6.1. Occupies bits 0 through 47 (octets 0-5).
 /// - ver: The 4-bit version field as defined by Section 4.2, set to 0b0111 (7). Occupies bits 48 through 51 of octet 6.

src/test/java/bench/BenchmarkRunner.java

@@ -21,15 +21,21 @@ public class BenchmarkRunner {
 
     private static final List<RunResult> RESULTS = new ArrayList<>();
 
+    private static int threads;
+
     @SneakyThrows
     public static void main(String[] args) {
+        threads = Runtime.getRuntime().availableProcessors();
         v1();
         v3();
         v4();
         v5();
         v6();
         v7();
         printResult();
+//        RESULTS.clear();
+//        secure();
+//        printResult();
     }
 
     public static void printResult() {
@@ -60,7 +66,7 @@ public static void v1() {
             .include(V1Self.class.getSimpleName())
             .include(V1UuidCreator.class.getSimpleName())
             .include(V1Fasterxml.class.getSimpleName())
-            .threads(6)
+            .threads(threads)
             .forks(1)
             .build();
 
@@ -74,7 +80,7 @@ public static void v3() {
             .include(V3Self.class.getSimpleName())
             .include(V3UuidCreator.class.getSimpleName())
             .include(V3Fasterxml.class.getSimpleName())
-            .threads(6)
+            .threads(threads)
             .forks(1)
             .build();
 
@@ -89,7 +95,7 @@ public static void v4() {
             .include(V4UuidCreator.class.getSimpleName())
             .include(V4Fasterxml.class.getSimpleName())
             .include(V4Jdk.class.getSimpleName())
-            .threads(6)
+            .threads(threads)
             .forks(1)
             .build();
 
@@ -103,7 +109,7 @@ public static void v5() {
             .include(V5Self.class.getSimpleName())
             .include(V5UuidCreator.class.getSimpleName())
             .include(V5Fasterxml.class.getSimpleName())
-            .threads(6)
+            .threads(threads)
             .forks(1)
             .build();
 
@@ -117,7 +123,7 @@ public static void v6() {
             .include(V6Self.class.getSimpleName())
             .include(V6UuidCreator.class.getSimpleName())
             .include(V6Fasterxml.class.getSimpleName())
-            .threads(6)
+            .threads(threads)
             .forks(1)
             .build();
 
@@ -132,7 +138,24 @@ public static void v7() {
             .include(V7Self.class.getSimpleName())
             .include(V7UuidCreator.class.getSimpleName())
             .include(V7Fasterxml.class.getSimpleName())
-            .threads(6)
+            .threads(threads)
+            .forks(1)
+            .build();
+
+        Collection<RunResult> run = new Runner(options).run();
+        RESULTS.addAll(run);
+    }
+
+    @SneakyThrows
+    public static void secure() {
+        Options options = new OptionsBuilder()
+            .include(V1SelfSecure.class.getSimpleName())
+            .include(V3SelfSecure.class.getSimpleName())
+            .include(V4SelfSecure.class.getSimpleName())
+            .include(V5SelfSecure.class.getSimpleName())
+            .include(V6SelfSecure.class.getSimpleName())
+            .include(V7SelfSecure.class.getSimpleName())
+            .threads(threads)
             .forks(1)
             .build();
 

src/test/java/bench/target/V1SelfSecure.java

@@ -0,0 +1,15 @@
+package bench.target;
+
+import bench.AbstractBench;
+import io.github.honhimw.uuid.UUIDs;
+
+/// @author honhimW
+/// @since 2025-12-10
+public class V1SelfSecure extends AbstractBench {
+
+    @Override
+    public void run() throws Exception {
+        UUIDs.SECURE.V1.next();
+    }
+
+}

src/test/java/bench/target/V3SelfSecure.java

@@ -0,0 +1,16 @@
+package bench.target;
+
+import bench.AbstractBench;
+import bench.Fixtures;
+import io.github.honhimw.uuid.UUIDs;
+
+/// @author honhimW
+/// @since 2025-12-10
+public class V3SelfSecure extends AbstractBench {
+
+    @Override
+    public void run() throws Exception {
+        UUIDs.SECURE.V3.of(Fixtures.NAME);
+    }
+
+}

src/test/java/bench/target/V4SelfSecure.java

@@ -0,0 +1,15 @@
+package bench.target;
+
+import bench.AbstractBench;
+import io.github.honhimw.uuid.UUIDs;
+
+/// @author honhimW
+/// @since 2025-12-10
+public class V4SelfSecure extends AbstractBench {
+
+    @Override
+    public void run() throws Exception {
+        UUIDs.SECURE.V4.next();
+    }
+
+}

src/test/java/bench/target/V5SelfSecure.java

@@ -0,0 +1,16 @@
+package bench.target;
+
+import bench.AbstractBench;
+import bench.Fixtures;
+import io.github.honhimw.uuid.UUIDs;
+
+/// @author honhimW
+/// @since 2025-12-10
+public class V5SelfSecure extends AbstractBench {
+
+    @Override
+    public void run() throws Exception {
+        UUIDs.SECURE.V5.of(Fixtures.NAME);
+    }
+
+}

src/test/java/bench/target/V6SelfSecure.java

@@ -0,0 +1,15 @@
+package bench.target;
+
+import bench.AbstractBench;
+import io.github.honhimw.uuid.UUIDs;
+
+/// @author honhimW
+/// @since 2025-12-10
+public class V6SelfSecure extends AbstractBench {
+
+    @Override
+    public void run() throws Exception {
+        UUIDs.SECURE.V6.next();
+    }
+
+}

src/test/java/bench/target/V7Self.java

@@ -2,17 +2,14 @@
 
 import bench.AbstractBench;
 import io.github.honhimw.uuid.UUIDs;
-import io.github.honhimw.uuid.gen.V7;
 
 /// @author honhimW
 /// @since 2025-12-10
 public class V7Self extends AbstractBench {
 
-    static final V7 V7 = UUIDs.FAST.V7;
-
     @Override
     public void run() throws Exception {
-        V7.next();
+        UUIDs.FAST.V7.next();
     }
 
 }

src/test/java/bench/target/V7SelfSecure.java

@@ -0,0 +1,15 @@
+package bench.target;
+
+import bench.AbstractBench;
+import io.github.honhimw.uuid.UUIDs;
+
+/// @author honhimW
+/// @since 2025-12-10
+public class V7SelfSecure extends AbstractBench {
+
+    @Override
+    public void run() throws Exception {
+        UUIDs.SECURE.V7.next();
+    }
+
+}