18 · 看懂 Java/Spring：协作桥接篇

你不是要转 Java，而是要和 Java 团队协作：联调接口、读对方代码、把需求说清楚、把对方的能力接到自己的服务里。本篇用前端心智模型把 Spring 翻译成你看得懂的样子。

速览卡

项	内容
一句话定位	用前端类比读懂 Java/Spring 的分层与注解，达到"能读、能协作、能对接"级别
核心内容	为什么前端要懂 Java、Maven 多模块、Spring Boot 启动、依赖注入、注解体系、分层结构、常见组件
读完能回答	Spring 的 `@Service`/`@Autowired` 对应前端的什么？为什么 Java 项目这么"多文件"？我怎么读懂一个 Java 后端？
相关板块	C09 · 服务端语言上手｜ C15 · 定时任务｜ C17 · 部署与 CI/CD

定位提醒：Java/Spring 属于"了解即可"的深水区（见 C00 三层深度）。本篇目标是协作桥接，不是让你写 Java 生产代码。

一、为什么前端要"看得懂" Java

场景	你需要的能力
联调接口	看懂 Controller 路由、入参出参、错误码
跨团队交接	能读懂对方模块的边界和职责
迁移/双写	把 Java 服务的能力用 Python/FastAPI 复刻
排查问题	能定位"是网关、是服务、还是库"的问题出在哪层
面试协作题	被问"你怎么和 Java 后端协作"能答出分层心智

原则：你不是要成为 Java 专家，只要达到「拿到一个 Spring Boot 项目，半小时内能讲出它有哪些服务、每个服务哪些接口、数据怎么存的」。

二、先破最大的心理障碍：多模块

前端看到 Java 项目第一反应是"文件怎么这么多"。其实结构很规整：

Java 概念	前端对应	说明
Maven/Gradle（构建工具）	npm/pnpm/yarn	管依赖、构建、版本
`pom.xml`	`package.json`	声明依赖与构建配置
多模块（`modules`）	monorepo 的 workspaces	一个仓库多个可独立构建的子项目
`target/` / `build/`	`node_modules` + `dist`	构建产物
Java 包（`com.x.y`）	目录 + 命名空间	代码的组织层级

text

job-center/
├── pom.xml                 # 根 pom：管所有子模块
├── job-center-common/      # 公共模块：DTO、工具类
├── job-center-api/         # 接口模块：Feign 客户端、DTO
└── job-center-service/     # 业务模块：Handler、Service

一句话：Maven 多模块 ≈ npm workspaces monorepo，pom.xml 根文件聚合所有子包。

三、Spring Boot 启动：从 `main` 到"全家桶"

java

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

Spring 概念	前端对应	说明
`main` 方法	前端入口文件（`main.ts`）	程序从这里启动
`@SpringBootApplication`	框架自动装配（如 Nuxt/Vite 的约定）	一次注解开启自动配置
IoC 容器	依赖注入容器 / 状态管理 store	所有 Bean 由容器创建与管理
Bean	被框架托管的单例对象	一个类只有一个实例，大家共享

心智转换：前端是"你 import 谁谁就可用"，Java 是"你声明需要谁，容器把 Bean 注入给你"。两者都是解耦，只是方式不同（显式 import vs 声明式注入）。

四、依赖注入：前端的"provide/inject"

java

@Service
public class TaskService {
    private final TaskRepository taskRepository;

    public TaskService(TaskRepository taskRepository) {  // 构造器注入
        this.taskRepository = taskRepository;
    }
}

Spring 注入方式	前端近似
构造器注入（推荐）	把依赖显式传进组件 props
`@Autowired` 字段注入	框架帮你"塞进去"（类似 Vue 的 `inject()`）
`@Qualifier`	指定注入哪一个实现（类似具名 provide）

关键：@Service 标记"这是一个被容器管理的服务"，@Autowired 说"容器把一个现成的 Bean 给我，不用我 new"。前端 new 一切 vs Spring 容器统一管理一切，是两种哲学的分界线。

五、注解体系：装饰器 + 约定

Spring 的注解 ≈ TypeScript 装饰器 + 框架约定，按下表对照：

Spring 注解	前端对应	职责
`@RestController`	路由控制器（如 Nuxt server API）	声明这是一个 HTTP 接口层
`@GetMapping`/`@PostMapping`	路由 + method	声明 URL 与请求方法
`@RequestParam`/`@PathVariable`	查询参数 / 路由参数	取入参
`@RequestBody`	请求体解析	反序列化 JSON 到 DTO
`@Service`	业务逻辑层（如 service 目录）	业务代码
`@Repository`/`@Mapper`	数据访问层（如 repository）	数据库操作
`@Configuration`	配置文件/模块初始化	声明配置类
`@Transactional`	一个"自动提交/回滚"边界	方法内事务
`@Component`	通用被容器托管的东西	`@Service`/`@Repository` 的父级

读懂三层：Controller 只管接请求和返回，Service 管业务规则，DAO/Repository 管数据库。这和你前端里"组件 → 状态管理 → API 层"的分层逻辑完全一致。

六、从 Controller 到数据库：一条请求走完

text

