简单地聊一聊Spring Boot的构架

本文由葡萄城技术团队发布。转载请注明出处：葡萄城官网，葡萄城为开发者提供专业的开发工具、解决方案和服务，赋能开发者。

前言

本文小编将详细解析Spring Boot框架，并通过代码举例说明每个层的作用。我们将深入探讨Spring Boot的整体架构，包括展示层、业务逻辑层和数据访问层。通过这些例子，读者将更加清晰地了解每个层在应用程序中的具体作用。通过代码实例，我们将帮助读者更好地理解和应用Spring Boot框架，从而提高应用程序的可维护性和可扩展性。

什么是Spring Boot

在介绍Spring Boot框架的分层之前，小编先为大家介绍一下什么是Spring Boot：

Spring Boot是一个基于Spring框架的开发框架，旨在简化Spring应用程序的搭建和开发。Spring Boot提供了很多自动化配置的功能，可以快速地搭建一个基于Spring的Web应用程序，而不需要手动进行繁琐的配置。

Spring Boot可以帮助开发人员快速构建各种类型的应用程序，包括Web应用程序、RESTful服务、批处理应用程序和基于消息的应用程序等。它采用Java编程语言，并且可以与各种其他技术集成，例如Thymeleaf、MongoDB、Redis等。

Spring Boot还提供了很多有用的工具和插件，例如Spring Boot CLI（命令行界面），可以帮助开发人员更加便捷地创建、运行和测试Spring Boot应用程序。此外，Spring Boot还支持各种构建工具，例如Maven和Gradle，以及各种开发环境，例如Eclipse和IntelliJ IDEA。

Spring Boot分层：

Spring Boot主要分为4层：Controller层、Service层、Repository/DAO层和Model层。

1. Controller层

在SpringBoot中，Controller层是MVC（Model-View-Controller）模式中的控制器部分，负责处理来自用户发起的HTTP请求，并返回相应的响应结果。Controller层接收到请求后，通常会调用Service层进行业务逻辑处理，最后再将处理结果封装成响应对象并返回给前端。

一个Controller类通常包含多个方法，每个方法对应一个不同的HTTP请求路径，并使用特定的注解来标识。例如，使用@GetMapping注解表示该方法处理GET请求，@PostMapping表示该方法处理POST请求。同时，通过@RequestParam注解可以获取请求参数，@PathVariable注解可以获取URL路径参数，@RequestBody注解可以获取请求体中的数据。

2. Service层

在Spring Boot中，Service层是应用程序的一部分，负责处理业务逻辑和协调不同的组件。它是控制器（Controller）和数据访问层（Repository）之间的中间层，用于将业务逻辑与数据操作解耦。

Service层的主要职责可以总结如下：

1. 执行业务逻辑：Service层负责实现应用程序的业务逻辑。它包含了具体的业务规则和操作流程，以满足需求和业务规定。例如，对于电子商务应用程序，Service层可能会包含创建订单、处理支付、验证库存等业务逻辑的实现。
2. 协调数据访问：Service层充当控制器和数据访问层之间的桥梁。它通过调用相应的Repository接口来执行数据操作，如查询数据库、保存数据、更新数据等。Service层可以组织和协调多个Repository操作，以完成复杂的业务需求。
3. 提供业务接口：Service层可以定义一些公共接口或方法，供其他组件（如控制器、其他Service等）使用。这样可以封装底层的业务逻辑实现，使其对外提供统一的接口。这种封装有助于提高代码的可维护性和重用性。
4. 处理事务管理：Service层通常涉及到数据库的读写操作，需要保证数据的一致性和完整性。通过使用Spring框架提供的事务管理机制，Service层可以确保多个数据库操作在一个事务中执行。它可以定义事务的边界、隔离级别、回滚策略等，以确保数据操作的正确性和可靠性。
5. 实现业务规则和验证：Service层可以包含对传入数据的验证和处理逻辑。例如，对于用户注册操作，Service层可能会对输入的用户名进行唯一性检查，对密码进行加密等。这样可以保证应用程序的安全性和数据的有效性。

3. Repository/DAO层

