**Spring Data Rest**

官方文件∶
https://docs.spring.io/spring-data/rest/docs/current/reference/html/

pring Data REST 是 Spring Data 项目的一部分，它允许你快速创建基于 JPA、MongoDB、Neo4j 等后端存储的 RESTful API，而无需编写大量的控制器代码。下面是 Spring Data REST 的一些基本概念和如何使用它的步骤：

基本概念：

Repository 接口： Spring Data REST 基于 Spring Data Repository 接口。这些接口定义了对数据库实体的基本 CRUD 操作。你只需定义这些接口，Spring Data REST 就会为你自动生成相应的 RESTful API 端点。

实体类： 你的 JPA 实体类是数据模型的核心。Spring Data REST 会自动暴露这些实体类为 RESTful 资源。

Spring Data REST 配置： 你可以通过配置文件或 Java 配置来自定义 Spring Data REST 的行为。这包括路径、安全性、关联资源的深度等。

如何使用 Spring Data REST：

下面是使用 Spring Data REST 的一般步骤：

引入依赖： 在你的项目中引入 Spring Data JPA 和 Spring Data REST 的相关依赖。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-rest</artifactId>
</dependency>

定义 JPA 实体： 创建你的 JPA 实体类，使用 JPA 注解来定义实体和关系。

@Entity
public class Product {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private double price;
    // 其他字段和关联
    // 省略 getter 和 setter 方法
}

创建 Repository 接口： 为实体创建一个继承自 Spring Data Repository 接口的自定义接口。不需要提供实现，Spring Data REST 会自动生成。

public interface ProductRepository extends JpaRepository<Product, Long> {
}

配置 Spring Data REST（可选）： 你可以在 application.properties 或 application.yml 文件中配置 Spring Data REST 的属性，如基本路径等。

spring.data.rest.basePath=/api

访问 RESTful API： Spring Data REST 将自动生成 CRUD 操作的 RESTful API 端点，你可以通过 HTTP 请求访问它们。例如：

获取所有产品：GET /api/products
获取单个产品：GET /api/products/{id}
创建产品：POST /api/products
更新产品：PUT /api/products/{id}
删除产品：DELETE /api/products/{id}
Spring Data REST 还支持高级功能，如分页、排序、过滤和嵌套资源的访问。

在 Spring Data REST 中，你可以使用查询参数来传递查询条件，这样你可以过滤、排序、分页等。以下是如何在 Spring Data REST 的 API URL 中传递查询条件的方法：

过滤条件： 你可以使用 ? 后跟查询参数来指定过滤条件。例如，假设你有一个名为 name 的属性，你可以按名称过滤产品：

GET /api/products?name=productName

排序条件： 使用 _sort 和 _order 查询参数来指定排序条件。例如：

GET /api/products?_sort=name&_order=asc

分页条件： 使用 _page 和 _size 查询参数来指定分页条件。例如：

GET /api/products?_page=1&_size=10

复合条件： 你可以将多个查询参数组合在一起以创建复杂的查询条件。例如，过滤并按名称升序排序产品：

GET /api/products?name=productName&_sort=name&_order=asc

自定义查询： 如果你需要更复杂的查询条件，可以使用 Spring Data JPA 提供的查询方法。你可以在自定义的 Repository 接口中定义查询方法，然后使用 @Query 注解来定义查询语句。

public interface ProductRepository extends JpaRepository<Product, Long> {
    List<Product> findByNameAndPriceGreaterThan(String name, double price);

    @Query("SELECT p FROM Product p WHERE p.name LIKE %:keyword%")
    List<Product> searchByNameKeyword(@Param("keyword") String keyword);
}

然后，你可以在 URL 中使用自定义查询方法：

GET /api/products/search/findByNameAndPriceGreaterThan?name=productName&price=100.0

请注意，具体的查询参数和查询方法名称取决于你的实体和 Repository 接口的定义。你可以根据你的需求自定义查询条件。更多详细信息可以参考 Spring Data JPA 文档：https://docs.spring.io/spring-data/jpa/docs/current/reference/html/#jpa.query-methods.query-creation

如果你的查询条件是根据前端用户自行输入，且可能是动态的，而且你不想在 JPA Repository 中为每个可能的查询组合定义查询方法，那么你可以使用 Spring Data JPA 提供的动态查询来处理这种情况。动态查询允许你根据运行时条件构建查询，而不需要在编译时定义具体的方法。

以下是如何使用 Spring Data JPA 动态查询来处理这种情况的基本步骤：

1.创建一个自定义的查询方法： 在你的自定义 Repository 接口中创建一个方法，用于构建动态查询。你可以使用 @Query 注解来定义查询语句。在查询语句中，你可以使用参数占位符来表示动态的查询条件。

public interface ProductRepositoryCustom {
    List<Product> findProductsByCriteria(String name, Double price);
}

2.实现自定义查询方法： 创建一个实现自定义接口的类，并实现查询方法。在方法内部，你可以构建查询条件，并使用 Spring Data JPA 提供的 CriteriaBuilder 或 QueryDSL 等工具来动态生成查询。

import org.springframework.beans.factory.annotation.Autowired;
import javax.persistence.EntityManager;
import javax.persistence.criteria.CriteriaBuilder;
import javax.persistence.criteria.CriteriaQuery;
import javax.persistence.criteria.Predicate;
import javax.persistence.criteria.Root;
import java.util.ArrayList;
import java.util.List;

public class ProductRepositoryCustomImpl implements ProductRepositoryCustom {

    @Autowired
    private EntityManager entityManager;

    @Override
    public List<Product> findProductsByCriteria(String name, Double price) {
        CriteriaBuilder criteriaBuilder = entityManager.getCriteriaBuilder();
        CriteriaQuery<Product> criteriaQuery = criteriaBuilder.createQuery(Product.class);
        Root<Product> root = criteriaQuery.from(Product.class);
        List<Predicate> predicates = new ArrayList<>();

        if (name != null) {
            predicates.add(criteriaBuilder.equal(root.get("name"), name));
        }
        if (price != null) {
            predicates.add(criteriaBuilder.greaterThan(root.get("price"), price));
        }

        criteriaQuery.where(predicates.toArray(new Predicate[0]));
        return entityManager.createQuery(criteriaQuery).getResultList();
    }
}

3.启用自定义 Repository： 在你的 JPA 实体的 Repository 接口上扩展自定义 Repository 接口。
public interface ProductRepository extends JpaRepository<Product, Long>, ProductRepositoryCustom {
}

现在，你可以根据前端用户的输入动态调用 findProductsByCriteria 方法，并传递所需的查询条件。例如：

List<Product> products = productRepository.findProductsByCriteria("productName", 100.0);