HHH-9998 - Continue documentation TLC - mapping identifiers

Author: sebersole

documentation/src/main/docbook/integration/en-US/Hibernate_Integrations.xml

@@ -47,6 +47,10 @@
     <xi:include href="chapters/services/Services.xml" />
 
     <!--
+    org.hibernate.boot.model.IdGeneratorStrategyInterpreter
+
+    custom Session/SessionFactory implementators
+
     <xi:include href="chapters/types/Custom_Types.xml" />
     -->
 

documentation/src/main/docbook/manual/en-US/chapters/portability/Portability.xml

@@ -193,4 +193,8 @@
     JPA portability
     * HQL/JPQL differences
     * naming strategies
+    * basic types
+    * simple id types
+    * generated id types
+    * "embedded composite identifiers"
 </chapter>

documentation/src/main/docbook/mapping/en-US/chapters/basic/Basic_Types.xml

@@ -7,12 +7,15 @@
   ~ See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
   -->
 <chapter xml:id="basic" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
-    <title>Basic Types</title>
-
-    <abstract>
-        This chapter will discuss actual basic type mappings as well as how to override those
-        mappings and provide extra mappings.
-    </abstract>
+    <info>
+        <title>Basic Types</title>
+        <abstract>
+            <para>
+                This chapter will discuss actual basic type mappings as well as how to override those
+                mappings and provide extra mappings.
+            </para>
+        </abstract>
+    </info>
 
     <para>
         Basic value types usually map a single database value, or column, to a single, non-aggregated Java
@@ -1002,7 +1005,7 @@
             <title>UUID as identifier</title>
             <para>
                 Hibernate supports using UUID values as identifiers.  They can even be generated!  For
-                details see the discussion of generators in <xref linkend="identifiers"/>
+                details see the discussion of generators in <xref linkend="identifiers-generators"/>
             </para>
         </section>
     </section>

documentation/src/main/docbook/mapping/en-US/chapters/id/Identifiers.xml

@@ -0,0 +1,8 @@
+@Entity
+public class MyEntity {
+	@Id
+	@GeneratedValue(generation=SEQUENCE, name="my_sequence")
+	@SequenceGenerator( name = "my_sequence", schema = "globals", allocationSize = 30 )
+	public Integer id;
+	...
+}

documentation/src/main/docbook/mapping/en-US/chapters/id/extras/ConfiguredSequence.java

@@ -0,0 +1,7 @@
+@Entity
+public class MyEntity {
+	@Id
+	@GeneratedValue(generation=SEQUENCE, name="my_sequence")
+	public Integer id;
+	...
+}

documentation/src/main/docbook/mapping/en-US/chapters/id/extras/NamedSequence.java

@@ -0,0 +1,6 @@
+@Entity
+public class MyEntity {
+	@Id
+	public Integer id;
+	...
+}

documentation/src/main/docbook/mapping/en-US/chapters/id/extras/SimpleAssigned.java

@@ -0,0 +1,7 @@
+@Entity
+public class MyEntity {
+	@Id
+	@GeneratedValue
+	public Integer id;
+	...
+}

documentation/src/main/docbook/mapping/en-US/chapters/id/extras/SimpleGenerated.java

@@ -0,0 +1,4 @@
+create table hibernate_sequences(
+    sequence_name VARCHAR NOT NULL,
+    next_val INTEGER NOT NULL
+)

documentation/src/main/docbook/mapping/en-US/chapters/id/extras/TableGenerator.sql

@@ -0,0 +1,17 @@
+@Entity
+public class MyEntity {
+	@Id
+	@GeneratedValue( generator="uuid" )
+	@GenericGenerator(
+			name="uuid",
+			strategy="org.hibernate.id.UUIDGenerator",
+			parameters = {
+					@Parameter(
+							name="uuid_gen_strategy_class",
+							value="org.hibernate.id.uuid.CustomVersionOneStrategy"
+					)
+			}
+	)
+	public UUID id;
+	...
+}