DAO全称是Data Access Object，其主要目标是从数据库高效获取（查询）数据，并为service层提供服务。

Repository/DAO层的主要职责可以总结如下：

1. 定义数据访问接口：Repository或DAO层定义了访问数据库的接口，它们通常包括各种读、写、更新、删除等操作。这些操作通过方法调用来实现，使得业务逻辑可以轻松地使用这些操作。
2. 提供数据映射：Repository或DAO层负责将数据库中的数据映射到Java类或对象中。这种映射可以是简单的一对一关系，也可以是复杂的关联关系。通常情况下，开发人员会使用ORM框架（如Hibernate）来自动完成数据映射。
3. 处理数据访问异常：Repository或DAO层负责处理与数据访问相关的异常情况，例如数据库连接失败、SQL语句执行错误等。它们可以捕获这些异常并进行相应的处理，以保证应用程序的稳定性和可靠性。
4. 支持数据源配置：Repository或DAO层支持不同类型的数据源配置，例如关系型数据库、NoSQL数据库、文件系统等。它们可以根据不同的数据源类型，提供相应的数据访问接口和数据映射策略。
5. 提供数据缓存：Repository或DAO层可以缓存已经读取的数据，以提高应用程序的性能。它们可以使用内存缓存、分布式缓存等不同类型的缓存机制，根据业务需求进行选择。

4. Model层

在Spring Boot中，Model层对象是用于封装和传递数据的Java对象。它表示应用程序中的业务数据，并负责处理数据的获取、保存和修改等操作。Model层对象通常具有以下特点：

1. 实体类（Entity Class）：Model层对象通常是实体类或POJO（Plain Old Java Object），用于表示业务数据的结构。实体类的属性对应数据库表的字段，通过ORM（Object-Relational Mapping）框架可以将实体类与数据库进行映射。
2. 数据传输对象（Data Transfer Object，DTO）：在一些场景下，为了满足特定的需求，可能需要使用DTO来封装数据。DTO是一个简单的Java对象，用于在不同的层之间传输数据。DTO通常只包含必要的属性，以减少数据传输的大小和复杂性。
3. 数据校验（Data Validation）：Model层对象可以用于数据校验，确保传入的数据符合特定的规则和要求。可以使用注解（如javax.validation.constraints）或其他验证框架（如Hibernate Validator）对属性进行校验。
4. 业务逻辑（Business Logic）：Model层对象可以包含一些业务逻辑的方法，用于处理数据的计算、转换和操作等。这些方法可以在Model层对象中定义，或者在服务层（Service Layer）中进行实现。

代码示例：

1.Controller层：

ProjectController.java

package com.example.Controller;
//import statements goes here
@RestController
public class UserController {

    //List all the available projects
    @GetMapping(path = "/projects", produces = MediaType.APPLICATION_JSON_VALUE)
    public ResponseEntity<List<Project>> getProjects() {

    // perform validation checks
    // return the services provided by service layer
    }
    //Apply for the project
    @PostMapping(path = "/apply-project", consumes = MediaType.APPLICATION_JSON_VALUE)
    public ResponseEntity<HttpStatus> applyProject(@RequestBody Map<String,String> json) {
    // perform validation checks
    // return the services provided by service layer
    }

    //Upload resume
    @PostMapping(path = "/upload-resume/{usn}")
    public ResponseEntity<List<Object>> uploadToDB(@RequestParam("file") MultipartFile[] file,@PathVariable String usn) {

    // perform validation checks
    // return the services provided by service layer
    }
    //Download resume
    @GetMapping("/files/download/{fileName:.+}")
    public ResponseEntity downloadFromDB(@PathVariable String fileName) {
    // perform validation checks
    // return the services provided by service layer
    }
}

上面例子使用了@GetMapping和@PostMapping：

@GetMapping注解用于将一个方法映射到指定的HTTP GET请求。它可以用于处理浏览器直接访问某个URL或者其他应用程序发起GET请求的情况。通过在方法上添加@GetMapping，我们可以定义一个处理该请求的方法，并在方法中编写相应的业务逻辑。

