Spring Data JPA Between Date Example

Hey guys in this post, we will discuss the Data JPA finder method Between examples

Table of Contents

Overview

JPA finder methods are the most powerful methods, we can create finder methods to select the records from the database without writing SQL queries. Behind the scenes, Data JPA will create SQL queries based on the finder method and execute the query for us.

To create finder methods in Data JPA, we need to follow a certain naming convention. To create finder methods for the entity class field name, we need to create a method starting with findBy followed by field name. We can also apply Between on the field names to select records between the range.

public class Employee {
	
	private String name;
	
	private BigDecimal salary;
	
	//setters and getters
}

To query the database that the employee name contains the given text –

findBySalaryBetween(BigDecimal start, BigDecimal end)

Behind the scenes, Data JPA will create a SQL query like this –

SELECT * FROM employee WHERE salary BETWEEN 1000.00 AND 5000.00;

As you can see, it’s so much easy to select the records with the help of finder methods. That’s the beauty of Data JPA.

Watch the video

Complete example

Let’s create a step-by-step spring boot project and create different finder methods for various fields.

Create database and insert sample data

Open MySQL workbench and execute the following commands

CREATE DATABASE mydb;

USE mydb;

CREATE TABLE tbl_laptops(
    id INT NOT NULL PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(255) NOT NULL,
    description VARCHAR(255) NOT NULL,
    brand VARCHAR(255) NOT NULL,
    price DOUBLE(10, 2) NOT NULL,
    created_at DATE NOT NULL
);

INSERT INTO tbl_laptops(name, description, brand, price, created_at)
VALUES("Dell Inspiron", "dell company laptop", "Dell", 60000.00, '2021-02-10');
INSERT INTO tbl_laptops(name, description, brand, price, created_at)
VALUES("Dell XPS", "dell company laptop", "Dell", 70000.00, '2020-12-31');
INSERT INTO tbl_laptops(name, description, brand, price, created_at)
VALUES("Macbook Air", "apple company laptop", "Apple", 85000.00, '2021-01-31');
INSERT INTO tbl_laptops(name, description, brand, price, created_at)
VALUES("Macbook Pro", "apple company laptop", "Apple", 160000.00, '2021-12-25');
INSERT INTO tbl_laptops(name, description, brand, price, created_at)
VALUES("HP", "hp company laptop", "HP", 50000.00, '2021-02-10');
INSERT INTO tbl_laptops(name, description, brand, price, created_at)
VALUES("Lenovo", "lenovo company laptop", "Lenovo", 50000.00, '2020-11-21');

SELECT * FROM tbl_laptops;

We have created a table tbl_laptops that contains 5 fields. We have inserted the sample data as well.

Create spring boot project

There are many different ways to create a spring boot application, you can follow the below articles to create one –

>> Create spring boot application using Spring initializer
>> Create spring boot application in Spring tool suite [STS]
>> Create spring boot application in IntelliJ IDEA

Add maven dependencies

Open pom.xml and add the following dependencies –

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.4.4</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>
	<groupId>in.bushansirgur</groupId>
	<artifactId>findbyfieldname</artifactId>
	<version>v1</version>
	<name>findbyfieldname</name>
	<description>Spring boot data jpa find by field name</description>
	<properties>
		<java.version>1.8</java.version>
	</properties>
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-data-jpa</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-devtools</artifactId>
			<scope>runtime</scope>
			<optional>true</optional>
		</dependency>
		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<scope>runtime</scope>
		</dependency>
		<dependency>
			<groupId>org.projectlombok</groupId>
			<artifactId>lombok</artifactId>
			<optional>true</optional>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies>

	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
				<configuration>
					<excludes>
						<exclude>
							<groupId>org.projectlombok</groupId>
							<artifactId>lombok</artifactId>
						</exclude>
					</excludes>
				</configuration>
			</plugin>
		</plugins>
	</build>

</project>

spring-boot-starter-web dependency for building web applications using Spring MVC. It uses the tomcat as the default embedded container.

spring-boot-devtools dependency for automatic reloads or live reload of applications. spring-boot-starter-data-jpa dependency is a starter for using Spring Data JPA with Hibernate. lombok dependency is a java library that will reduce the boilerplate code that we usually write inside every entity class like setters, getters, and toString()

Create an entity class

Create Laptop.java inside the in.bushansirgur.springboot.entity package and add the following content

package in.bushansirgur.springboot.entity;

import java.math.BigDecimal;
import java.sql.Date;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;

import lombok.Data;

@Entity
@Table(name="tbl_laptops")
@Data
public class Laptop {
	
