Close

JPA Criteria API - Case Expressions with CriteriaBuilder.selectCase()

[Last Updated: Aug 11, 2020]

JPA Criteria API supports both simple and general case expressions.

Following methods/interfaces of CriteriaBuilder can be used to build case expressions.

package javax.persistence.criteria;
.........
public interface CriteriaBuilder {
   .........
    //Interface used to build simple case expressions.
    public static interface SimpleCase<C,R> extends Expression<R> {
    	  Expression<C> getExpression();
	  SimpleCase<C, R> when(C condition, R result);
	  SimpleCase<C, R> when(C condition, Expression<? extends R> result);
	  Expression<R> otherwise(R result);
	  Expression<R> otherwise(Expression<? extends R> result);
	}
	
   //Create a simple case expression.
   <C, R> SimpleCase<C,R> selectCase(Expression<? extends C> expression);

    //Interface used to build general case expressions
    public static interface Case<R> extends Expression<R> {
	  Case<R> when(Expression<Boolean> condition, R result);
	  Case<R> when(Expression<Boolean> condition, Expression<? extends R> result);
	  Expression<R> otherwise(R result);
	  Expression<R> otherwise(Expression<? extends R> result);
	}
	
    //Create a general case expression.
    <R> Case<R> selectCase();
   .........
}

Quick Example

Simple case expression:

  CriteriaQuery<Object[]> query = criteriaBuilder.createQuery(Object[].class);
  Root<Employee> employee = query.from(Employee.class);
  query.multiselect(employee.get(Employee_.name),
          employee.get(Employee_.salary),
          criteriaBuilder.selectCase(employee.get(Employee_.DEPT))
                         .when("IT", "Information Technology")
                         .when("Admin", "Administration")
                         .otherwise(employee.get(Employee_.DEPT))
  );
  //The equivalent JPQL
   /* SELECT e.name, e.salary,
                   CASE e.dept
                   WHEN 'IT' THEN 'Information Technology'
                   WHEN 'Admin' THEN 'Administration'
                   ELSE e.dept
                   END
                   FROM Employee e*/
  List<Object[]> resultList = entityManager.createQuery(query).getResultList();

General case expression:

  CriteriaQuery<Object[]> query = criteriaBuilder.createQuery(Object[].class);
  Root<Employee> employee = query.from(Employee.class);
  query.multiselect(employee.get(Employee_.name),
          employee.get(Employee_.salary),
          criteriaBuilder.selectCase()
                         .when(criteriaBuilder
                                 .equal(employee.get(Employee_.DEPT), "IT"), "Information Technology")
                         .when(criteriaBuilder.equal(employee.get(Employee_.DEPT), "Admin"), "Administration")
                         .otherwise(employee.get(Employee_.DEPT))
  );
  //The equivalent JPQL
   /* SELECT e.name, e.salary,
                   CASE
                   WHEN e.dept='IT' THEN 'Information Technology'
                   WHEN e.dept='Admin' THEN 'Administration'
                   ELSE e.dept
                   END
                   FROM Employee e*/
  List<Object[]> resultList = entityManager.createQuery(query).getResultList();

Complete Example

JPA Entity

@Entity
public class Employee {
    @Id
    @GeneratedValue
    private long id;
    private String name;
    private double salary;
    private String dept;
    .............
}

Using selectCase() methods

public class ExampleMain {
    private static EntityManagerFactory entityManagerFactory =
            Persistence.createEntityManagerFactory("example-unit");

    public static void main(String[] args) {
        try {
            persistEmployees();
            findAllEmployeesViaSimpleCase();
            findAllEmployeesViaGeneralCase();
            findAllEmployeesSalaryViaGeneralCase();
        } finally {
            entityManagerFactory.close();
        }
    }

    private static void findAllEmployeesViaSimpleCase() {
        EntityManager entityManager = entityManagerFactory.createEntityManager();
        System.out.println("-- Finding all employees with simple case --");
        CriteriaBuilder criteriaBuilder = entityManager.getCriteriaBuilder();
        CriteriaQuery<Object[]> query = criteriaBuilder.createQuery(Object[].class);
        Root<Employee> employee = query.from(Employee.class);
        query.multiselect(employee.get(Employee_.name),
                employee.get(Employee_.salary),
                criteriaBuilder.selectCase(employee.get(Employee_.DEPT))
                               .when("IT", "Information Technology")
                               .when("Admin", "Administration")
                               .otherwise(employee.get(Employee_.DEPT))
        );
        //The equivalent JPQL
         /* SELECT e.name, e.salary,
                         CASE e.dept
                         WHEN 'IT' THEN 'Information Technology'
                         WHEN 'Admin' THEN 'Administration'
                         ELSE e.dept
                         END
                         FROM Employee e*/
        List<Object[]> resultList = entityManager.createQuery(query).getResultList();
        resultList.forEach(arr -> System.out.println(Arrays.toString(arr)));
        entityManager.close();
    }

