diff --git a/CHANGELOG.md b/CHANGELOG.md index 84f72ce..8af5cf7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,13 @@ All notable changes to this project will be documented in this file. Nothing unreleased. +## [6.1.0] - 2025-xx-xx + +- Added microsecond precision to UUIDv7 when available; +- Added methods to `GUID`; +- Refactored many classes; +- Updated som tests. + ## [6.0.0] - 2024-07-07 This version has breaking changes. diff --git a/README.md b/README.md index e2e4185..0c1ec5b 100644 --- a/README.md +++ b/README.md @@ -44,14 +44,14 @@ Maven: com.github.f4b6a3 uuid-creator - 6.0.0 + 6.1.0 ``` Gradle: ``` -implementation 'com.github.f4b6a3:uuid-creator:6.0.0' +implementation 'com.github.f4b6a3:uuid-creator:6.1.0' ``` See more options in [maven.org](https://search.maven.org/artifact/com.github.f4b6a3/uuid-creator). @@ -147,14 +147,21 @@ GUID guid = GUID.v6(); GUID guid = GUID.v7(); ``` -You can generate JDK's UUIDs using GUID's API. For example, you can generate a JDK's UUID version 7 with this simple statement: +You can generate random-based GUIDs by passing an instance of `SecureRandom` as a parameter: + +```java +GUID guid = GUID.v4(new SecureRandom()); +``` + +You can also generate JDK's UUIDs using GUID's API. For example, you can generate a JDK's UUID version 7 with this simple statement: ```java UUID uuid = GUID.v7().toUUID(); ``` > **NOTE:** -> It uses a **non-cryptographic** PRNG. So it doesn't block when generating random-based UUIDs. However, it is not recommended when the security provided by “cryptographic quality” generators is considered necessary. +> It uses by default a **non-cryptographic** PRNG. So it doesn't block when generating random-based UUIDs. However, it is not recommended when the security provided by “cryptographic quality” generators is considered necessary. In this case, you can pass a `SecureRandom` instance as a parameter to any method that expects it. + Other identifier generators ------------------------------------------------------