repository层的设计-山大软院创新实训项目博客_6

于 2025-05-06 18:50:57 发布
阅读量315 收藏 4
点赞数 4
CC 4.0 BY-SA版权
文章标签： log4j java 单一职责原则 开闭原则
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/ws_bones/article/details/147745313

一.构建健壮的数据访问层

在现代软件架构中，Repository 层扮演着至关重要的角色，它作为应用程序的数据访问层，负责与数据库进行交互。本文将探讨 Repository 层的设计原则、实现方式以及如何利用 Spring Data JPA 简化开发过程。

二.为什么需要 Repository 层？

Repository 层的主要目的是将业务逻辑与数据访问逻辑分离，这样做的好处包括：

  1. 解耦：业务逻辑不直接依赖于特定的数据库实现，使得应用程序更容易适应数据库的更换。

  2. 复用：数据访问逻辑可以在不同的业务逻辑中复用，减少了代码重复。

  3. 测试：通过模拟 Repository 层，可以更容易地对业务逻辑进行单元测试。

三.设计原则

在设计 Repository 层时，应遵循以下原则：

  1. 单一职责：每个 Repository 应该只负责一种类型的实体。

  2. 接口驱动：定义接口来声明数据访问操作，而不是直接实现具体的方法。

  3. 封装性：隐藏底层数据访问的细节，对外提供简单的操作接口。

  4. 可扩展性：设计时应考虑未来可能的需求变更，保持灵活性。

四.实现 Repository 层

在 Java 项目中，通常使用 Spring Data JPA 来实现 Repository 层。以下是具体实现：

  • UserRepository 

package com.example.back_end.Repository;

import com.example.back_end.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    // 可以在这里添加一些自定义的查询方法
    // 例如根据用户名查找用户
    User findByUsername(String username);

    // 根据邮箱查找用户
    User findByEmail(String email);
}

 

  •  StoryRepository

package com.example.back_end.Repository;

import com.example.back_end.entity.Story;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.stereotype.Repository;

import java.util.List;

@Repository
public interface StoryRepository extends JpaRepository<Story, Long> {
    // 根据标题查询故事
    List<Story> findByTitleContaining(String title);

    // 根据难度级别查询故事
    List<Story> findByDifficultyLevel(Story.DifficultyLevel difficultyLevel);

    // 自定义查询：根据标题和难度级别查询故事
    @Query("SELECT s FROM Story s WHERE s.title LIKE %:title% AND s.difficultyLevel = :difficultyLevel")
    List<Story> findByTitleAndDifficultyLevel(String title, Story.DifficultyLevel difficultyLevel);
}

 

  • StoryLearningRecordRepository 

package com.example.back_end.Repository;

import com.example.back_end.entity.StoryLearningRecord;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.stereotype.Repository;

import java.util.Date;
import java.util.List;

@Repository
public interface StoryLearningRecordRepository extends JpaRepository<StoryLearningRecord, Long> {
    // 根据用户 ID 查询学习记录
    List<StoryLearningRecord> findByUserUserId(Long userId);

    // 根据故事 ID 查询学习记录
    List<StoryLearningRecord> findByStoryStoryId(Long storyId);

    // 根据用户 ID 和故事 ID 查询学习记录
    List<StoryLearningRecord> findByUserUserIdAndStoryStoryId(Long userId, Long storyId);

    // 根据学习日期查询学习记录
    List<StoryLearningRecord> findByLearningDate(Date learningDate);

    // 根据完成状态查询学习记录
    List<StoryLearningRecord> findByCompletionStatus(boolean completionStatus);

    // 自定义查询：根据用户 ID 和学习日期查询学习记录
    @Query("SELECT r FROM StoryLearningRecord r WHERE r.user.userId = :userId AND r.learningDate = :learningDate")
    List<StoryLearningRecord> findByUserUserIdAndLearningDate(Long userId, Date learningDate);
}

 

  •  TranslationPracticeRecordRepository

package com.example.back_end.Repository;

import com.example.back_end.entity.TranslationPracticeRecord;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
import org.springframework.stereotype.Repository;

import java.util.Date;

