Add Hibernate 7 batches 2-6, batch 7, and batch 8: mapping styles, JPA annotations, natural IDs, @Immutable, stored procedures, in-memory test databases, JNDI mocking, proxies, associations, temporal mapping, named queries, HQL, Criteria API, EntityManager bootstrapping, Ehcache 3 L2 cache configuration, HikariCP connection pooling, Hibernate Validator CDI integration, aggregate functions, sorting, pagination, interceptors, and Hibernate Search 8 (Hibernate 7.4.5.Final + Spring Boot 4.1.1 + JDK 25)

2026-09-20 06:06:42 +00:00
commit 8568c0ce6c
330 changed files with 23668 additions and 0 deletions
@@ -0,0 +1,25 @@
+package com.ankurm.hibernatedemo.namedquery;
+
+/** JPQL/native constructor-result projection target. Plain class version. */
+public class EmployeeDto {
+    private final Long id;
+    private final String firstName;
+
+    public EmployeeDto(Long id, String firstName) {
+        this.id = id;
+        this.firstName = firstName;
+    }
+
+    public Long getId() {
+        return id;
+    }
+
+    public String getFirstName() {
+        return firstName;
+    }
+
+    @Override
+    public String toString() {
+        return "EmployeeDto{id=%s, firstName=%s}".formatted(id, firstName);
+    }
+}
@@ -0,0 +1,8 @@
+package com.ankurm.hibernatedemo.namedquery;
+
+/**
+ * Jakarta Persistence 3.2 alternative to a hand-written DTO class: does a Java {@code record}
+ * work directly as a JPQL constructor-expression result? Tested in NamedQueryExecutionTest.
+ */
+public record EmployeeRecordDto(Long id, String firstName) {
+}
@@ -0,0 +1,38 @@
+package com.ankurm.hibernatedemo.namedquery;
+
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import org.hibernate.annotations.NamedQuery;
+
+/**
+ * Uses {@code org.hibernate.annotations.NamedQuery} (the Hibernate extension, not the JPA
+ * standard one) specifically to exercise an extra it offers that JPA's does not:
+ * {@code cacheable = true}. Docs: 14-named-queries.md, chapter "jakarta vs hibernate NamedQuery".
+ */
+@Entity
+@Table(name = "hib_extra_employee")
+@NamedQuery(name = "HibernateExtraEmployee.cacheableFindAll",
+        query = "SELECT e FROM HibernateExtraEmployee e",
+        cacheable = true)
+public class HibernateExtraEmployee {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    private String name;
+
+    protected HibernateExtraEmployee() {
+    }
+
+    public HibernateExtraEmployee(String name) {
+        this.name = name;
+    }
+
+    public Long getId() {
+        return id;
+    }
+}
@@ -0,0 +1,72 @@
+package com.ankurm.hibernatedemo.namedquery;
+
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.NamedQueries;
+import jakarta.persistence.NamedQuery;
+import jakarta.persistence.NamedNativeQueries;
+import jakarta.persistence.NamedNativeQuery;
+import jakarta.persistence.SqlResultSetMapping;
+import jakarta.persistence.ConstructorResult;
+import jakarta.persistence.ColumnResult;
+import jakarta.persistence.Table;
+
+/**
+ * Backs ankurm.com post 4877. Docs: 14-named-queries.md.
+ *
+ * <p>{@code Employee.findByName} is a valid JPA {@code @NamedQuery}, {@code Employee.byNativeDto}
+ * is a {@code @NamedNativeQuery} + {@code @SqlResultSetMapping} into {@link EmployeeDto} via
+ * {@code @ConstructorResult}.
+ */
+@Entity
+@Table(name = "nq_employee")
+@NamedQueries({
+        @NamedQuery(name = "Employee.findByName", query = "SELECT e FROM NqEmployee e WHERE e.firstName = :name"),
+        @NamedQuery(name = "Employee.findAllActive", query = "SELECT e FROM NqEmployee e WHERE e.status = 'ACTIVE' ORDER BY e.id DESC")
+})
+@NamedNativeQueries({
+        @NamedNativeQuery(
+                name = "Employee.byNativeDto",
+                query = "SELECT id, first_name AS firstName FROM nq_employee WHERE status = :status",
+                resultSetMapping = "EmployeeDtoMapping")
+})
+@SqlResultSetMapping(
+        name = "EmployeeDtoMapping",
+        classes = @ConstructorResult(
+                targetClass = EmployeeDto.class,
+                columns = {
+                        @ColumnResult(name = "id", type = Long.class),
+                        @ColumnResult(name = "firstName", type = String.class)
+                }))
+public class NqEmployee {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    private String firstName;
+
+    private String status;
+
+    protected NqEmployee() {
+    }
+
+    public NqEmployee(String firstName, String status) {
+        this.firstName = firstName;
+        this.status = status;
+    }
+
+    public Long getId() {
+        return id;
+    }
+
+    public String getFirstName() {
+        return firstName;
+    }
+
+    public String getStatus() {
+        return status;
+    }
+}
@@ -0,0 +1,46 @@
+package com.ankurm.hibernatedemo.namedquery;
+
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.NamedQuery;
+import jakarta.persistence.Table;
+
+/**
+ * Has one {@code @NamedQuery} defined via annotation ({@code XmlQueryEmployee.findBySalaryAbove})
+ * AND one defined via {@code orm.xml} ({@code XmlQueryEmployee.findBySalaryAboveXml}), plus an
+ * XML-defined query that OVERRIDES a same-named annotated one
+ * ({@code XmlQueryEmployee.overridden}) -- see src/main/resources/META-INF/orm.xml. Docs:
+ * 14-named-queries.md, chapter "Named queries in orm.xml".
+ */
+@Entity
+@Table(name = "xml_query_employee")
+@NamedQuery(name = "XmlQueryEmployee.findBySalaryAbove", query = "SELECT e FROM XmlQueryEmployee e WHERE e.salary > :min")
+@NamedQuery(name = "XmlQueryEmployee.overridden", query = "SELECT e FROM XmlQueryEmployee e WHERE e.salary < 0") // deliberately wrong; orm.xml should win
+public class XmlQueryEmployee {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    private String name;
+
+    private double salary;
+
+    protected XmlQueryEmployee() {
+    }
+
+    public XmlQueryEmployee(String name, double salary) {
+        this.name = name;
+        this.salary = salary;
+    }
+
+    public Long getId() {
+        return id;
+    }
+
+    public String getName() {
+        return name;
+    }
+}