Add PredicateSpecification Update example.

Author: mp911de

jpa/example/src/main/java/example/springdata/jpa/simple/SimpleUserRepository.java

@@ -1,11 +1,11 @@
 /*
- * Copyright 2013-2021 the original author or authors.
+ * Copyright 2025 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *      https://www.apache.org/licenses/LICENSE-2.0
+ *      http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -24,6 +24,7 @@
 import org.springframework.data.domain.Pageable;
 import org.springframework.data.domain.Slice;
 import org.springframework.data.domain.Sort;
+import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
 import org.springframework.data.jpa.repository.Query;
 import org.springframework.data.repository.ListCrudRepository;
 import org.springframework.scheduling.annotation.Async;
@@ -36,7 +37,7 @@
  * @author Thomas Darimont
  * @author Christoph Strobl
  */
-public interface SimpleUserRepository extends ListCrudRepository<User, Long> {
+public interface SimpleUserRepository extends ListCrudRepository<User, Long>, JpaSpecificationExecutor<User> {
 
 	/**
 	 * Find the user with the given username. This method will be translated into a query using the

jpa/example/src/test/java/example/springdata/jpa/projections/CustomerRepositoryIntegrationTest.java

@@ -17,6 +17,10 @@
 
 import static org.assertj.core.api.Assertions.*;
 
+import jakarta.persistence.EntityManager;
+
+import java.util.Collection;
+import java.util.List;
 import java.util.Map;
 
 import org.junit.jupiter.api.BeforeEach;
@@ -26,9 +30,11 @@
 import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
 import org.springframework.boot.test.context.SpringBootTest;
 import org.springframework.context.annotation.Configuration;
+import org.springframework.data.domain.Page;
 import org.springframework.data.domain.PageRequest;
 import org.springframework.data.domain.Sort;
 import org.springframework.data.domain.Sort.Direction;
+import org.springframework.data.jpa.domain.PredicateSpecification;
 import org.springframework.data.projection.TargetAware;
 import org.springframework.transaction.annotation.Transactional;
 
@@ -48,6 +54,7 @@ class CustomerRepositoryIntegrationTest {
 	static class Config {}
 
 	@Autowired CustomerRepository customers;
+	@Autowired EntityManager entityManager;
 
 	private Customer dave;
 	private Customer carter;
@@ -96,7 +103,7 @@ void projectsDynamically() {
 	@Test
 	void projectsIndividualDynamically() {
 
-		var result = customers.findProjectedById(dave.getId(), CustomerSummary.class);
+		CustomerSummary result = customers.findProjectedById(dave.getId(), CustomerSummary.class);
 
 		assertThat(result.getFullName()).isEqualTo("Dave Matthews");
 
@@ -108,7 +115,7 @@ void projectsIndividualDynamically() {
 	@Test
 	void projectIndividualInstance() {
 
-		var projectedDave = customers.findProjectedById(dave.getId());
+		CustomerProjection projectedDave = customers.findProjectedById(dave.getId());
 
 		assertThat(projectedDave.getFirstname()).isEqualTo("Dave");
 		assertThat(projectedDave).isInstanceOfSatisfying(TargetAware.class,
@@ -118,7 +125,7 @@ void projectIndividualInstance() {
 	@Test
 	void projectsDtoUsingConstructorExpression() {
 
-		var result = customers.findDtoWithConstructorExpression("Dave");
+		Collection<CustomerDto> result = customers.findDtoWithConstructorExpression("Dave");
 
 		assertThat(result).hasSize(1);
 		assertThat(result.iterator().next().firstname()).isEqualTo("Dave");
@@ -127,7 +134,8 @@ void projectsDtoUsingConstructorExpression() {
 	@Test
 	void supportsProjectionInCombinationWithPagination() {
 
-		var page = customers.findPagedProjectedBy(PageRequest.of(0, 1, Sort.by(Direction.ASC, "lastname")));
+		Page<CustomerProjection> page = customers
+				.findPagedProjectedBy(PageRequest.of(0, 1, Sort.by(Direction.ASC, "lastname")));
 
 		assertThat(page.getContent().get(0).getFirstname()).isEqualTo("Carter");
 	}
@@ -140,10 +148,13 @@ void appliesProjectionToOptional() {
 	@Test
 	void projectsWithSpecification() {
 
-		var result = customers.findBy((query, cb) -> cb.equal(query.get("firstname"), "Dave"),
-				it -> it.as(CustomerDto.class).all());
+		PredicateSpecification<Customer> isFirstName = (from, cb) -> cb.equal(from.get("firstname"), "Dave");
+		PredicateSpecification<Customer> isLastName = (from, cb) -> cb.equal(from.get("lastname"), "Matthews");
+
+		List<CustomerDto> result = customers.findBy(isFirstName.and(isLastName), it -> it.as(CustomerDto.class).all());
 
 		assertThat(result).hasSize(1);
 		assertThat(result).extracting(CustomerDto::firstname).containsOnly("Dave");
 	}
+
 }

jpa/example/src/test/java/example/springdata/jpa/simple/SpecificationTests.java

@@ -0,0 +1,88 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package example.springdata.jpa.simple;
+
+import static org.assertj.core.api.Assertions.*;
+
+import jakarta.persistence.EntityManager;
+
+import java.util.List;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.data.jpa.domain.PredicateSpecification;
+import org.springframework.data.jpa.domain.UpdateSpecification;
+import org.springframework.transaction.annotation.Transactional;
+
+/**
+ * Integration tests for {@link SimpleUserRepository} to show specification capabilities.
+ *
+ * @author Mark Paluch
+ */
+@SpringBootTest
+@Transactional
+class SpecificationTests {
+
+	@Autowired SimpleUserRepository repository;
+
+	@Autowired EntityManager entityManager;
+
+	@BeforeEach
+	void setUp() {
+
+		repository.save(new User("Dave", "Matthews"));
+		repository.save(new User("Carter", "Beauford"));
+	}
+
+	@Test
+	void selectWithSpecification() {
+
+		PredicateSpecification<User> isFirstName = (from, cb) -> cb.equal(from.get("firstname"), "Dave");
+		PredicateSpecification<User> isLastName = (from, cb) -> cb.equal(from.get("lastname"), "Matthews");
+
+		List<User> result = repository.findAll(isFirstName.and(isLastName));
+
+		assertThat(result).hasSize(1);
+		assertThat(result).extracting(User::getFirstname).containsOnly("Dave");
+	}
+
+	@Test
+	void updateWithSpecification() {
+
+		PredicateSpecification<User> isFirstName = (from, cb) -> cb.equal(from.get("firstname"), "Dave");
+		PredicateSpecification<User> isLastName = (from, cb) -> cb.equal(from.get("lastname"), "Matthews");
+
+		UpdateSpecification<User> specification = UpdateSpecification.<User> update((root, update, criteriaBuilder) -> {
+			update.set("firstname", "Dan");
+			update.set("lastname", "Brown");
+		}).where(isFirstName.and(isLastName));
+
+		assertThat(repository.update(specification)).isEqualTo(1);
+		entityManager.clear();
+
+		assertThat(repository.findAll(isFirstName)).isEmpty();
+
+		List<User> result = repository.findAll((from, cb) -> cb.equal(from.get("firstname"), "Dan"));
+
+		assertThat(result).hasSize(1);
+		assertThat(result).extracting(User::getFirstname).containsOnly("Dan");
+		assertThat(result).extracting(User::getLastname).containsOnly("Brown");
+	}
+
+}