EclipseLink/UserGuide/JPA/Basic JPA Development/Entities/Ids/UuidGenerator

EclipseLink JPA

• EclipseLink Destinations:
• Documentation
• FAQ
• Examples
• Development

Key API

• @GeneratedValue
• @UuidGenerator

@UuidGenerator

You can use the @UuidGenerator to generate an object's Id based on a Universally Unique IDentifier (UUID). A UUID is a globally unique id. A UUID does not require database access, so is efficient to generate, but is a large value, so requires more storage than a numeric id. A UUID can be stored as a String (32 bytes) or a byte[] (16 bytes). UUIDs are useful in distributed architectures as they do not require a single generation point.

@UuidGeneratorAttributes

Attribute	Description	Default	Required?
name	The name of the generator must match the name of a GeneratedValue.		Yes

Example: @UuidGenerator

 @Entity
 public class Employee implements Serializable {
     ...
     @Id
     @UuidGenerator(name="UUID")
     @GeneratorValue(generator="UUID")
     @Column(name="EMP_ID")
     public String getId() {
         return id;
     }
     ...
 }

Example: Using <sequence-generator>

<entity class="Employee">
    <attributes>
        <id name="id">
            <column name="EMP_ID"/>
            <generated-value generator="UUID"/>
            <uuid-generator name="UUID"/>
        </id>
        ...
    </attributes>
</entity>

Version: 2.4 DRAFT
Other versions...

@SequenceGenerator	Configuring Entities	@Table
EclipseLink Home JPA User Guide: Table of Contents, Search
How to contribute to this guide...