@PostMapping注解用于将一个方法映射到指定的HTTP POST请求。它可以用于处理表单提交、客户端数据上传等操作。通过在方法上添加@PostMapping，我们可以定义一个处理该请求的方法，并在方法中编写相应的业务逻辑。

2.Service层：

下面这段定义了项目相关的服务方法，并规定这些方法的输入参数和返回值。

在代码示例中，ProjectService 接口声明了三个方法：

1. getProjects() 方法返回一个 List<Project> 对象作为响应体（ResponseEntity），用于获取所有项目信息。
2. applyProject(String USN,int project_id) 方法返回 HttpStatus 枚举值，表示申请参与某个项目的状态。
3. uploadProjectDocument(MultipartFile[] files,int project_id) 方法返回 List<Object> 对象作为响应体，用于上传项目文档。

ProjectService.java

package com.example.Service;

// import statements

public interface ProjectService {

    ResponseEntity<List<Project>> getProjects();

    HttpStatus applyProject(String USN,int project_id);

    ResponseEntity<List<Object>> uploadProjectDocument(MultipartFile[] files,int project_id);

}

ProjectServiceImpl.java

package com.example.Service;

//import statements
@Service
public class ProjectServiceImpl implements ProjectService {
//dependency injection of DAO to be gone here (Autowire)

    @Override
    public ResponseEntity<List<Project>> getProjects() {
        try {
           //Business logic implementation using DAO services
        } catch (Exception e) {
            return new ResponseEntity<>(null,HttpStatus.INTERNAL_SERVER_ERROR) ;
        }
    }

    @Override
    public HttpStatus applyProject(String USN, int project_id) {

    //Business logic implementation using DAO services
    }

   //helper functions
    public ResponseEntity uploadToLocalFileSystem(MultipartFile file,int project_id) {

    }
    @Override
    public ResponseEntity<List<Object>> uploadProjectDocument(MultipartFile[] files,int project_id) {
       //Business logic implementation using DAO services
    }

}

3.Repository/DAO层：

下面的这段代码是一个接口类，属于包名为"com.example.Dao"的项目数据访问对象（DAO）。它扩展了 JpaRepository<Project, Integer> 接口，该接口提供了基本的CRUD（创建、读取、更新、删除）操作方法，用于对数据库中的 "Project" 实体进行操作。

ProjectDAO.java

package com.example.Dao;

//import statements

public interface ProjectDao extends JpaRepository<Project,Integer> {

//You can also include native queries on top of CRUD operations provided by JPA
// Add queries here using @Query annotations and corresponding functions

    @Query(value = "Your SQL query ",nativeQuery = true)
    public List<Project> getProjects();

}

}

4.Model层：

下面这段代码定义了一个名为 "Project" 的实体类，表示一个项目。它包含了项目的各个属性（如项目ID、公司名称、描述、要求等），并与其他实体类（如员工、学生、文档、资金等）之间建立了关联关系。通过使用 JPA 注解，该类可以方便地进行数据库操作和查询。

代码中的各个部分的含义如下：

1. @Entity 注解表示该类是一个实体类，与数据库中的表进行映射。
2. @Table(name = "project") 注解指定了对应的数据库表名为 "project"。
3. @Id 注解表示该字段是主键。
4. @GeneratedValue(strategy = GenerationType.IDENTITY) 注解指定了主键的生成策略为自增长。
5. @Column 注解用于指定该属性与数据库表中的列的映射关系，其中 nullable 属性表示该列是否允许为空，name 属性指定了对应的数据库列名。
6. @JsonIgnore 注解用于忽略该属性在序列化和反序列化过程中的处理。
7. @ManyToMany(mappedBy="funded_projects") 注解表示当前实体与另一个实体 Fund 之间存在多对多的关联关系，通过 mappedBy 属性指定了在 Fund 实体中维护关联关系的属性名为 "funded_projects"。
8. Set<Staff>, Set<Student>, Set<Document>, Set<Fund> 表示与其他实体之间的关联关系，通过集合类型的属性来表示多对多关系或一对多关系。

Project.java

package com.example.Entity;

//import statements

