用java的视角打开大模型与python学习02

文章目录

      • [1、入口参数必须经 Pydantic 校验](#1、入口参数必须经 Pydantic 校验)
      • [2、可选字段标注 `OptionalT` 或 `T | None`](#2、可选字段标注 Optional[T] 或 T | None)
      • 3、公开函数必须有类型注解
      • [4、通过 `mypy --strict` 检查](#4、通过 mypy --strict 检查)
      • [5、I/O 操作(数据库、HTTP)必须 `async/await`,不混用同步阻塞调用](#5、I/O 操作(数据库、HTTP)必须 async/await,不混用同步阻塞调用)

1、入口参数必须经 Pydantic 校验

翻译:controller层的入参必须通过继承Pydantic的BaseModel进行格式校验。校验时如果格式不一样先强制转换,转换成功也算正确。

复制代码
from datetime import datetime
from pydantic import BaseModel
# 1. 定义数据模型
class User(BaseModel):
    id: int
    name: str = "John Doe"  # 有默认值,可选
    signup_ts: datetime | None = None  # 允许为None,但如果是字符串会转成datetime
# 2. 外部来的数据,类型有些"不标准"
external_data = {
    'id': '123',  # 这是个字符串!
    'signup_ts': '2026-07-29 12:00',  # 这也是个字符串!
}
# 3. Pydantic自动校验和转换
user = User(**external_data)
print(user.id)          # 输出: 123 (已经是int了)
print(user.signup_ts)   # 输出: 2026-07-29 12:00:00 (已变成datetime对象)

如果需要抛出异常使用对应方法

复制代码
from pydantic import BaseModel, ValidationError
class User(BaseModel):
    id: int
    name: str
# 故意传入错误数据
try:
    user = User(id="abc", name="Alice")  # "abc" 无法转成 int
except ValidationError as e:
    print(e)

如果使用了FastAPI框架,则自动处理异常

复制代码
from fastapi import FastAPI
app = FastAPI()
@app.post("/items/")
async def create_item(item: Item):  # FastAPI 会基于 'Item' 这个注解来校验请求体
    return item

2、可选字段标注 Optional[T] 或 T | None

翻译:可以为空的参数,代码里写明可以为空

复制代码
# ❌ 不标 Optional → 必填
class CreateTaskRequest(BaseModel):
    task_type: str          # 必填,不传 → 422 报错
# ✅ 标 Optional → 可选
class CreateTaskRequest(BaseModel):
    task_type: str                    # 必填
    timeout: int | None = None        # 可选,不传就是 None
    remark: Optional[str] = None      # 同上,老写法

3、公开函数必须有类型注解

翻译:公开可以调用的方法必须写上返回类型和参数类型

复制代码
// Java 每个方法都必须写类型
public UserResponse getUser(Long id) { ... }
//     ↑返回类型        ↑参数类型

# ❌ 禁止
def process(data, flag):
    ...

# ✅ 必须
def process(data: dict, flag: bool) -> ProcessResult:
    ...

4、通过 mypy --strict 检查

翻译:

复制代码
javac = 编译 + 类型检查(二合一)
Python 世界:
  python 解释器 ≈ JVM(只运行,不检查类型)
  mypy ≈ 单独的类型检查工具(只检查,不编译)

mypy --strict src/ 是最强的检查,可以通过三种方式进行:

复制代码
方式一:命令行指定参数
mypy --strict src/ 
方式二:配置文件
# pyproject.toml
[tool.mypy]
python_version = "3.12"
strict = true
ignore_missing_imports = true
然后运行:
mypy src/  # 自动读取配置文件
方式三:混合使用
配置文件是基础,命令行参数可以覆盖
mypy --strict src/   # 临时开启 strict,覆盖配置文件
mypy --no-strict-optional src/  # 临时关闭某个检查

5、I/O 操作(数据库、HTTP)必须 async/await,不混用同步阻塞调用

翻译:SpringBoot每个请求开启一个线程;FastAPI一个进程一个线程,每个用户访问进入的是同一个线程,需要在I/O操作时让出线程。生产时可通过配置Worker数量去扩充进程。

相关推荐
承渊政道1 小时前
【Python编程—从入门到实践】(用户账户:给Django网站装上登录系统,让每个人拥有自己的学习笔记)
python·学习·pycharm·django
装不满的克莱因瓶1 小时前
【从零搭建】AI大模型之ReactAgent智能体对接MCP实战
java·人工智能·ai·springai·mcp·springaialibaba
SimonKing2 小时前
AI Assistant被"隐藏"了?别慌,IDEA 2026.3 这波是换了个脑子
java·后端·程序员
诗句藏于尽头2 小时前
游戏《完美神话》-使用Ai-agent进行修复已停服游戏到本地成功部署以及GM端网页完整教程
人工智能·学习·游戏
Resean02232 小时前
SpringMVC 6+源码分析(九)异常处理
java·spring·springmvc
希和20272 小时前
51 单片机学习笔记:LCD1602、独立按键、I2C 与 AT24C02 掉电存储(江科大课程小白笔记)
笔记·单片机·学习
geats人山人海2 小时前
现代c++4.1
java·开发语言·c++
承渊政道2 小时前
【Python编程—从入门到实践】(设置样式并部署:给Django网站换新装,把学习笔记发布到互联网)
python·学习·pycharm·django
用户298698530143 小时前
使用 Python 将 JSON 转换为 Word 文档的实践指南
python·json·api
下一站春风里3 小时前
Spring IoC 控制反转 完整技术笔记
java·spring boot·笔记·spring