HTTP 请求
  → @RestController 接收、校验参数
  → Service 做业务逻辑（调用其他 Service / 发消息）
  → Repository 访问数据库（MyBatis-Plus / JPA）
  → 结果封装成 DTO/统一响应返回前端

Java 层	类比前端
Controller	页面组件（只管显示与交互）
Service	store/业务 hooks（管状态与规则）
Repository	API 层 / 数据请求（管取数）
DTO	TypeScript 类型 + 校验 schema

统一响应体：Java 后端通常包一层 Result<T>（code/message/data），和 C12 讲的统一错误体一个思路。

七、配置、异步与定时任务

主题	Java 做法	前端类比	详见
配置	`application.yml` + 环境 profile	`.env` + 多环境配置	C12
定时任务	`@Scheduled` / XXL-Job `@XxlJob`	`setInterval`/cron 库	C15
异步	`@Async` / MQ 消息	异步函数 / 事件总线	C06
HTTP 调用	Feign / RestTemplate	`fetch`/axios	C05

Feign 一句话：声明式 HTTP 客户端，接口长什么样，框架就自动生成调用代码，≈ 前端的类型化 API 客户端生成器。

八、Java 与 Python/FastAPI 的关键差异

维度	Java/Spring	Python/FastAPI（你的主线）
类型检查	编译期强类型	运行期 + Pydantic 校验
线程模型	每个请求一个线程（虚拟线程/异步有演进）	asyncio 事件循环
启动速度	慢（JVM 启动）	快
生态	企业级老牌（银行/大厂）	AI 生态（LLM 生态在 Python）
部署	打 jar/war 包，常配 Tomcat	跑 uvicorn，Docker 化

结论：你做 AI 全栈主线选 Python（见 C01），Java 作为"看懂协作"的桥接层，不学透 Java 也能交付。

自检清单

[ ] 能说清 Maven 多模块 ≈ monorepo workspaces
[ ] 能讲清 IoC/Bean 与前端的显式 import 有什么不同
[ ] 能在一张 Spring 项目结构图里指出 Controller/Service/Repository 三层
[ ] 能对照 @GetMapping/@RequestBody/@Service/@Autowired 说出各自职责
[ ] 能读懂对方返回的 Result<T> 并正确消费

常见误区

误区：必须学透 Java 才能协作。 协作只需要"读得懂分层、对得齐接口"，深水区了解即可。
误区：@Autowired 就是 import。 import 是编译期引入，@Autowired 是运行期容器注入。
误区：Java 分层可以省略。 Controller 里写 SQL 是坏味道，分层边界就是你协作时的沟通边界。
误区：Spring Boot 只是"一个框架"。 它是一个容器 + 全家桶，理解 IoC 比记注解更重要。

动手练习

练习 A：读懂一个 Java 项目

拿你身边（或 XXL-Job 任务中心）的 Spring Boot 项目，画出模块图，标出 3 个 Controller、对应 Service 和 Repository。

练习 B：接口对照表

选一个接口，把 Java 的请求/响应 DTO 翻译成 TypeScript 类型，并与 FastAPI 的 Pydantic 模型对照写一份双向说明。

练习 C：伪 Java 转 FastAPI

把某个 Java Service 的业务逻辑用 FastAPI + Pydantic 复刻一遍，验证你对三层划分的理解。

18 · 看懂 Java/Spring：协作桥接篇

速览卡

一、为什么前端要"看得懂" Java

二、先破最大的心理障碍：多模块

三、Spring Boot 启动：从 `main` 到"全家桶"

四、依赖注入：前端的"provide/inject"

五、注解体系：装饰器 + 约定

六、从 Controller 到数据库：一条请求走完

七、配置、异步与定时任务

八、Java 与 Python/FastAPI 的关键差异

自检清单

常见误区

动手练习

练习 A：读懂一个 Java 项目

练习 B：接口对照表

练习 C：伪 Java 转 FastAPI

相关文档

本区

其他域

18 · 看懂 Java/Spring：协作桥接篇 ​

速览卡 ​

一、为什么前端要"看得懂" Java ​

二、先破最大的心理障碍：多模块 ​

三、Spring Boot 启动：从 main 到"全家桶" ​

四、依赖注入：前端的"provide/inject" ​

五、注解体系：装饰器 + 约定 ​

六、从 Controller 到数据库：一条请求走完 ​

七、配置、异步与定时任务 ​

八、Java 与 Python/FastAPI 的关键差异 ​

自检清单 ​

常见误区 ​

动手练习 ​

练习 A：读懂一个 Java 项目 ​

练习 B：接口对照表 ​

练习 C：伪 Java 转 FastAPI ​

相关文档 ​

本区 ​

其他域 ​

18 · 看懂 Java/Spring：协作桥接篇

速览卡

一、为什么前端要"看得懂" Java

二、先破最大的心理障碍：多模块

三、Spring Boot 启动：从 `main` 到"全家桶"

四、依赖注入：前端的"provide/inject"

五、注解体系：装饰器 + 约定

六、从 Controller 到数据库：一条请求走完

七、配置、异步与定时任务

八、Java 与 Python/FastAPI 的关键差异

自检清单

常见误区

动手练习

练习 A：读懂一个 Java 项目

练习 B：接口对照表

练习 C：伪 Java 转 FastAPI

相关文档

本区

其他域