@Repository
public interface TranslationPracticeRecordRepository extends JpaRepository<TranslationPracticeRecord, Long>, JpaSpecificationExecutor<TranslationPracticeRecord> {
    // 根据用户 ID 查询翻译练习记录，并支持分页
    Page<TranslationPracticeRecord> findByUserUserId(Long userId, Pageable pageable);

    // 根据练习日期查询翻译练习记录，并支持分页
    Page<TranslationPracticeRecord> findByPracticeDate(Date practiceDate, Pageable pageable);

    // 根据用户 ID 和练习日期查询翻译练习记录，并支持分页
    Page<TranslationPracticeRecord> findByUserUserIdAndPracticeDate(Long userId, Date practiceDate, Pageable pageable);
}

 

  •  VoicePracticeRecordRepository

package com.example.back_end.Repository;

import com.example.back_end.entity.VoicePracticeRecord;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
import org.springframework.stereotype.Repository;

import java.util.Date;

@Repository
public interface VoicePracticeRecordRepository extends JpaRepository<VoicePracticeRecord, Long>, JpaSpecificationExecutor<VoicePracticeRecord> {
    // 根据用户 ID 查询语音练习记录，并支持分页
    Page<VoicePracticeRecord> findByUserUserId(Long userId, Pageable pageable);

    // 根据练习日期查询语音练习记录，并支持分页
    Page<VoicePracticeRecord> findByPracticeDate(Date practiceDate, Pageable pageable);

    // 根据用户 ID 和练习日期查询语音练习记录，并支持分页
    Page<VoicePracticeRecord> findByUserUserIdAndPracticeDate(Long userId, Date practiceDate, Pageable pageable);

    // 根据用户 ID 查询最高分数的语音练习记录
    VoicePracticeRecord findTopByUserUserIdOrderByScoreDesc(Long userId);
}

  •   LearningProgressRepository

package com.example.back_end.Repository;

import com.example.back_end.entity.LearningProgress;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.stereotype.Repository;

import java.util.List;

@Repository
public interface LearningProgressRepository extends JpaRepository<LearningProgress, Long> {
    // 根据用户 ID 查询学习进度
    LearningProgress findByUserUserId(Long userId);

    // 根据用户 ID 更新总阅读故事数
    int updateTotalStoriesReadByUserUserId(Long userId, int totalStoriesRead);

    // 根据用户 ID 更新平均语音评分
    int updateAvgVoiceScoreByUserUserId(Long userId, float avgVoiceScore);

    // 根据用户 ID 更新平均语法评分
    int updateAvgGrammarScoreByUserUserId(Long userId, float avgGrammarScore);

    // 根据用户 ID 更新个性化建议
    int updatePersonalizedSuggestionsByUserUserId(Long userId, String personalizedSuggestions);

    // 自定义查询：获取所有用户的平均语音评分和平均语法评分
    @Query("SELECT new LearningProgressSummary(lp.user.userId, AVG(lp.avgVoiceScore), AVG(lp.avgGrammarScore)) " +
            "FROM LearningProgress lp GROUP BY lp.user.userId")
    List<LearningProgressSummary> findAverageScoresByUserId();

    // 内部类，用于封装查询结果
    class LearningProgressSummary {
        private Long userId;
        private float avgVoiceScore;
        private float avgGrammarScore;

        public LearningProgressSummary(Long userId, float avgVoiceScore, float avgGrammarScore) {
            this.userId = userId;
            this.avgVoiceScore = avgVoiceScore;
            this.avgGrammarScore = avgGrammarScore;
        }

        // Getters
        public Long getUserId() {
            return userId;
        }

        public float getAvgVoiceScore() {
            return avgVoiceScore;
        }

        public float getAvgGrammarScore() {
            return avgGrammarScore;
        }
    }
}

五.总结

Repository 层是应用程序架构中的关键组成部分，它不仅简化了数据访问逻辑，还提高了代码的可维护性和可测试性。通过遵循设计原则和利用 Spring Data JPA 的强大功能，我们可以构建一个健壮且高效的数据访问层。

希望这篇博客文章能够帮助你清晰地表达 Repository 层的设计思路。如果有任何特定的方面需要深入探讨，或者你有其他的想法和经验想要分享，欢迎交流！

ws_bones
关注
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值