data-jpa.md

name	springboot/data-jpa
module	springboot
description	Spring Data JPA 能力，提供 ORM、Repository 抽象和分页查询
status	已实现
scope	后端
source	框架:Spring Boot
import	com.codingapi.springboot:springboot-starter-data-fast
framework_version	3.4.54

解决什么问题

提供 Spring Data JPA 的 ORM 能力，解决以下问题：

• ORM 映射：通过 JPA 注解将 Java 实体映射到数据库表
• Repository 抽象：通过 JpaRepository 接口自动生成 CRUD 实现
• 分页查询：内置 Pageable / Page 支持分页
• 多数据库支持：同一代码支持 MySQL、PostgreSQL、H2 等多种数据库

如何使用

核心注解

注解	用途
@Entity / @Table	实体类和表映射
@Id / @GeneratedValue	主键定义
@Column	列映射
@Repository	Repository 接口声明

在 Flow Engine 中的使用

flow-engine-starter-infra 模块使用 Spring Data JPA：

• 定义 JPA Entity（WorkflowEntity、FlowRecordEntity 等）
• 实现 JPA Repository 接口
• 通过 Convertor 在 Entity 和领域模型间转换
• 支持 MySQL、PostgreSQL、H2 三种数据库

数据库驱动依赖

<!-- MySQL -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
</dependency>
<!-- PostgreSQL -->
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
</dependency>
<!-- H2 (测试/内嵌) -->
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
</dependency>

使用实例

// Entity 定义
@Entity
@Table(name = "flow_workflow")
public class WorkflowEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(name = "code")
    private String code;

    @Column(name = "title")
    private String title;
}

// JPA Repository
public interface WorkflowEntityRepository extends JpaRepository<WorkflowEntity, Long> {
    Optional<WorkflowEntity> findByCode(String code);
}

// Repository 实现
@Repository
public class WorkflowRepositoryImpl implements WorkflowRepository {
    @Autowired
    private WorkflowEntityRepository jpaRepo;

    @Override
    public Workflow findByCode(String code) {
        return jpaRepo.findByCode(code)
            .map(WorkflowConvertor::toDomain)
            .orElse(null);
    }
}