wsk/zhuangang

0 Fork 0

Files

T

Shikui Wang f695bbd7cc phase 5 part 4: java-spring awareness, k8s basics with validated manifests, run_examples supports single-file Java

2026-10-23 16:42:04 +08:00

4.9 KiB

Raw Blame History

id, title, type, domain, stack, tags, level, prerequisites, est_hours, related, week, order

title

type

domain

stack

Java / Spring Boot（了解级）：读懂项目结构、IoC 与依赖注入、分层、事务注解和与 Go / Python 的对照

定位：能读懂、能对接、面试能聊概念，不作为主线。BOSS直聘 2026-10-23 的调研中，有 AI 应用岗位写了“熟悉 Java / Go / Python 其中之一”，或者团队已有 Java 业务系统需要 Agent 去调用。示例只用 JDK，在 JDK 26（JDK 21+ 即可）上实际运行通过；Spring 代码为示意，未编译。以官方文档为准：https://docs.spring.io/spring-boot/ 。

解释说明

与你熟悉的技术对照

概念	Java / Spring Boot	Go	Python / FastAPI
数据类	`record`	struct	`dataclass` / Pydantic 模型
路由	`@RestController` + `@GetMapping`	Gin 路由	`@app.get`
依赖注入	IoC 容器 + 构造器注入	手动在 main 中组装	`Depends`
参数校验	`@Valid` + Bean Validation	binding 标签	Pydantic
数据访问	Spring Data JPA / MyBatis	database/sql、sqlc、GORM	SQLAlchemy
事务	`@Transactional`	手动 `tx.Begin/Commit`	`session.begin()`
并发	线程池、虚拟线程（JDK 21）	goroutine	asyncio
构建	Maven / Gradle	go build	uv / pip

Spring 的核心概念

IoC 容器：对象（Bean）由容器创建和管理，你声明依赖，容器注入。推荐构造器注入（依赖不可变、便于测试）。
分层：Controller（接收请求）→ Service（业务逻辑、事务）→ Repository（数据访问）。
自动配置：Spring Boot 根据依赖和配置自动创建常用组件（数据源、Web 服务器），配置在 application.yml。
@Transactional 的坑：基于代理实现，同一个类内部方法调用不经过代理，事务不生效；默认只对运行时异常回滚。
AI 相关：Spring AI、LangChain4j 等框架让 Java 项目也能接入大模型（版本变化快，以官方文档为准）。

怎么快速读懂一个 Spring Boot 项目

看 pom.xml / build.gradle：依赖了什么。
找带 @SpringBootApplication 的启动类。
看 application.yml：数据库、端口、外部服务地址。
从 Controller 顺着调用链读到 Service 和 Repository。
看全局异常处理（@RestControllerAdvice）和拦截器 / 过滤器（鉴权）。

案例

你负责的 Python Agent 需要调用公司的 Java 订单服务：读懂它的接口定义（Controller 和 DTO）、错误码、鉴权方式、分页规则，把它封装成 Agent 的工具。

代码示例

只用 JDK 的对照示例 examples/java-basics/OrderDemo.java（java OrderDemo.java 运行通过）：record、接口 + 构造器注入、Optional、Stream 分组汇总、BigDecimal 金额、虚拟线程。

跨租户查询被拒绝: 订单不存在: B001
t1 按状态汇总: {paid=20.00, refunded=5.00}
用 double 计算金额的问题: 0.1 + 0.2 = 0.30000000000000004
1000 个虚拟线程计数结果: 1000

对应的 Spring Boot 写法（示意，未编译）：

@RestController
@RequestMapping("/orders")
class OrderController {
    private final OrderService service;
    OrderController(OrderService service) { this.service = service; }   // 构造器注入，无需 @Autowired

    @GetMapping("/{id}")
    OrderDto get(@PathVariable String id, @RequestHeader("X-Tenant-Id") String tenant) {
        return OrderDto.from(service.get(tenant, id));
    }
}

@Service
class OrderService {
    private final OrderRepository repo;
    OrderService(OrderRepository repo) { this.repo = repo; }

    @Transactional
    public void refund(String tenant, String id) { /* 修改订单 + 写退款记录，在一个事务中 */ }
}

@RestControllerAdvice
class GlobalErrors {
    @ExceptionHandler(NotFoundException.class)
    ResponseEntity<Map<String, String>> notFound(NotFoundException e) {
        return ResponseEntity.status(404).body(Map.of("code", "NOT_FOUND", "message", e.getMessage()));
    }
}

易错点

金额用 double。
同类内部调用带 @Transactional 的方法，以为事务生效。
受检异常被捕获后吞掉，事务没有回滚。
在面试中把“了解”说成“精通”：如实说明能读懂并对接，主语言是 Go / Python。

面试常问

什么是 IoC 和依赖注入？
@Transactional 什么情况下会失效？
你不会 Java，如何和 Java 团队协作？

4.9 KiB Raw Blame History Unescape Escape