@Entity
@Table(name = "project")
public class Project {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int project_id;
    @Column(nullable = false, name = "company_name")
    private String company_name;

    @Column(nullable = false, name = "description")
    private String description;

    @Column(nullable = false, name = "requirements")
    private String requirements;

    @Column(nullable = false, name = "manager")
    private String manager;
    @Column(nullable = false, name = "start_date")
    private Date start_date = new Date();

    @Column( name = "end_date")
    private Date end_date = new Date();
    @Column(nullable = false,name = "opening")
    private int opening;
    @Column(name = "resources")
    private String resources;
    public Set<Staff> getStaff_incharge() {
        return staff_incharge;
    }
    public void setStaff_incharge(Set<Staff> staff_incharge) {
        this.staff_incharge = staff_incharge;
    }
    public Set<Student> getApplied_students() {
        return applied_students;
    }
    public Set<Document> getDocuments() {
        return documents;
    }
    public void setDocuments(Set<Document> documents) {
        this.documents = documents;
    }
    @JsonIgnore
    @ManyToMany(mappedBy="funded_projects")
    private Set<Fund> funds;
    public Set<Fund> getFunds() {
        return funds;
    }
    public void setFunds(Set<Fund> funds) {
        this.funds = funds;
    }
    public void setApplied_students(Set<Student> applied_students) {
        this.applied_students = applied_students;
    }
    public Set<Student> getWorking_students() {
        return working_students;
    }
    public void setWorking_students(Set<Student> working_students) {
        this.working_students = working_students;
    }
//constructors
    public Project() {
        super();
    }
    public Project(int project_id, String company_name, String description, String requirements, String manager, Date start_date, Date end_date, int opening, String resources) {
        super();
        this.project_id = project_id;
        this.company_name = company_name;
        this.description = description;
        this.requirements = requirements;
        this.manager = manager;
        this.start_date = start_date;
        this.end_date = end_date;
        this.opening = opening;
        this.resources = resources;
    }
    public int getProject_id() {
        return project_id;
    }
    public void setProject_id(int project_id) {
        this.project_id = project_id;
    }
    public String getCompany_name() {
        return company_name;
    }
    public void setCompany_name(String company_name) {
        this.company_name = company_name;
    }

    public String getDescription() {
        return description;
    }
    public void setDescription(String description) {
        this.description = description;
    }
    public String getRequirements() {
        return requirements;
    }
    public void setRequirements(String requirements) {
        this.requirements = requirements;
    }
    public String getManager() {
        return manager;
    }
    public void setManager(String manager) {
        this.manager = manager;
    }
    public Date getStart_date() {
        return start_date;
    }
    public void setStart_date(Date start_date) {
        this.start_date = start_date;
    }
    public Date getEnd_date() {
        return end_date;
    }
    public void setEnd_date(Date end_date) {
        this.end_date = end_date;
    }
    public int getOpening() {
        return opening;
    }
    public void setOpening(int opening) {
        this.opening = opening;
    }
    public String getResources() {
        return resources;
    }
    public void setResources(String resources) {
        this.resources = resources;
    }
    @Override
    public String toString() {
        return "Project{" +
                "project_id=" + project_id +
                ", company_name='" + company_name + '\'' +
                ", description='" + description + '\'' +
                ", requirements='" + requirements + '\'' +
                ", manager='" + manager + '\'' +
                ", start_date=" + start_date +
                ", end_date=" + end_date +
                ", opening=" + opening +
                ", resources='" + resources + '\'' +
                '}';
    }
}

总结

本文为读者详细介绍了Spring Boot框架的四层构架，以及如何使用各种技术和工具来进行开发。通过阅读本文，希望可以帮助读者可以更好地理解Spring Boot框架的工作原理和应用场景，并能够利用所学知识来实现自己的项目。

参考资料：《Understanding Spring Boot Architecture》

扩展链接：

Redis从入门到实践

一节课带你搞懂数据库事务！

Chrome开发者工具使用教程

从表单驱动到模型驱动，解读低代码开发平台的发展趋势

低代码开发平台是什么？

基于分支的版本管理，帮助低代码从项目交付走向定制化产品开发