Spring-boot-template

Swagger-api-docs

目录结构

├── model           实体类
├── dto             数据传输对象
├── repository      数据层
├── service         业务层
├── controller      API层
├── config          JPA审计，全局拦截(advice)
├── util            工具类
└── exception       异常处理

RESTful Web Service

HelloController.java

Entity

BaseEntity
NamedEntity
Dictionary
Ingredient

DTO

IngredientBodyDTO AuthRequestDTO

JPA

IngredientRepository.java

MySQL

• pom.xml : mysql-connector-j spring-boot-docker-compose
• application-mysql
• compose.yml

JPA 审计

• 引入 Spring Data JPA 的 @EnableJpaAuditing 以启用自动时间管理，例：JpaConfig.java
• @CreatedDate @LastModifiedDate，例：BaseEntity.java

多对一

多个当前实体对象Ingredient可以对应一个关联的目标实体对象Dictionary

多对多

Recipe(菜谱)和Ingredient(食材)是多对多，创建中间实体RecipeIngredient

@JsonIgnore

Ingredient.java

投影 Projection

RecipeRepository.java

JPQL

RecipeRepository.java

NativeSQL

RecipeRepository.java

@JsonFormat

BaseEntity RecipeProjection RecipeSummaryDTO

分页查询

• 在 Spring Data JPA 的 JpaRepository 中使用 Page 对象实现分页查询，例如 RecipeRepository.java
• 在 Service 层实现分页查询，例如：RecipeService.java
• 在 Controller 层处理分页请求，例如：RecipeController.java

统一响应格式

ApiResponse.java

分页响应格式

PageResponse.java

异常处理

• 创建ResourceNotFoundException
• 在Service 或 Controller中 throwResourceNotFoundException，例如DictionaryServiceImpl
• 创建 the Global Exception Handler：GlobalExceptionHandler

复杂动态查询

根据名称和单位动态查询食材

• 新建IngredientSpecification.java，用于动态构建查询条件
• 修改IngredientRepository.java，继承 JpaSpecificationExecutor
• 在 IngredientService.java 中调用动态查询
• 在 IngredientController.java 中添加接口

GET /ingredients/search?name=鸡蛋&unit=1

基于菜谱名、描述和多个食材名的动态查询

• 新建RecipeSpecification.java，用于动态构建查询条件
• 修改RecipeRepository.java，继承 JpaSpecificationExecutor
• 在 RecipeService.java 中调用动态查询
• 在 RecipeController.java 中添加接口

GET /recipes/list/search?name=面条&description=辣&ingredients=肉丝 青椒

Redis 缓存

• pom.xml中添加spring-boot-starter-data-redis和spring-boot-starter-cache
• application-redis.properties
• 在主类或配置类上添加 @EnableCaching 注解 : RedisConfig.java
• @Cacheable @CachePut @CacheEvict : DictionaryService.java
• 默认情况下，Redis 使用二进制序列化，但你可以配置 JSON 序列化以提高可读性 : RedisConfig.java : 添加RedisTemplate和CacheManager的配置，并且使用相同的序列化方式

Docker

• application-mysql.properties ${DB_HOST:localhost}
• application-redis.properties ${DB_HOST:localhost}
• Dockerfile
• docker-compose.yml
• build.sh

Transaction

• RecipeService.java
  • createRecipeWithIngredients
  • editRecipeWithIngredients

lombok

User.java RecipeIngredientId.java

Spring Security & JWT (注册登录)

• pom.xml 添加 spring-boot-starter-security
• 实现 UserDetailsService : CustomUserDetailsService
• 自定义 JWT 过滤器 : JwtAuthenticationFilter
• 通过 SecurityFilterChain 配置 Spring Security : SecurityConfig
• JWT 工具类 : JwtUtils
• AuthService
• AuthController

角色权限

• JwtAuthenticationFilter
• SecurityConfig
  • 启用方法级别的安全配置：@EnableMethodSecurity(prePostEnabled = true)
  • 添加异常处理配置
• DictionaryController @PreAuthorize("hasRole('ADMIN')")

密码加密存储：BCrypt

• SecurityConfig

  • passwordEncoder

• AuthService

  • register

AccessToken & RefreshToken

• AuthController
• login
• validateAndRefresh
• refresh

Kaptcha

• KaptchaConfig.java
• CaptchaController.java
• AuthController

Actions

• main.yml

备份数据库

• backup.sh

恢复数据库

• restore.sh