# aifei-doc

**Repository Path**: keephealth/aifei-doc

## Basic Information

- **Project Name**: aifei-doc
- **Description**: AICoding框架，AiFei精通文档，你想了解的各种姿势基本都有
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-05-06
- **Last Updated**: 2026-05-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Aifei 框架学习指南

欢迎来到 Aifei 框架的技术文档库！本目录包含丰富的学习主题，帮助你系统地掌握这个优秀框架的核心知识。

## 文件总览

### 核心概念

| 文件                                                 | 主题              |
| ---------------------------------------------------- | ----------------- |
| [01-just-service.md](./01-just-service.md)           | Just Service 范式 |
| [02-hio-model.md](./02-hio-model.md)                 | HIO 模型          |
| [03-db-row-pattern.md](./03-db-row-pattern.md)       | Db + Row 模式     |
| [03-server-dispatcher.md](./03-server-dispatcher.md) | Server Dispatcher |

### AOP 与注入

| 文件                                                     | 主题         |
| -------------------------------------------------------- | ------------ |
| [04-aop-programming.md](./04-aop-programming.md)         | AOP 编程     |
| [04-plugin-architecture.md](./04-plugin-architecture.md) | 插件架构     |
| [07-argument-injection.md](./07-argument-injection.md)   | 参数注入     |
| [08-aop-implementation.md](./08-aop-implementation.md)   | AOP 实现     |
| [08-argument-injection.md](./08-argument-injection.md)   | 参数注入详解 |

### 配置与事务

| 文件                                                           | 主题             |
| -------------------------------------------------------------- | ---------------- |
| [05-config-system.md](./05-config-system.md)                   | 配置系统         |
| [05-transaction-management.md](./05-transaction-management.md) | 事务管理         |
| [12-config-management.md](./12-config-management.md)           | 配置管理         |
| [12-transaction-management.md](./12-transaction-management.md) | 事务管理详解     |
| [20-config-management.md](./20-config-management.md)           | 配置管理进阶     |
| [38-config-management.md](./38-config-management.md)           | 配置管理完整指南 |

### 路由与引擎

| 文件                                               | 主题           |
| -------------------------------------------------- | -------------- |
| [06-router-mechanism.md](./06-router-mechanism.md) | 路由机制       |
| [06-sql-enjoy-engine.md](./06-sql-enjoy-engine.md) | SQL Enjoy 引擎 |
| [13-sql-executor.md](./13-sql-executor.md)         | SQL Executor   |
| [27-enjoy-engine.md](./27-enjoy-engine.md)         | Enjoy 引擎     |

### 批量操作与分页

| 文件                                                         | 主题                  |
| ------------------------------------------------------------ | --------------------- |
| [07-batch-operations.md](./07-batch-operations.md)           | 批量操作              |
| [19-paginate-executor.md](./19-paginate-executor.md)         | Paginate Executor     |
| [20-batch-insert-executor.md](./20-batch-insert-executor.md) | Batch Insert Executor |
| [21-batch-operation.md](./21-batch-operation.md)             | 批量操作详解          |
| [21-batch-update-executor.md](./21-batch-update-executor.md) | Batch Update Executor |
| [22-delete-executor.md](./22-delete-executor.md)             | Delete Executor       |
| [22-pagination.md](./22-pagination.md)                       | 分页查询              |

### 类扫描与生命周期

| 文件                                                       | 主题         |
| ---------------------------------------------------------- | ------------ |
| [09-class-scanner.md](./09-class-scanner.md)               | 类扫描器     |
| [09-thread-safety.md](./09-thread-safety.md)               | 线程安全     |
| [10-lifecycle-management.md](./10-lifecycle-management.md) | 生命周期管理 |
| [10-log-abstraction.md](./10-log-abstraction.md)           | 日志抽象     |

### 路径与主键

| 文件                                                           | 主题              |
| -------------------------------------------------------------- | ----------------- |
| [11-db-row-pattern.md](./11-db-row-pattern.md)                 | Db + Row 模式详解 |
| [11-path-management.md](./11-path-management.md)               | 路径管理          |
| [13-primary-key-generation.md](./13-primary-key-generation.md) | 主键生成策略      |
| [19-path-util.md](./19-path-util.md)                           | 路径工具          |
| [25-primary-key.md](./25-primary-key.md)                       | 主键生成实现      |

### 数据源与方言

| 文件                                                         | 主题           |
| ------------------------------------------------------------ | -------------- |
| [14-database-dialect.md](./14-database-dialect.md)           | 数据库方言     |
| [14-datasource-management.md](./14-datasource-management.md) | 数据源管理     |
| [18-database-dialects.md](./18-database-dialects.md)         | 数据库方言详解 |
| [26-data-source.md](./26-data-source.md)                     | 数据源配置     |

### JSON 处理

| 文件                                                       | 主题              |
| ---------------------------------------------------------- | ----------------- |
| [15-json-serialization.md](./15-json-serialization.md)     | JSON 序列化       |
| [16-json-deserialization.md](./16-json-deserialization.md) | JSON 反序列化     |
| [30-json-serialization.md](./30-json-serialization.md)     | JSON 序列化进阶   |
| [30-json-writer.md](./30-json-writer.md)                   | JsonWriter        |
| [31-json-deserialization.md](./31-json-deserialization.md) | JSON 反序列化进阶 |
| [31-json-reader.md](./31-json-reader.md)                   | JsonReader        |

