第8章 Spring Boot 工程

第 8 节 / 共 17 节 课程:前后端穿透

前端把请求发出来,后端要接住。这一章从零建一个 Spring Boot 工程,跑通第一个 JSON 接口,并说清楚 Controller、Service、Repository 各在哪一层。

后端分层:每层只做一件事Controller接请求、校验参数、返回结果Service业务规则、事务、组合多个 RepositoryRepository数据访问接口,负责查询与保存Entity数据库表的 Java 映射MySQL真正的数据与约束HTTP入口SQL出口Controller 不写 SQL,Service 不碰 HttpServletRequest,Repository 不决定页面长什么样。
图 8-1 Controller → Service → Repository → Entity → MySQL

8.1 后端到底做什么

很多初学者以为后端就是“写接口”。接口只是入口。一个真实后端还要做:

  • 校验:参数是否合法、用户有没有权限;
  • 业务:下单、扣库存、判分、生成页面;
  • 持久化:把数据写进数据库,并能查出来;
  • 事务:要么全成功,要么全回滚;
  • 安全:登录、令牌、越权、SQL 注入;
  • 可运维:日志、健康检查、配置、部署。

前端负责“看见和操作”,后端负责“规则和数据”。两边通过 HTTP + JSON 约定合作。

8.2 创建工程

打开 start.spring.io,选择:

选项值
ProjectMaven
LanguageJava
Spring Boot3.2.x(稳定版)
Java17
DependenciesSpring Web、Spring Data JPA、MySQL Driver、Validation、Lombok(可选)

下载解压,或用命令行:

curl https://start.spring.io/starter.zip \
  -d type=maven-project \
  -d language=java \
  -d bootVersion=3.2.5 \
  -d javaVersion=17 \
  -d dependencies=web,data-jpa,mysql,validation \
  -d groupId=cn.jssp \
  -d artifactId=demo \
  -o demo.zip

解压后目录大概是这样:

demo/
  pom.xml
  src/main/java/cn/jssp/demo/DemoApplication.java
  src/main/resources/application.properties
  src/test/java/...

8.3 pom.xml 关键依赖

<parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-parent</artifactId>
  <version>3.2.5</version>
</parent>
 
<properties>
  <java.version>17</java.version>
</properties>
 
<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>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <scope>runtime</scope>
  </dependency>
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
  </dependency>
</dependencies>
Spring Boot 2.x 用 javax.persistence,3.x 换成 jakarta.persistence。老项目升级时,所有 import 都要换,不能只改 pom 版本。

8.4 配置文件

把 application.properties 改成 application.yml,结构更清楚。

server:
  port: 5000
 
spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/codessp?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
    username: jssp
    password: your-password
    driver-class-name: com.mysql.cj.jdbc.Driver
  jpa:
    hibernate:
      ddl-auto: none
    show-sql: true
    open-in-view: false

ddl-auto: none 表示表结构由 SQL 脚本管理,不让 Hibernate 自动改表。生产环境不要用 update,它可能在你不注意时改字段。

8.5 启动类

package cn.jssp.demo;
 
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
 
@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

运行 mvn spring-boot:run,看到 Started DemoApplication 就成功了。默认端口 8080,上面配置改成了 5000。

8.6 第一个 JSON 接口

package cn.jssp.demo.controller;
 
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
 
import java.util.List;
 
import cn.jssp.demo.common.Result;
 
@RestController
@RequestMapping("/api")
public class HelloController {
 
    @GetMapping("/hello")
    public Result<List<String>> hello() {
        return Result.ok(List.of("hello", "world"));
    }
}

浏览器访问 http://localhost:5000/api/hello,应返回统一结构的 JSON。所有接口都用同一个 Result 外壳,前端才好统一处理。

package cn.jssp.demo.common;
 
public class Result<T> {
    private String code;
    private String info;
    private T data;
 
    public static <T> Result<T> ok(T data) {
        Result<T> r = new Result<>();
        r.code = "200";
        r.data = data;
        return r;
    }
 
    public static <T> Result<T> fail(String message) {
        Result<T> r = new Result<>();
        r.code = "500";
        r.info = message;
        return r;
    }
 
    // getter / setter 省略
}

8.7 分层与依赖方向

层包职责不应该做什么
Controllercontroller接请求、校验参数、返回结果写复杂 SQL、做事务
Serviceservice业务规则、事务边界、组合多个 Repository直接拼 HTML
Repositoryrepository数据访问写业务判断
Entityentity表映射放请求参数校验
DTOdto请求/响应结构直接暴露 Entity 的全部字段

依赖方向只能从上到下:Controller 调 Service,Service 调 Repository。不要反过来,也不要在 Controller 里直接调 Repository。

8.8 启动与打包

mvn clean package -DskipTests
java -jar target/demo-0.0.1-SNAPSHOT.jar

打包后的 jar 可以直接运行。生产环境用 systemd 托管,下一章之后的部署章节会讲。

8.9 常见问题

现象原因处理
端口被占用5000 已有进程改 server.port 或结束进程
连不上数据库地址/账号/库名错用 mysql 客户端先验证
启动报 jakarta 找不到Boot 3 还在用 javax改 import
接口 404路径少 /api 或方法不对看启动日志的映射
返回 500异常没处理看控制台堆栈

8.10 本章练习

  1. 建一个 /api/hello 接口,返回你的名字和当前时间。
  2. 把返回结构改成统一的 Result,成功和失败各调一次。
  3. 把端口改成 5001,确认前端代理也跟着改。

下一章讲 Controller 怎么接收参数、怎么返回 JSON、怎么处理异常。