springboot后端框架搭建-山大软院创新实训项目博客_4_springboot项目搭建后端框架-优快云博客

本文链接：https://blog.youkuaiyun.com/ws_bones/article/details/147492620

在开发网页项目时，后端架构的设计是至关重要的。以下是一个总体的引入，概述了如何使用 Spring Boot 和相关技术栈来构建这个项目的后端。

1. 环境准备

确保开发环境中已经安装了以下工具：

JDK（建议使用 JDK 11 或更高版本）
Maven（用于项目构建和依赖管理）
MySQL 数据库
IntelliJ IDEA 或其他 Java IDE（可选，但推荐）

2. 创建 Spring Boot 项目

使用 Spring Initializr 创建一个新的 Spring Boot 项目：

访问 Spring Initializr 网站。
选择项目元数据（如 Group 和 Artifact）。
选择依赖项，至少需要：
- Spring Web
- Spring Data JPA
- MySQL Driver
- Lombok（可选，简化代码）

3. 项目结构设计

项目目录结构建议如下：

back_end/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   ├── com.example.backend/ # 包名
│   │   │   │   ├── controller/      # 控制器
│   │   │   │   │   ├── StoryController.java
│   │   │   │   │   ├── VoiceController.java
│   │   │   │   │   ├── TranslationController.java
│   │   │   │   │   ├── RecordController.java
│   │   │   │   ├── service/         # 服务层
│   │   │   │   │   ├── StoryService.java
│   │   │   │   │   ├── VoiceService.java
│   │   │   │   │   ├── TranslationService.java
│   │   │   │   │   ├── RecordService.java
│   │   │   │   ├── repository/      # 数据访问层
│   │   │   │   │   ├── StoryRepository.java
│   │   │   │   │   ├── VoiceRepository.java
│   │   │   │   │   ├── TranslationRepository.java
│   │   │   │   │   ├── RecordRepository.java
│   │   │   │   ├── entity/          # 实体类
│   │   │   │   │   ├── Story.java
│   │   │   │   │   ├── VoicePractice.java
│   │   │   │   │   ├── Translation.java
│   │   │   │   │   ├── LearningRecord.java
│   │   │   │   ├── config/          # 配置类
│   │   │   │   │   ├── DataSourceConfig.java
│   │   │   │   │   ├── DeepSeekConfig.java
│   │   │   │   ├── BackendApplication.java # 主程序入口
│   │   ├── resources/
│   │   │   ├── application.properties # 配置文件
│   │   │   ├── static/               # 静态资源
│   │   │   ├── templates/            # 模板文件
│   ├── test/
│   │   ├── java/
│   │   │   ├── com.example.backend/
│   │   │   │   ├── BackendApplicationTests.java

4. 数据库配置

在 src/main/resources/application.properties 中配置 MySQL 数据库连接：

spring.datasource.url=jdbc:mysql://localhost:3306/your_database_name?useSSL=false&serverTimezone=UTC
spring.datasource.username=your_username
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

5. 实体类设计

实体类是应用程序中数据模型的直接映射，通常与数据库中的表结构相对应。这些类定义了应用程序需要操作的数据结构。

职责：

表示数据库中的表。
包含与表字段相对应的属性。
使用 JPA 注解映射数据库表和字段。

例如，Story 实体类：

package com.example.backend.entity;

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;

@Entity
public class Story {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String title;
    private String content;
    private String level;
    private String style;

    // Getters and Setters
}

6. 数据访问层（Repository）

数据访问层（Repository）负责与数据库进行交互，执行 CRUD（创建、读取、更新、删除）操作。它提供了一种抽象的方式来访问数据，而不暴露数据库的具体细节。

职责：

定义数据访问接口。
实现数据访问逻辑。
使用 JPA 或其他 ORM 工具简化数据库操作。

例如，StoryRepository：

package com.example.backend.repository;

import com.example.backend.entity.Story;
import org.springframework.data.jpa.repository.JpaRepository;

public interface StoryRepository extends JpaRepository<Story, Long> {
}

7. 服务层（Service）

服务层包含应用程序的业务逻辑。它负责处理应用程序的核心功能，如数据处理、业务规则的实施等。服务层通常不直接与数据库交互，而是通过数据访问层（Repository）来完成。

职责：

封装业务逻辑。
调用数据访问层以获取或存储数据。
处理业务流程和事务管理。

例如，StoryService：

package com.example.backend.service;

import com.example.backend.entity.Story;
import com.example.backend.repository.StoryRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class StoryService {
    @Autowired
    private StoryRepository storyRepository;

    public List<Story> getAllStories() {
        return storyRepository.findAll();
    }

    public Story saveStory(Story story) {
        return storyRepository.save(story);
    }
}

8. 控制器层（Controller）

控制器层是应用程序的前端入口点，处理来自用户或客户端的请求。它负责接收输入、调用相应的服务层方法，并返回结果。

职责：

接收 HTTP 请求并解析请求参数。
调用服务层以处理业务逻辑。
处理异常并返回适当的 HTTP 响应。
将数据返回给客户端。

例如，StoryController：

package com.example.backend.controller;

import com.example.backend.entity.Story;
import com.example.backend.service.StoryService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/api/stories")
public class StoryController {
    @Autowired
    private StoryService storyService;

    @GetMapping
    public List<Story> getAllStories() {
        return storyService.getAllStories();
    }

    @PostMapping
    public Story createStory(@RequestBody Story story) {
        return storyService.saveStory(story);
    }
}

9. 启动类

在 BackendApplication.java 中启动 Spring Boot 应用：

package com.example.backend;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class BackendApplication {
    public static void main(String[] args) {
        SpringApplication.run(BackendApplication.class, args);
    }
}