Zino开发框架简介

本文为『Zino开发框架技术解读』系列的第一篇。

Zino定位为企业级应用框架，奉行“约定优于配置”的原则，借鉴Node的Egg.js、Java的Spring Boot、Gloang的Beego，提供与axum（已实现）、actix-web（计划中）等框架的集成，目前仍在快速迭代开发中。

1️⃣ 功能特色

开箱即用，快速开发应用。
✨ 极简设计、模块化架构、高层次抽象。
⚡ 兼顾开发效率和性能的平衡。
为PostgreSQL提供高度优化的ORM。
轻量级定时任务。
统一访问存储服务、数据源以及聊天机器人。
支持追踪、度量和日志。

2️⃣ 核心模块

zino-core提供Zino框架的19个核心模块：

• accessor（可选）模块基于OpenDAL提供统一的存储服务操作。
• application模块提供统一的应用接口定义以集成其他框架（如axum、actix-web等）。
• authentication模块提供零信任身份认证相关功能，包括AccessKey、SecurityToken、SessionId以及HTTP签名。
• cache（可选）模块提供基于内存的缓存，目前只支持LRU缓存。
• channel模块实现CloudEvent规范和订阅功能。
• chatbot（可选）模块提供统一的聊天机器人调用接口（目前仅支持OpenAI）。
• connector（可选）模块提供统一的数据源连接、查询接口。
• database（可选）模块为PostgreSQL数据库提供ORM。
• datetime模块提供ISO 8601标准的日期处理功能。
• error模块提供通用的错误类型。
• extend模块通过扩展特性来提供辅助函数。
• i18n模块提供多语言服务支持。
• model模块提供应用模型的高层次抽象。
• request模块提供请求上下文和请求验证功能。
• response模块实现标准化的请求响应。
• schedule模块实现轻量化的调度任务，支持异步任务。
• state模块实现应用域和请求域的状态管理。
• trace模块提供HTTP请求头用于性能度量和追踪。
• view（可选）模块提供HTML模板渲染功能。

3️⃣ 应用目录约定规范

Zino开发框架采用了类似于Egg.js的应用目录约定规范：

• Cargo.toml为应用的Cargo配置文件。
• assets/为可以通过网络访问的静态资源目录，index.html为默认首页文件，404.html为404文件，data/为共享的数据目录。
• config/config.{env}.toml用于编写不同运行环境的配置文件。
• config/locale/{lang-id}.ftl于编写i8n多语言文件（目前仅支持Fluent规范）。
• data/用于放置本地数据文件（不能通过网络访问）。
• logs/用于日志文件输出。
• src/controller/用于编写控制器。
• src/main.rs用于启动应用。
• src/router/用于配置URL路由规则。
• src/schedule/用于编写定时任务。
• src/service/用于编写业务逻辑层。
• templates/用于编写HTML模板文件（目前仅支持Tera模板）。