Package tk.airshipcraft.commonlib.utils

Class FastUUID

java.lang.Object
tk.airshipcraft.commonlib.utils.FastUUID
public class FastUUID extends Object
A utility class for efficient parsing of UUID instances from strings and for converting UUID instances to strings. The provided methods are optimized for high performance and minimal garbage collection overhead. Benchmarks have shown that parseUUIDDashed(CharSequence) is significantly faster than UUID.fromString(String), and toStringDashed(UUID) outperforms UUID.toString() in Java 8 and older. In Java 9 and newer, parseUUIDDashed(CharSequence) remains faster, while toStringDashed(UUID) is comparable to the JDK's implementation.

This class is particularly useful in high-throughput environments where UUID operations are a bottleneck.

The class also includes methods to handle undashed UUID strings.

Since:
2023-06-23
Version:
1.0.0
Author:
Jon Chambers, notzune

  • Method Details

    • parseUUIDDashed

      public static UUID parseUUIDDashed(CharSequence uuidSequence)
      Parses a UUID from the given character sequence. The character sequence must represent a UUID as described in UUID.toString().
      Parameters:
      uuidSequence - the character sequence from which to parse a UUID
      Returns:
      the UUID represented by the given character sequence
      Throws:
      IllegalArgumentException - if the given character sequence does not conform to the string representation as described in UUID.toString()

    • parseUUIDUUndashed

      public static UUID parseUUIDUUndashed(CharSequence uuidSequence)
      Parses a UUID from a character sequence without dashes.
      Parameters:
      uuidSequence - The character sequence to parse.
      Returns:
      The UUID represented by the character sequence.
      Throws:
      IllegalArgumentException - If the sequence is not exactly 32 characters long.

    • toStringDashed

      public static String toStringDashed(UUID uuid)
      Returns a string representation of the given UUID. The returned string is formatted as described in UUID.toString().
      Parameters:
      uuid - the UUID to represent as a string
      Returns:
      a string representation of the given UUID

    • toStringUndashed

      public static String toStringUndashed(UUID uuid)
      Returns a string representation of the given UUID. The returned string is formatted as described in UUID.toString() without dashes.
      Parameters:
      uuid - the UUID to represent as a string
      Returns:
      a string representation of the given UUID