做网站需要学会什么软件免费虚拟主机网站

做网站需要学会什么软件,免费虚拟主机网站,制作网页的软件dw,专业仿站网站建设#x1f3af; 3 分钟读完本文#xff0c;你将获得#xff1a; 一套开箱即用的企业级 FastAPI 项目架构解决 FastAPI 项目从 Demo 到生产的所有痛点掌握分层架构、自动迁移、缓存等最佳实践节省至少 2 周的项目搭建时间 #x1f62b; 你是否遇到过这些问题#xff1f; 场景…3 分钟读完本文你将获得一套开箱即用的企业级 FastAPI 项目架构解决 FastAPI 项目从 Demo 到生产的所有痛点掌握分层架构、自动迁移、缓存等最佳实践节省至少 2 周的项目搭建时间 你是否遇到过这些问题场景一项目越写越乱刚开始用 FastAPI 写项目时所有代码都塞在main.py里# main.py - 500 行代码的噩梦app.get(/users)asyncdefget_users():# 数据库查询# 业务逻辑# 数据验证# 返回结果# 全部混在一起...结果代码难以维护团队协作困难新人看不懂老人不想改。场景二数据库迁移是噩梦每次修改数据库模型都要手动写 SQL# 又加了一个字段怎么办classUser(Base):# ... 原有字段avatar:str# 新增字段 - 需要手动 ALTER TABLE结果开发环境、测试环境、生产环境数据库结构不一致上线就出 Bug。场景三接口性能问题# 每次都查数据库慢得要死app.get(/hot-data)asyncdefget_hot_data():returnawaitdb.query(...)# 这个接口被调用 1000 次/秒结果数据库压力大响应慢用户体验差。场景四异常处理不统一# 到处都是 try-except返回格式五花八门try:resultawaitsome_operation()return{code:200,data:result}exceptExceptionase:return{error:str(e)}# 另一个接口返回 {msg: str(e)}结果前端对接困难错误难以追踪。 解决方案FastAPI Best Architecture我基于 Dash-FastAPI-Admin 的优秀设计结合实际项目经验打造了这套开箱即用的企业级架构模板。GitHub 地址https://github.com/LijiangTn/fastapi-best-architecture⭐ 核心亮点1️⃣ 清晰的分层架构Controller路由层 ↓ 只负责接收请求和返回响应 Service业务层 ↓ 处理业务逻辑 DAO数据访问层 ↓ 封装数据库操作 Entity实体层 ↓ 定义数据模型代码示例# Controller - 简洁明了userController.get(/list)asyncdefget_user_list(db:AsyncSessionDepends(get_db),user_filter:UserFilterFilterDepends(UserFilter)):queryUserService.get_user_list_query(user_filter)resultawaitpaginate(db,query)returnResponseUtil.success(dataresult)# Service - 业务逻辑classUserService:classmethoddefget_user_list_query(cls,user_filterNone):returnUserDao.get_user_list_query(user_filter)# DAO - 数据库操作classUserDao:classmethoddefget_user_list_query(cls,user_filterNone):queryselect(UserManager).where(UserManager.is_deleted0)ifuser_filter:queryuser_filter.filter(query)returnquery好处✅ 职责清晰易于维护✅ 团队协作不冲突✅ 单元测试更容易✅ 代码复用率高2️⃣ 智能数据库迁移再也不用手动写 ALTER TABLE 了# 只需修改模型classUser(Base):__tablename__user_manageridColumn(Integer,primary_keyTrue)usernameColumn(String(50),nullableFalse)avatarColumn(String(255))# 新增字段启动项目自动迁移 开始执行数据库迁移... 正在迁移表: user_manager 添加 1 个字段到 user_manager ✓ avatar ✓ user_manager 迁移成功 ✓ 数据库迁移全部完成 特性✅ 自动对比模型和数据库结构✅ 智能生成 ALTER TABLE 语句✅ 支持字段类型、默认值、注释✅ 安全的事务处理失败自动回滚3️⃣ 一行代码实现接口缓存fromfastapi_cache.decoratorimportcacheuserController.get(/list)cache(expire120)# 缓存 2 分钟asyncdefget_user_list(...):# 第一次查数据库之后走 Redispass效果 接口响应从 200ms 降到 5ms 数据库压力降低 90% 用户体验显著提升4️⃣ 强大的查询过滤器支持复杂查询无需手写 SQL# 定义过滤器classUserFilter(Filter):username__ilike:Optional[str]# 模糊查询email__ilike:Optional[str]is_active:Optional[int]create_time__gte:Optional[datetime]# 时间范围create_time__lte:Optional[datetime]order_by:list[str][-create_time]# 排序使用示例# 基础分页GET /api/v1/user/list?page1size20# 用户名模糊查询GET /api/v1/user/list?username__ilikezhang# 时间范围 状态筛选 排序GET /api/v1/user/list?create_time__gte2024-01-01is_active1order_by-create_time支持的操作符eq- 等于neq- 不等于gt/gte- 大于/大于等于lt/lte- 小于/小于等于like/ilike- 模糊查询区分/不区分大小写in/not_in- 包含/不包含isnull/notnull- 为空/不为空5️⃣ 统一响应格式所有接口返回格式一致{code:200,msg:操作成功,data:{...},success:true,time:2024-12-12T10:30:00}使用方式# 成功returnResponseUtil.success(dataresult)# 失败returnResponseUtil.failure(msg用户名已存在)# 错误returnResponseUtil.error(msg系统异常)# 未授权returnResponseUtil.unauthorized(msg登录已过期)好处✅ 前端对接简单✅ 错误处理统一✅ 日志追踪方便6️⃣ 完善的异常处理全局异常捕获再也不用到处写 try-except# 自定义异常classServiceException(Exception):服务异常pass# 业务代码中直接抛出ifnotuser:raiseServiceException(用户不存在)# 全局异常处理器自动捕获并返回统一格式# 无需手动处理支持的异常类型AuthException- 认证异常401PermissionException- 权限异常403ServiceException- 服务异常500ServiceWarning- 业务警告200ModelValidatorException- 模型验证异常7️⃣ 智能日志管理基于 Loguru自动分级存储fromutils.log_utilimportlogger logger.info(用户登录成功)logger.warning(密码错误次数过多)logger.error(数据库连接失败)日志文件logs/FasAPIStarter_error_2024-12-12.log- 错误日志logs/FasAPIStarter_other_2024-12-12.log- 其他日志特性✅ 自动按日期分文件✅ 自动压缩归档✅ 支持日志轮转50MB✅ 彩色终端输出 快速开始1. 克隆项目gitclone https://github.com/LijiangTn/fastapi-best-architecture.gitcdfastapi-best-architecture2. 安装依赖pipinstall-r requirements.txt3. 配置环境修改.env.dev文件# 数据库配置DB_HOSTlocalhostDB_PORT3306DB_USERNAMErootDB_PASSWORDyour_passwordDB_DATABASEyour_database# Redis 配置REDIS_HOSTlocalhostREDIS_PORT63794. 启动服务python main.py5. 访问文档打开浏览器访问http://localhost:8081/api/docs 技术栈技术版本说明FastAPI0.115.0高性能 Web 框架SQLAlchemy2.0.31异步 ORMPydantic2.10.5数据验证Redis5.0.7缓存数据库Loguru0.7.2日志库APScheduler3.10.4定时任务 适用场景✅ 适合你如果你 刚开始学习 FastAPI想要一个规范的项目结构 需要快速搭建企业级后端服务 团队协作开发需要统一的代码规范 追求高性能、高可维护性的项目架构 想学习 FastAPI 最佳实践❌ 不适合你如果你只是写个简单的 Demo用不上这么复杂的架构不需要数据库和缓存喜欢自己从零搭建那你可以参考学习 项目对比特性传统写法FastAPI Best Architecture项目结构混乱难以维护✅ 清晰的分层架构数据库迁移手动写 SQL✅ 自动智能迁移接口缓存需要手动实现✅ 装饰器一行搞定查询过滤手写复杂 SQL✅ 声明式过滤器异常处理到处 try-except✅ 全局统一处理响应格式五花八门✅ 统一格式日志管理print 调试✅ 分级存储上手难度需要自己摸索✅ 开箱即用 贡献与支持如何贡献欢迎提交 Issue 和 Pull Request 发现 Bug提交 Issue 有好的想法发起讨论 想要贡献代码Fork 项目并提交 PR支持项目如果这个项目对你有帮助请⭐ 给项目点个 Star 分享给你的朋友 写一篇使用体验文章 相关资源项目地址https://github.com/LijiangTn/fastapi-best-architectureFastAPI 官方文档https://fastapi.tiangolo.comSQLAlchemy 文档https://docs.sqlalchemy.org原始项目https://github.com/HogaStack/Dash-FastAPI-Admin 总结FastAPI Best Architecture 不仅仅是一个项目模板更是一套经过实战验证的最佳实践。你将获得✅节省时间- 不用再从零搭建项目架构✅提升质量- 遵循最佳实践代码更规范✅加速开发- 开箱即用的功能模块✅降低风险- 完善的异常处理和日志系统✅易于维护- 清晰的分层架构立即开始gitclone https://github.com/LijiangTn/fastapi-best-architecture.gitcdfastapi-best-architecture pipinstall-r requirements.txt python main.py3 分钟你就能拥有一个企业级的 FastAPI 项目如果觉得有用别忘了给个 ⭐️ StarMade with ❤️ by Li Jiang