PART 3 - 后端（FastAPI & Spring Boot）

src
└── main
    ├── java
    │   └── com
    │       └── example
    │           └── myapp
    │               ├── MyApplication.java      // Spring Boot 启动类
    │               ├── config                  // 配置类 (如 Spring Security, MyBatis, Swagger)
    │               ├── controller              // 控制层 (处理 HTTP 请求, 调用 Service)
    │               ├── service                 // 业务逻辑层
    │               │   └── impl                // Service 的实现类
    │               ├── repository / mapper     // 数据访问层 (JPA Repository, MyBatis Mapper)
    │               ├── model                   // 数据模型层
    │               │   ├── entity              // 数据库实体 (Entity)
    │               │   └── dto                 // 数据传输对象 (Data Transfer Object)
    │               ├── exception               // 自定义异常及全局异常处理器
    │               └── utils                   // 工具类
    └── resources
        ├── application.yml                     // 主配置文件
        ├── application-dev.yml                 // 开发环境配置
        ├── application-prod.yml                // 生产环境配置
        ├── static                              // 静态资源
        ├── templates                           // 模板文件 (如 Thymeleaf)
        └── mapper                              // MyBatis XML 文件

.
├── app                   // 应用主目录
│   ├── __init__.py
│   ├── main.py           // FastAPI 应用实例和启动入口
│   ├── api               // API 路由层
│   │   ├── __init__.py
│   │   └── v1            // API 版本
│   │       ├── __init__.py
│   │       ├── endpoints // 按资源划分路由文件
│   │       │   ├── user.py
│   │       │   └── article.py
│   │       └── deps.py   // 依赖注入项 (如获取当前用户, 数据库 session)
│   ├── core              // 核心配置
│   │   ├── __init__.py
│   │   └── config.py     // 配置加载 (如环境变量)
│   ├── crud              // 数据库操作层 (CRUD: Create, Read, Update, Delete)
│   │   ├── __init__.py
│   │   ├── crud_user.py
│   │   └── base.py       // 通用 CRUD 基类
│   ├── models            // 数据库模型 (SQLAlchemy Models)
│   │   ├── __init__.py
│   │   └── user.py
│   ├── schemas           // 数据校验层 (Pydantic Schemas)
│   │   ├── __init__.py
│   │   └── user.py       // 定义请求体、响应体的 Pydantic 模型
│   └── db                // 数据库相关
│       ├── __init__.py
│       └── session.py    // 数据库引擎和 session 创建
├── .env                  // 环境变量文件
├── requirements.txt      // Python 依赖
└── ...

// Result.java
public class Result<T> {
    private int code;
    private String msg;
    private T data;

    // 构造函数、Getter/Setter 省略...

    public static <T> Result<T> success(T data) {
        Result<T> result = new Result<>();
        result.setCode(0);
        result.setMsg("成功");
        result.setData(data);
        return result;
    }

    public static <T> Result<T> error(int code, String msg) {
        Result<T> result = new Result<>();
        result.setCode(code);
        result.setMsg(msg);
        return result;
    }
}

// 在 Controller 中使用
@GetMapping("/user/{id}")
public Result<UserDTO> getUserById(@PathVariable Long id) {
    UserDTO user = userService.findUserById(id);
    return Result.success(user);
}

# schemas/response.py
from typing import Generic, TypeVar, Optional
from pydantic import BaseModel, Field

T = TypeVar('T')

class ResponseModel(BaseModel, Generic[T]):
    code: int = Field(0, description="状态码")
    msg: str = Field("成功", description="消息")
    data: Optional[T] = None

# 在 endpoint 中使用
from app.schemas.response import ResponseModel
from app.schemas.user import User # Pydantic schema for user

@router.get("/{user_id}", response_model=ResponseModel[User])
def read_user(user_id: int):
    # db_user = crud.user.get(db, id=user_id)
    # ...
    # return {"code": 0, "msg": "成功", "data": db_user}
    # 或者直接返回 ORM model, FastAPI 会自动序列化
    return {"data": db_user} # code 和 msg 会使用默认值

public class UserDTO {
    private Long id;
    private String username;
    private String avatar;
    // 没有 password 字段
}

from pydantic import BaseModel

# 用于创建用户的请求体
class UserCreate(BaseModel):
    username: str
    password: str

# 用于响应的 Schema
class User(BaseModel):
    id: int
    username: str
    avatar: str | None = None

    class Config:
        from_attributes = True # 兼容 ORM 模型

# api/v1/deps.py
from fastapi import Depends, HTTPException, status
from fastapi.security import OAuth2PasswordBearer

oauth2_scheme = OAuth2PasswordBearer(tokenUrl="token")

async def get_current_user(token: str = Depends(oauth2_scheme)):
    # 这里是解码和验证 JWT 的逻辑
    # ...
    if not user:
        raise HTTPException(
            status_code=status.HTTP_401_UNAUTHORIZED,
            detail="Invalid authentication credentials",
        )
    return user

// CreateUserDTO.java
public class CreateUserDTO {
    @NotBlank(message = "用户名不能为空")
    @Size(min = 3, max = 20, message = "用户名长度必须在3-20之间")
    private String username;
    // ...
}

/**
 * 根据用户ID查找用户，并转换为DTO.
 * @param id 用户的唯一标识ID
 * @return 包含用户信息的DTO对象
 * @throws UserNotFoundException 如果用户不存在
 */
public UserDTO findUserById(Long id) {
    // ...
}

def get_user_by_id(db: Session, user_id: int) -> models.User:
    """Gets a user by their ID.

    Args:
        db: The database session.
        user_id: The ID of the user to retrieve.

    Returns:
        The user object from the database.
    """
    # ...