Developer Documentation
Java
Updated September 19, 2026

Generate and Work with GUIDs in Java

Generate, parse, format, and validate GUID/UUID values in Java.

A GUID is Microsoft terminology for a 128-bit globally unique identifier. In practice, the canonical textual form is compatible with UUID formatting, although platform APIs may expose additional GUID-specific formats.

Quick Start#

The following example uses the standard Java API or a widely used package for this task.

Quick start#

Java
1import java.util.UUID;23UUID id = UUID.randomUUID();4System.out.println(id);

Common Operations#

This second pattern covers a common production operation or a safer way to handle real input.

Parsing and validation#

Java
1try {2    UUID parsed = UUID.fromString(input);3    System.out.println(parsed.toString());4} catch (IllegalArgumentException ex) {5    System.out.println("Invalid GUID/UUID");6}

Important Notes#

Java exposes the type as UUID, not GUID; use the canonical hyphenated representation when exchanging values with .NET services.

Best Practices#

  1. Treat external input as untrusted and handle parse/validation errors explicitly.
  2. Keep encoding, units, formats, and library-specific mapping rules explicit at system boundaries.
  3. Add test vectors that cover empty input, Unicode text, malformed input, and representative production data.

References#

Implement GUID in other languages: