Salah satu tambahan terbesar dari spesifikasi JPA (Java Persistence API) versi 2.0 adalah criteria query. Dirilis pada Desember 2009, JPA 2.0 menyediakan API baru yang memungkinkan penggunaan criteria query, meskipun kita tahu pada framework ORM seperti Hibernate sudah terlebih dahulu menyediakan criteria query sejak versi 3.0. Hmm, bagaimanapun JPA adalah spesifikasi standard untuk Persistence yang mana dengan JPA kita bisa memilih JPA provider seperti Hibernate, EclipseLink, OpenJPA, DataNucleus, ataupun ObjectDB sesuka hati tanpa perlu mengganti banyak konfigurasi karena seluruh abstraksi ada di bawah package javax.persistence.*

Pada postingan kali ini saya akan mengulas tentang penggunaan Criteria Query pada JPA (dengan Hibernate sebagai persistence provider) dan Qriteria Query pada Hibernate (native).

Sedikit berbeda dengan JPA 1.0, walaupun diklaim sebagai vendor-independent, kita tidak akan menemukan javax.persistence:javax.persistence:2.0 pada Maven Central, melainkan kita harus mencarinya pada masing-masing ORM vendor. Sebagai contoh jika kita menggunakan hibernate maka artifact untuk JPA 2.0 adalah

1
2
3
4
5
6
7

<dependency>
  <groupid>org.hibernate.javax.persistence</groupid>
  <artifactid>hibernate-jpa-2.0-api</artifactid>
  <version>1.0.0.Final</version>
  <type>jar</type>
  <scope>compile</scope>
</dependency>

Oke marilah langsung saja kita menuju ke area perangnya, dimisalkan saya memiliki sebuah entity (karyawan).

1
2
3
4
5
6
7
8
9

@Entity
@Table(name = "pegawai")
public class Pegawai {
  private long id;
  private String nama;
  private String telepon;
  private String alamat;
  // getter dan setter
}

Selanjutnya mari membuat sebuah JPA Query untuk menangani sebuah pencarian berdasarkan nama atau alamat pegawai.

1

SELECT p FROM Pegawai WHERE p.nama LIKE :nama OR p.alamat LIKE :alamat

Criteria Query

Hibernate

Citeria query pada hibernate umunya cukup mudah, kita tinggal mendefinisikan class entity pada saat pembuatan criteria, kemudian memasukkan masing-masing ekspresi menggunakan class org.hibernate.Criterion.

1
2
3
4
5
6
7

public List<pegawai> getKaryawanByCriteriaH(String nama, String alamat) {
  Session session = sessionFactory.getCurrentSession();
  Criteria criteria = session.createCriteria(Pegawai.class);
  criteria.add(Restrictions.like("nama", nama));
  criteria.add(Restrictions.like("alamat", alamat));
  return criteria.list();
}

JPA

1
2
3
4
5
6
7

public List<Pegawai> getKaryawanByCriteria(String nama, String alamat) {
  CriteriaBuilder builder = entityManager.getCriteriaBuilder();
  CriteriaQuery<Pegawai> query = builder.createQuery(Pegawai.class);
  Root <Pegawai> root = query.from(Pegawai.class);
  query.where(builder.like(root.<String>get("nama"), nama), builder.like(root.<String>get("alamat"), alamat));
  return entityManager.createQuery(query).getResultList();
}

Sekilas tidak jauh berbeda citeria query pada Hibernate dengan JPA, akan tetapi sedikit yang terlihat jelas spesifikasi JPA sedikit lebih kompleks (baca: njelimet) dibandingkan criteria query pada Hibernate.

JPA Metamodel

Criteria Query pada JPA berbasiskan metamodel dari class yang telah terdaftar pada Persistence Unit. JPA 2 mendefinisikan typesafe Criteria API baru yang mengizinkan criteria query dibangun secara rapi/kuat. Penggunaan meta model pada JPA dan beberapa metode otomasi pembuatannya akan saya bahas pada postingan selanjutnya.