前端把请求发出来,后端要接住。这一章从零建一个 Spring Boot 工程,跑通第一个 JSON 接口,并说清楚 Controller、Service、Repository 各在哪一层。
图 8-1 Controller → Service → Repository → Entity → MySQL
8.1 后端到底做什么
很多初学者以为后端就是“写接口”。接口只是入口。一个真实后端还要做:
- 校验:参数是否合法、用户有没有权限;
- 业务:下单、扣库存、判分、生成页面;
- 持久化:把数据写进数据库,并能查出来;
- 事务:要么全成功,要么全回滚;
- 安全:登录、令牌、越权、SQL 注入;
- 可运维:日志、健康检查、配置、部署。
前端负责“看见和操作”,后端负责“规则和数据”。两边通过 HTTP + JSON 约定合作。
8.2 创建工程
打开 start.spring.io,选择:
| 选项 | 值 |
|---|
| Project | Maven |
| Language | Java |
| Spring Boot | 3.2.x(稳定版) |
| Java | 17 |
| Dependencies | Spring 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;
}
}
8.7 分层与依赖方向
| 层 | 包 | 职责 | 不应该做什么 |
|---|
| Controller | controller | 接请求、校验参数、返回结果 | 写复杂 SQL、做事务 |
| Service | service | 业务规则、事务边界、组合多个 Repository | 直接拼 HTML |
| Repository | repository | 数据访问 | 写业务判断 |
| Entity | entity | 表映射 | 放请求参数校验 |
| DTO | dto | 请求/响应结构 | 直接暴露 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 本章练习
- 建一个
/api/hello 接口,返回你的名字和当前时间。
- 把返回结构改成统一的
Result,成功和失败各调一次。
- 把端口改成 5001,确认前端代理也跟着改。
下一章讲 Controller 怎么接收参数、怎么返回 JSON、怎么处理异常。