    private static void findAllEmployeesViaGeneralCase() {
        EntityManager entityManager = entityManagerFactory.createEntityManager();
        System.out.println("-- Finding all employees with general case --");
        CriteriaBuilder criteriaBuilder = entityManager.getCriteriaBuilder();
        CriteriaQuery<Object[]> query = criteriaBuilder.createQuery(Object[].class);
        Root<Employee> employee = query.from(Employee.class);
        query.multiselect(employee.get(Employee_.name),
                employee.get(Employee_.salary),
                criteriaBuilder.selectCase()
                               .when(criteriaBuilder
                                       .equal(employee.get(Employee_.DEPT), "IT"), "Information Technology")
                               .when(criteriaBuilder.equal(employee.get(Employee_.DEPT), "Admin"), "Administration")
                               .otherwise(employee.get(Employee_.DEPT))
        );
        //The equivalent JPQL
         /* SELECT e.name, e.salary,
                         CASE
                         WHEN e.dept='IT' THEN 'Information Technology'
                         WHEN e.dept='Admin' THEN 'Administration'
                         ELSE e.dept
                         END
                         FROM Employee e*/
        List<Object[]> resultList = entityManager.createQuery(query).getResultList();
        resultList.forEach(arr -> System.out.println(Arrays.toString(arr)));
        entityManager.close();
    }

    private static void findAllEmployeesSalaryViaGeneralCase() {
        EntityManager entityManager = entityManagerFactory.createEntityManager();
        System.out.println("-- Finding all employees salary with general case --");
        CriteriaBuilder criteriaBuilder = entityManager.getCriteriaBuilder();
        CriteriaQuery<Object[]> query = criteriaBuilder.createQuery(Object[].class);
        Root<Employee> employee = query.from(Employee.class);
        query.multiselect(employee.get(Employee_.name),
                employee.get(Employee_.salary),
                criteriaBuilder.selectCase()
                               .when(criteriaBuilder.lessThan(employee.get(Employee_.SALARY), 3000),
                                       "Salary Less than 3000")
                               .when(criteriaBuilder.between(employee.get(Employee_.SALARY), 3000, 4000),
                                       "Salary between 3000 and 4000")
                               .otherwise("Salary more than 4000")
        );

        List<Object[]> resultList = entityManager.createQuery(query).getResultList();
        resultList.forEach(arr -> System.out.println(Arrays.toString(arr)));
        entityManager.close();
    }


    public static void persistEmployees() {
        Employee employee1 = Employee.create("Diana", 2000, "IT");
        Employee employee2 = Employee.create("Rose", 3000, "Admin");
        Employee employee3 = Employee.create("Denise", 2500, "Admin");
        Employee employee4 = Employee.create("Mike", 4000, "IT");
        Employee employee5 = Employee.create("Linda", 4500, "Sales");
        EntityManager em = entityManagerFactory.createEntityManager();
        em.getTransaction().begin();
        em.persist(employee1);
        em.persist(employee2);
        em.persist(employee3);
        em.persist(employee4);
        em.persist(employee5);
        em.getTransaction().commit();
        em.close();
        System.out.println("-- employee persisted --");
        System.out.println(employee1);
        System.out.println(employee2);
        System.out.println(employee3);
        System.out.println(employee4);
        System.out.println(employee5);
    }
}
-- employee persisted --
Employee{id=1, name='Diana', salary=2000.0, dept='IT'}
Employee{id=2, name='Rose', salary=3000.0, dept='Admin'}
Employee{id=3, name='Denise', salary=2500.0, dept='Admin'}
Employee{id=4, name='Mike', salary=4000.0, dept='IT'}
Employee{id=5, name='Linda', salary=4500.0, dept='Sales'}
-- Finding all employees with simple case --
[Diana, 2000.0, Information Technology]
[Rose, 3000.0, Administration]
[Denise, 2500.0, Administration]
[Mike, 4000.0, Information Technology]
[Linda, 4500.0, Sales]
-- Finding all employees with general case --
[Diana, 2000.0, Information Technology]
[Rose, 3000.0, Administration]
[Denise, 2500.0, Administration]
[Mike, 4000.0, Information Technology]
[Linda, 4500.0, Sales]
-- Finding all employees salary with general case --
[Diana, 2000.0, Salary Less than 3000]
[Rose, 3000.0, Salary between 3000 and 4000]
[Denise, 2500.0, Salary Less than 3000]
[Mike, 4000.0, Salary between 3000 and 4000]
[Linda, 4500.0, Salary more than 4000]

Example Project

Dependencies and Technologies Used:

  • h2 1.4.199: H2 Database Engine.
  • hibernate-core 5.4.2.Final: Hibernate's core ORM functionality.
    Implements javax.persistence:javax.persistence-api version 2.2
  • hibernate-jpamodelgen 5.4.2.Final: Annotation Processor to generate JPA 2 static metamodel classes.
  • CriteriaBuilder.selectCase() Examples
  • JDK 1.8
  • Maven 3.5.4

CriteriaBuilder.selectCase() Examples Select All Download
  • jpa-criteria-api-case-expressions
    • src
      • main
        • java
          • com
            • logicbig
              • example
                • ExampleMain.java
          • resources
            • META-INF

    See Also