当前位置：首页 > news >正文

Springboot的简单推荐实现

news 来源：原创 2025/5/16 17:03:53

以springboot 推荐社团招新为例子

使用 Spring Boot 构建社团招新推荐系统，用户注册后选择兴趣，系统根据兴趣推荐社团。
实现包括用户注册、兴趣选择和基于标签匹配的推荐算法。
系统使用 JPA 管理数据库，Spring Security 确保安全，推荐前5个匹配度最高的社团。

系统概述

这是一个基于兴趣的推荐系统，适合社团招新场景。用户注册时选择兴趣，系统通过匹配用户兴趣和社团标签，推荐最相关的社团。

实现步骤

用户注册：用户提供用户名、密码和兴趣列表，系统存储用户信息。
社团数据：预先定义社团及其标签，方便后续匹配。
推荐服务：计算用户兴趣与社团标签的重叠数量，排序后返回前5个推荐。

详细实现方案

引言

本文详细描述了一个基于 Spring Boot 的社团招新推荐系统的实现方案。该系统允许用户注册后选择兴趣，并通过推荐算法找到匹配的社团。以下内容涵盖了系统设计、数据模型、算法实现、技术栈选择以及前端交互示例，旨在为开发者提供一个完整的参考。

系统设计

系统的主要功能包括用户注册、兴趣选择和社团推荐。核心设计目标是实现一个高效、易扩展的推荐系统，满足社团招新的需求。以下是关键组件：

用户管理：用户注册并选择兴趣，系统存储用户信息。
社团管理：预先定义社团及其标签，方便后续匹配。
推荐服务：基于用户兴趣和社团标签进行匹配，生成推荐列表。

数据模型

系统使用 JPA 实体类定义数据模型，具体如下：

实体	属性	描述
User 用户	id, username, password, interests	用户ID、用户名、密码（加密）、兴趣列表
Club 俱乐部	id, name, description, tags	社团ID、名称、描述、标签列表

User 实体：使用 @Entity 注解定义，interests 使用 @ElementCollection 存储为字符串列表。
Club 实体：同样使用 @Entity 注解，tags 存储社团的兴趣标签。

示例代码如下：

java

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String username;
    private String password;
    @ElementCollection
    private List<String> interests;
    // getters and setters
}

@Entity
public class Club {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String description;
    @ElementCollection
    private List<String> tags;
    // getters and setters
}

推荐算法

推荐服务使用基于标签匹配的简单算法，具体实现如下：

获取用户的所有兴趣（user.getInterests()）。
获取系统中所有社团（clubRepository.findAll()）。
对每个社团，计算用户兴趣与社团标签的匹配数量：
- 遍历用户兴趣列表，检查是否在社团标签中出现，出现一次加1分。
将匹配分数存储在 Map<Club, Integer> 中，仅保留分数大于0的社团。
按匹配分数降序排序，返回前5个社团。

示例代码：

java

@Service
public class RecommendationService {
    @Autowired
    private ClubRepository clubRepository;
    
    public List<Club> recommendClubs(User user) {
        List<String> userInterests = user.getInterests();
        List<Club> allClubs = clubRepository.findAll();
        
        Map<Club, Integer> clubMatchScore = new HashMap<>();
        for (Club club : allClubs) {
            int matchScore = 0;
            for (String interest : userInterests) {
                if (club.getTags().contains(interest)) {
                    matchScore++;
                }
            }
            if (matchScore > 0) {
                clubMatchScore.put(club, matchScore);
            }
        }
        
        return clubMatchScore.entrySet().stream()
                .sorted(Map.Entry.comparingByValue(Comparator.reverseOrder()))
                .limit(5)
                .map(Map.Entry::getKey)
                .collect(Collectors.toList());
    }
}

用户注册与控制器

用户注册通过 REST 控制器实现，包含注册和获取推荐的端点。使用 Spring Security 确保安全，密码使用 BCryptPasswordEncoder 加密。

示例控制器代码：

java

@RestController
@RequestMapping("/api")
public class ClubController {
    @Autowired
    private UserService userService;
    @Autowired
    private RecommendationService recommendationService;
    
    @PostMapping("/register")
    public ResponseEntity<User> register(@RequestBody UserRegistrationDTO dto) {
        User user = new User();
        user.setUsername(dto.getUsername());
        user.setPassword(passwordEncoder.encode(dto.getPassword()));
        user.setInterests(dto.getInterests());
        User savedUser = userService.save(user);
        return ResponseEntity.ok(savedUser);
    }
    
    @GetMapping("/recommendations")
    public ResponseEntity<List<Club>> getRecommendations(@AuthenticationPrincipal User user) {
        List<Club> recommendedClubs = recommendationService.recommendClubs(user);
        return ResponseEntity.ok(recommendedClubs);
    }
}

技术栈与依赖

系统依赖以下 Spring Boot 启动器：

依赖	用途
spring-boot-starter-web	提供 REST API 支持
spring-boot-starter-data-jpa	JPA 数据库操作
spring-boot-starter-security	用户认证与安全
h2	内存数据库（开发测试用）

Maven 依赖配置示例：

xml

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-security</artifactId>
    </dependency>
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

前端交互

前端使用 JavaScript 和 Axios 进行 API 调用，示例代码如下：

javascript

// 注册
axios.post('/api/register', {
    username: 'user1',
    password: 'password123',
    interests: ['music', 'sports', 'tech']
}).then(response => {
    console.log('Registered:', response.data);
});

// 获取推荐
axios.get('/api/recommendations', {
    headers: {
        Authorization: 'Bearer ' + token
    }
}).then(response => {
    console.log('Recommended clubs:', response.data);
});

数据库初始化

使用 data.sql 文件初始化社团数据，示例：

sql

INSERT INTO club (name, description) VALUES ('音乐社', '热爱音乐的聚集地');
INSERT INTO club_tags (club_id, tags) VALUES (1, 'music');
INSERT INTO club_tags (club_id, tags) VALUES (1, 'art');

INSERT INTO club (name, description) VALUES ('体育社', '运动爱好者之家');
INSERT INTO club_tags (club_id, tags) VALUES (2, 'sports');