### 钩子与类型转换

| 文件                                           | 主题       |
| ---------------------------------------------- | ---------- |
| [15-hook-mechanism.md](./15-hook-mechanism.md) | Hook 机制  |
| [16-type-converter.md](./16-type-converter.md) | 类型转换器 |

### 高性能 IO

| 文件                                                     | 主题           |
| -------------------------------------------------------- | -------------- |
| [17-high-performance-io.md](./17-high-performance-io.md) | 高性能 IO      |
| [17-thread-safety.md](./17-thread-safety.md)             | 线程安全详解   |
| [32-byte-writer.md](./32-byte-writer.md)                 | ByteWriter     |
| [32-high-performance-io.md](./32-high-performance-io.md) | 高性能 IO 进阶 |
| [33-utf8-encoder.md](./33-utf8-encoder.md)               | UTF8Encoder    |

### 日志抽象

| 文件                                             | 主题             |
| ------------------------------------------------ | ---------------- |
| [18-log-abstraction.md](./18-log-abstraction.md) | 日志抽象详解     |
| [39-log-abstraction.md](./39-log-abstraction.md) | 日志抽象完整指南 |

### 动态 SQL 与执行器

| 文件                                                       | 主题                 |
| ---------------------------------------------------------- | -------------------- |
| [23-dynamic-sql.md](./23-dynamic-sql.md)                   | 动态 SQL             |
| [23-query-executor.md](./23-query-executor.md)             | Query Executor       |
| [24-change-tracking.md](./24-change-tracking.md)           | 变更追踪             |
| [24-update-executor.md](./24-update-executor.md)           | Update Executor      |
| [25-dao-factory.md](./25-dao-factory.md)                   | Dao Factory          |
| [26-row-factory.md](./26-row-factory.md)                   | Row Factory          |
| [27-transaction-executor.md](./27-transaction-executor.md) | Transaction Executor |
| [28-expression-parser.md](./28-expression-parser.md)       | 表达式解析器         |
| [28-sqlkit-utils.md](./28-sqlkit-utils.md)                 | SqlKit 工具类        |
| [29-directive-system.md](./29-directive-system.md)         | Directive 系统       |

### 模板引擎

| 文件                                             | 主题            |
| ------------------------------------------------ | --------------- |
| [34-template-engine.md](./34-template-engine.md) | Template Engine |
| [35-lexer-parser.md](./35-lexer-parser.md)       | Lexer 和 Parser |

### HTTP 与文件上传

| 文件                                     | 主题         |
| ---------------------------------------- | ------------ |
| [36-http-client.md](./36-http-client.md) | HTTP Client  |
| [37-file-upload.md](./37-file-upload.md) | 文件上传处理 |

### IoC 容器

| 文件                                         | 主题          |
| -------------------------------------------- | ------------- |
| [40-ioc-container.md](./40-ioc-container.md) | IoC Container |

## 学习路径建议

### 初学者入门

1. **核心概念**：从 `01-just-service.md` 和 `02-hio-model.md` 开始，理解 Just Service 范式和 HIO 模型
2. **数据库访问**：学习 `03-db-row-pattern.md` 和 `06-sql-enjoy-engine.md`，掌握数据库操作基础
3. **请求处理**：了解 `03-server-dispatcher.md` 和 `06-router-mechanism.md`

### 进阶学习

1. **AOP 与注入**：深入学习 `04-aop-programming.md`、`08-aop-implementation.md` 和参数注入相关文档
2. **事务管理**：掌握 `05-transaction-management.md` 和 `27-transaction-executor.md`
3. **批量操作**：学习 `07-batch-operations.md`、`20-batch-insert-executor.md` 和 `21-batch-update-executor.md`

### 源码阅读路径

```
请求处理流程:
  Router → Server Dispatcher → Handler → Input/Output

数据访问层:
  Db → SqlExecutor → Row → Transaction → DataSource

扩展机制:
  AOP → IoC Container → Plugin → Hook
```

## 项目结构

```
tech/
├── README.md                    # 索引文件（本文件）
├── 01-just-service.md           # Just Service 范式
├── 02-hio-model.md              # HIO 模型
├── 03-db-row-pattern.md         # Db + Row 模式
├── 03-server-dispatcher.md      # Server Dispatcher
├── ...
└── 40-ioc-container.md          # IoC Container
```

## 文件统计

| 类别              | 文件数 |
| ----------------- | ------ |
| 核心概念          | 4      |
| AOP 与注入        | 5      |
| 配置与事务        | 6      |
| 路由与引擎        | 4      |
| 批量操作与分页    | 6      |
| 类扫描与生命周期  | 4      |
| 路径与主键        | 5      |
| 数据源与方言      | 4      |
| JSON 处理         | 6      |
| 钩子与类型转换    | 2      |
| 高性能 IO         | 5      |
| 日志抽象          | 2      |
| 动态 SQL 与执行器 | 10     |
| 模板引擎          | 2      |
| HTTP 与文件上传   | 2      |
| IoC 容器          | 1      |
| **总计**          | **70** |

---

**更新日期**：2024年
**版本**：v1.0