Websauna项目教程:创建你的第一个数据模型
前言
在Websauna框架中,数据模型是构建Web应用的核心部分。本教程将指导你如何在Websauna项目中创建第一个数据模型,特别是一个投票系统的数据模型。通过这个实例,你将学习到Websauna中模型定义、数据库迁移等关键概念。
模型基础
在Websauna中,模型使用SQLAlchemy进行定义。SQLAlchemy是一个强大的Python ORM(对象关系映射)工具,它允许你使用Python类来表示数据库表。
创建投票模型
我们将创建一个简单的投票系统,包含两个主要模型:
- Question(问题):表示投票的问题
- Choice(选项):表示每个问题的可选答案
在你的models.py
文件中添加以下代码:
from uuid import uuid4
from sqlalchemy import Column, String, Integer, ForeignKey
from websauna.system.model.columns import UUID
from sqlalchemy.orm import relationship
from websauna.system.model.meta import Base
from websauna.system.model.columns import UTCDateTime
class Question(Base):
"""表示投票问题的模型"""
__tablename__ = "question" # 数据库表名
# 主键字段
id = Column(Integer, autoincrement=True, primary_key=True)
# 公开使用的UUID,比自增ID更安全
uuid = Column(UUID(as_uuid=True), default=uuid4)
# 问题文本
question_text = Column(String(256), default=None)
# 发布时间(UTC时间)
published_at = Column(UTCDateTime, default=None)
# 与Choice模型的一对多关系
choices = relationship("Choice",
back_populates="question",
lazy="dynamic",
cascade="all, delete-orphan",
single_parent=True)
class Choice(Base):
"""表示投票选项的模型"""
__tablename__ = "choice" # 数据库表名
# 主键字段
id = Column(Integer, autoincrement=True, primary_key=True)
# 公开使用的UUID
uuid = Column(UUID(as_uuid=True), default=uuid4)
# 选项文本
choice_text = Column(String(256), default=None)
# 投票计数
votes = Column(Integer, default=0)
# 外键关联到Question
question_id = Column(Integer, ForeignKey('question.id'))
question = relationship("Question", back_populates="choices")
关键点解析
-
Base类:所有模型都继承自
websauna.system.model.meta.Base
,这是Websauna提供的默认模型基类。 -
UUID字段:我们使用UUID而不是自增ID作为公开标识符,这提高了安全性,防止恶意用户猜测ID。
-
时间处理:
UTCDateTime
确保所有时间都以UTC格式存储,避免了时区相关的问题。 -
关系定义:我们定义了Question和Choice之间的一对多关系,并配置了级联删除等行为。
数据库迁移
仅仅定义Python模型是不够的,我们还需要将这些变更应用到数据库中。这个过程称为数据库迁移。
为什么需要迁移
当你尝试启动开发服务器时,Websauna的完整性检查会发现数据库结构与模型定义不匹配,导致启动失败。这是Websauna的安全机制,防止你使用不一致的数据库结构。
创建迁移脚本
执行以下命令创建迁移脚本:
ws-alembic -c company/application/conf/development.ini revision --auto -m "Added choices and questions"
这个命令会分析模型与数据库的差异,并生成一个迁移脚本。Websauna使用Alembic来管理数据库迁移。
应用迁移
创建迁移脚本后,执行以下命令将变更应用到数据库:
ws-alembic -c company/application/conf/development.ini upgrade head
注意:PostgreSQL的迁移是事务性的,这意味着整个迁移要么完全成功,要么完全失败。这为迁移过程提供了额外的安全保障。
验证结果
迁移完成后,你可以使用数据库命令行工具检查新创建的表:
ws-db-shell
在数据库shell中,你可以看到新创建的question
和choice
表。
最佳实践
-
小步迁移:每次只做少量模型变更,然后生成并测试迁移脚本。
-
描述性消息:为每个迁移提供清晰的描述信息,方便日后维护。
-
测试环境验证:在应用到生产环境前,先在测试环境中验证迁移。
-
备份:执行重要迁移前,确保有数据库备份。
总结
通过本教程,你学会了:
- 如何在Websauna中定义数据模型
- 模型间关系的配置方法
- 数据库迁移的基本流程
- 模型设计中的安全考虑(如使用UUID)
这些知识为你构建更复杂的Websauna应用打下了坚实基础。在后续教程中,我们将学习如何为这些模型创建视图和表单,实现完整的投票功能。
HunyuanImage-3.0
HunyuanImage-3.0 统一多模态理解与生成,基于自回归框架,实现文本生成图像,性能媲美或超越领先闭源模型00ops-transformer
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。C++045Hunyuan3D-Part
腾讯混元3D-Part00GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~0288Hunyuan3D-Omni
腾讯混元3D-Omni:3D版ControlNet突破多模态控制,实现高精度3D资产生成00GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile09
- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00
项目优选









