Generate and parse ULIDs in Crockford base32 text and binary representations.
See ULID specification for more info
This is the Humand fork of jaspeen/ulid-java, published to Humand CodeArtifact as co.humand.io.github.jaspeen:ulid-java.
Fork changes:
ULID.randomV7()generates UUIDv7-compatible ULIDs0.3.0-hu+ requires Hibernate ORM 7 (newIdentifierGeneratorAPIs); Hibernate 6 users should stay on0.2.1-hu
- Java 17+
- API similar to java.util.UUID
- Optional monotonic generator
- Optional hibernate type and ID generator (requires hibernate 7.x)
<dependency>
<groupId>co.humand.io.github.jaspeen</groupId>
<artifactId>ulid-java</artifactId>
<version>0.3.0-hu</version>
</dependency>ULID ulid = ULID.randomV7();
String crockfordBase32 = ulid.toString();
byte[] binary = ulid.toBytes();ULID parsedFromString = ULID.fromString("3ZFXZQYZVZFXZQYZVZFXZQYZVZ");
ULID parsedFromBytes = ULID.fromBytes(
new byte[] {127, 127, 127, 127, 127, 127, 127, 127, 127, 127, 127, 127, 127, 127, 127, 127});
assertEquals(parsedFromString, parsedFromBytes);ULID.randomV7().toUUID();
ULID.fromUUID(UUID.randomUUID());MonotonicULID.random();Hibernate is not added as transitive dependency, it should be specified additionally
@Entity
class ULIDEntity {
@Id
@GeneratedValue(generator = "ulid")
@GenericGenerator(name = "ulid", strategy = "io.github.jaspeen.ulid.hibernate.ULIDIdGenerator")
private ULID id;
}
// This will generate UUID using ULID algorithm providing ordered keys
// while keeping other stuff same
@Entity
class UUIDEntity {
@Id
@GeneratedValue(generator = "ulid")
@GenericGenerator(name = "ulid", strategy = "io.github.jaspeen.ulid.hibernate.ULIDIdGenerator")
private UUID id;
}Generator can be defined in package-info.java for all entities instead of field annotation in every entity
@GenericGenerator(name = "ulid", strategy = "io.github.jaspeen.ulid.hibernate.ULIDIdGenerator")
package my.service.model;
import org.hibernate.annotations.GenericGenerator;For java 8 and hibernate 5 use verions 0.1.x