	@Id
	@GeneratedValue(strategy = GenerationType.IDENTITY)
	private Long id;
	
	private String name;
	
	private String brand;
	
	private String description;
	
	private BigDecimal price;
	
	@Column(name="created_at")
	private Date createdAt;
}

We have added @Data annotation which is a Lombok annotation, that will automatically create setters, getters, toString(), and equals() for us.

@Entity is a mandatory annotation that indicates that this class is a JPA entity and is mapped with a database table.

@Table annotation is an optional annotation that contains the table info like table name.

@Id annotation is a mandatory annotation that marks a field as the primary key

Create a Repository

Create an interface LaptopRepository.java inside the in.bushansirgur.springboot.repos package and add the following content

package in.bushansirgur.springboot.repos;

import java.math.BigDecimal;
import java.util.List;
import java.sql.Date;

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

import in.bushansirgur.springboot.entity.Laptop;

@Repository
public interface LaptopRepository extends JpaRepository<Laptop, Long> {
	
	List<Laptop> findByCreatedAtBetween(Date startDate, Date endDate);
	
	List<Laptop> findByPriceBetween(BigDecimal startPrice, BigDecimal endPrice);
}

@Repository annotates classes at the persistence layer, which will act as a database repository. We have extended this interface with JPARepository interface which will provide built-in methods to interact with the database also we can define finder methods. We have defined 2 finder methods findByCreatedAtBetween()and findByPriceBetween() which will return the List<Laptops>

Create a Rest controller

Create LaptopController.java inside the in.bushansirgur.springboot.controller package and add the following content

package in.bushansirgur.springboot.controller;

import java.math.BigDecimal;
import java.sql.Date;
import java.util.List;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import in.bushansirgur.springboot.entity.Laptop;
import in.bushansirgur.springboot.repos.LaptopRepository;

@RestController
public class LaptopController {
	
	@Autowired
	LaptopRepository lRepo;
	
	@GetMapping("/laptops/createdat")
	public ResponseEntity<List<Laptop>> getLaptopsByCreatedDate (@RequestParam Date startDate,
																@RequestParam Date endDate) {
		return new ResponseEntity<List<Laptop>>(lRepo.findByCreatedAtBetween(startDate, endDate), HttpStatus.OK);
	}
	
	@GetMapping("/laptops/price")
	public ResponseEntity<List<Laptop>> getLaptopsByPrice (@RequestParam BigDecimal startPrice,
																@RequestParam BigDecimal endPrice) {
		return new ResponseEntity<List<Laptop>>(lRepo.findByPriceBetween(startPrice, endPrice), HttpStatus.OK);	
	}
}

We have auto wired the LaptopRepository using @Autowired annotation. We have created 2 handler methods, getLaptopsByCreatedDate()and getLaptopsByPrice() which will call the repository methods findByCreatedAtBetween() and findByPriceBetween()

Run the app

Run the application using the below maven command –

mvn spring-boot:run

Open the browser and enter the following URL –

localhost:8080/laptops/createdat?startDate=2021-01-01&endDate=2021-12-31

[
    {
        "id": 1,
        "name": "Dell Inspiron",
        "brand": "Dell",
        "description": "dell company laptop",
        "price": 60000.0,
        "createdAt": "2021-02-10"
    },
    {
        "id": 3,
        "name": "Macbook Air",
        "brand": "Apple",
        "description": "apple company laptop",
        "price": 85000.0,
        "createdAt": "2021-01-31"
    },
    {
        "id": 4,
        "name": "Macbook Pro",
        "brand": "Apple",
        "description": "apple company laptop",
        "price": 160000.0,
        "createdAt": "2021-12-25"
    },
    {
        "id": 5,
        "name": "HP",
        "brand": "HP",
        "description": "hp company laptop",
        "price": 50000.0,
        "createdAt": "2021-02-10"
    }
]

localhost:8080/laptops/price?startPrice=60000.00&endPrice=100000.00

[
    {
        "id": 1,
        "name": "Dell Inspiron",
        "brand": "Dell",
        "description": "dell company laptop",
        "price": 60000.0,
        "createdAt": "2021-02-09T18:30:00.000+00:00"
    },
    {
        "id": 2,
        "name": "Dell XPS",
        "brand": "Dell",
        "description": "dell company laptop",
        "price": 70000.0,
        "createdAt": "2020-12-30T18:30:00.000+00:00"
    },
    {
        "id": 3,
        "name": "Macbook Air",
        "brand": "Apple",
        "description": "apple company laptop",
        "price": 85000.0,
        "createdAt": "2021-01-30T18:30:00.000+00:00"
    }
]

Post Views: 34,734