Metode Kueri Turunan dan Resolusi Kata Kunci
Bangun kueri repositori kompleks hanya dari nama metode menggunakan tata bahasa kata kunci properti Spring Data.
Metode Kueri Turunan dan Resolusi Kata Kunci adalah pelajaran Spring Boot 4 Complete Guide gratis di CoddyKit. Ini adalah pelajaran 1 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Spring Boot 4 Complete Guide, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Spring Boot 4 Complete Guide mencakup 4 pelajaran total.
Bagian dari pelajaran ini belum diterjemahkan dan ditampilkan dalam bahasa Inggris.
What Are Derived Query Methods?
Spring Data JPA can generate a full SQL query just by reading the name of a repository method. You write the method signature, leave the body to the framework, and Spring parses the name into a query at startup.
- No
@Queryannotation needed - No hand-written JPQL or SQL
- The method name is the query specification
This is called a derived query method, because the query is derived from the method name.
public interface UserRepository extends JpaRepository<User, Long> {
// Spring derives: SELECT u FROM User u WHERE u.email = ?1
User findByEmail(String email);
}The Subject and the Predicate
Every derived method name splits into two parts:
- The subject (an introducer like
findBy,readBy,queryBy,getBy) which tells Spring what action to perform. - The predicate (everything after
By) which becomes the WHERE clause.
In findByLastName, find is the subject and LastName is the predicate that maps to the lastName entity property.
public interface CustomerRepository extends JpaRepository<Customer, Long> {
List<Customer> findByLastName(String lastName);
List<Customer> readByCity(String city); // 'readBy' works too
Customer getById(Long id); // 'getBy' works too
}Combining Conditions with And / Or
You chain multiple properties using the keywords And and Or. Each property name in the chain must match an entity field, and the method parameters are bound left-to-right in the same order they appear.
findByFirstNameAndLastName→WHERE first_name = ?1 AND last_name = ?2findByCityOrCountry→WHERE city = ?1 OR country = ?2
public interface CustomerRepository extends JpaRepository<Customer, Long> {
List<Customer> findByFirstNameAndLastName(String firstName, String lastName);
List<Customer> findByCityOrCountry(String city, String country);
}Comparison Keywords
Beyond equality, Spring Data understands a rich set of comparison keywords appended after the property name:
LessThan,LessThanEqual,GreaterThan,GreaterThanEqualBetween— needs two parametersBefore,After— handy for dates
The keyword binds to the property right before it, so findByAgeGreaterThan targets the age property.
public interface ProductRepository extends JpaRepository<Product, Long> {
List<Product> findByPriceLessThan(BigDecimal max);
List<Product> findByPriceBetween(BigDecimal low, BigDecimal high);
List<Product> findByCreatedAtAfter(LocalDateTime since);
}Null, True, and Boolean Keywords
Some keywords take no parameter at all because the condition is baked into the name:
IsNull/IsNotNull→IS NULL/IS NOT NULLTrue/False→ compares a boolean property totrue/false
Notice that findByActiveTrue() has an empty parameter list — the value is fixed by the keyword.
public interface AccountRepository extends JpaRepository<Account, Long> {
List<Account> findByDeletedAtIsNull();
List<Account> findByActiveTrue();
List<Account> findByActiveFalse();
}String Matching Keywords
For text columns, Spring Data offers keywords that translate into LIKE patterns:
Like— you supply the wildcards (%) yourselfStartingWith— appends%automaticallyEndingWith— prepends%Containing— wraps the value in%value%IgnoreCase— makes the comparison case-insensitive
public interface CustomerRepository extends JpaRepository<Customer, Long> {
List<Customer> findByEmailContaining(String fragment);
List<Customer> findByLastNameStartingWith(String prefix);
List<Customer> findByLastNameIgnoreCase(String lastName);
}Ordering Results with OrderBy
You can embed sorting directly in the method name using OrderBy followed by the property and a direction (Asc or Desc). It goes at the very end of the predicate.
findByLastNameOrderByFirstNameAscfindByActiveTrueOrderByCreatedAtDesc
For dynamic sorting at call time, prefer passing a Sort parameter instead of hard-coding it in the name.
public interface CustomerRepository extends JpaRepository<Customer, Long> {
List<Customer> findByLastNameOrderByFirstNameAsc(String lastName);
// Dynamic sort, supplied by the caller
List<Customer> findByCity(String city, Sort sort);
}Limiting with First and Top
To restrict how many rows come back, add First or Top right after the subject. They are interchangeable, and an optional number sets the limit.
findFirstByOrderByCreatedAtDesc→ the single newest rowfindTop3ByCategory→ at most 3 rows for that category
Combined with OrderBy this is the idiomatic way to fetch "the latest N" records.
public interface OrderRepository extends JpaRepository<Order, Long> {
Order findFirstByCustomerIdOrderByPlacedAtDesc(Long customerId);
List<Order> findTop5ByStatusOrderByPlacedAtDesc(String status);
}Traversing Nested Properties
Derived queries can reach into related entities. If Order has a Customer and the customer has an address.city, you can write findByCustomerAddressCity.
Spring resolves the path greedily, splitting on camel-case humps. When a property name is itself ambiguous (e.g. a field literally named customerAddress), insert an underscore to make the boundary explicit: findByCustomer_AddressCity.
public interface OrderRepository extends JpaRepository<Order, Long> {
// Order -> customer -> address -> city
List<Order> findByCustomerAddressCity(String city);
// Explicit traversal boundary with underscore
List<Order> findByCustomer_AddressCity(String city);
}Counting, Existence, and Deletion
The subject keyword controls the operation, not just selection. Beyond find, you can derive:
countBy...→ returns alongexistsBy...→ returns abooleandeleteBy.../removeBy...→ deletes matching rows (use with@Transactional)
The predicate grammar is identical; only the return type and the action change.
public interface UserRepository extends JpaRepository<User, Long> {
long countByActiveTrue();
boolean existsByEmail(String email);
@Transactional
long deleteByLastLoginBefore(LocalDateTime cutoff);
}How Keyword Resolution Actually Works
At application startup, Spring Data parses each method name into a PartTree. For every segment it tries the longest matching property path first, then peels off trailing keywords.
- It validates each property against the entity's metamodel — a typo like
findByemaillfails fast withPropertyReferenceException. - Because parsing happens at startup, broken method names break the context immediately, not at first call.
This pure-Java example shows the same camel-case splitting idea the parser uses.
public class PartTreeDemo {
public static void main(String[] args) {
String predicate = "FirstNameAndLastName";
String[] parts = predicate.split("And");
for (String p : parts) {
// Lower-case the first letter to get the property name
String prop = Character.toLowerCase(p.charAt(0)) + p.substring(1);
System.out.println("Property: " + prop);
}
}
}Quick Check
You need a repository method that returns the 3 most recently placed orders for a given status, newest first. Which derived method name is correct?
Recap
You now know how to build queries straight from method names:
- Subject (
find/read/get/count/exists/delete) sets the operation; predicate afterBybecomes the WHERE clause. - Combine fields with
And/Or; compare withLessThan,Between,After; match text withContaining,StartingWith,IgnoreCase. - Parameter-free keywords:
IsNull,True,False. - Sort with
OrderBy...Asc/Desc(or aSortparam); limit withFirst/Top[N]. - Traverse relations (
findByCustomerAddressCity, use_to disambiguate). - Spring parses names into a PartTree at startup, so invalid property paths fail fast.
For very long or complex names, switch to @Query — readability beats cleverness.
Pertanyaan yang Sering Diajukan
Apakah pelajaran “Metode Kueri Turunan dan Resolusi Kata Kunci” gratis?
Ya — teks lengkap “Metode Kueri Turunan dan Resolusi Kata Kunci” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Spring Boot 4 Complete Guide, upgrade ke CoddyKit PRO. Kursus Spring Boot 4 Complete Guide mencakup 4 pelajaran total.
Apa yang akan aku pelajari di “Metode Kueri Turunan dan Resolusi Kata Kunci”?
Bangun kueri repositori kompleks hanya dari nama metode menggunakan tata bahasa kata kunci properti Spring Data. Kamu berlatih Spring Boot 4 Complete Guide dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.
Apakah aku perlu pengalaman untuk memulai Spring Boot 4 Complete Guide?
Tidak diperlukan pengalaman sebelumnya. Spring Boot 4 Complete Guide di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 1 dari 4.
Berapa lama pelajaran “Metode Kueri Turunan dan Resolusi Kata Kunci” memakan waktu?
Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.
Bisakah aku menulis dan menjalankan kode dalam pelajaran Spring Boot 4 Complete Guide ini?
Ya. Setiap pelajaran Spring Boot 4 Complete Guide menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.
Semua pelajaran dalam kursus ini
- Metode Kueri Turunan dan Resolusi Kata Kunci
- Kueri JPQL dan Native dengan @Query
- Spesifikasi dan Penyaringan Dinamis Berbasis Kriteria
- Paginasi, Pengurutan, dan Streaming Potongan