springbootAI 2.3.4__tar.gz → 2.3.5__tar.gz

{springbootai-2.3.4 → springbootai-2.3.5}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [2.3.5] - 2026-08-20
+
+### 文档与发布
+
+- 发布版本升级到 `2.3.5`，同步框架主包、扩展模块、PyMyBatis 内嵌版本、README 版本矩阵和打包元数据。
+- README 首页新增 SpringBootAI 在线考试认证与证书说明，提供认证入口、适用场景、备考流程和重点知识范围。
+- 认证平台入口：[http://www.yucg.cn:8230](http://www.yucg.cn:8230)。
+
 ## [2.3.4] - 2026-08-19
 
 ### 新增与完善

{springbootai-2.3.4/springbootAI.egg-info → springbootai-2.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: springbootAI
-Version: 2.3.4
+Version: 2.3.5
 Summary: Spring-style Python framework with Web, ORM, Cloud and AI integrations
 Author-email: YuConggen <1516933915@qq.com>
 License-Expression: MIT
@@ -163,9 +163,41 @@ Dynamic: license-file
 # SpringBootAI
 
 <p align="center">
-  <img src="doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
+  <img src="https://raw.githubusercontent.com/YUCONGGEN/springbootAI/master/doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
 </p>
 
+## SpringBootAI 考试认证与证书
+
+SpringBootAI 已提供配套的在线考试认证平台，学习者、团队成员和项目使用方可以通过认证考试检验自己对框架核心能力的掌握情况，并在通过考试后获得对应证书。
+
+认证入口：[http://www.yucg.cn:8230](http://www.yucg.cn:8230)
+
+认证适合以下场景：
+
+- **个人学习证明**：用于记录自己已经系统学习 SpringBootAI 的 Web、IoC、配置、数据访问、AOP、AI 扩展和生产治理等核心内容。
+- **团队能力评估**：团队引入 SpringBootAI 前，可以让成员通过统一考试确认基础概念、开发规范和常见问题处理能力。
+- **项目交付背书**：在培训、内部推广、项目验收或技术选型说明中，证书可作为使用者熟悉框架体系和最佳实践的辅助证明。
+- **持续学习路径**：认证内容覆盖从入门到进阶的关键知识点，适合结合 README、模块文档和示例工程逐步学习后再参加考试。
+
+建议的认证准备流程：
+
+1. 先按 README 中的“10 分钟跑通第一个接口”完成本地环境搭建，确认能够创建应用、启动服务并访问 Swagger。
+2. 阅读 [新手指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md)，理解 `@SpringBootApplication`、`@RestController`、`@Service`、`@Autowired`、配置文件和依赖注入的基本用法。
+3. 根据实际使用方向阅读模块文档，例如 Web MVC、ORM、事务、缓存、安全、配置绑定、测试切片、AI、LangChain、LangGraph、MCP 和 Cloud 微服务等。
+4. 运行示例或编写一个小型业务接口，至少覆盖 Controller、Service、配置读取、异常处理、Swagger 文档和数据访问中的若干能力。
+5. 访问认证平台参加考试，通过后按平台页面提示查看、下载或领取证书。证书信息、考试规则、题量、通过标准和有效期以认证平台展示为准。
+
+认证重点建议关注：
+
+| 方向 | 建议掌握内容 |
+|---|---|
+| 快速入门 | 安装方式、项目结构、启动入口、扫描包、`application.yml`、Swagger 访问 |
+| Web 与 IoC | 路由映射、参数绑定、Controller/Service 分层、Bean 注册、依赖注入、生命周期 |
+| 数据与事务 | PyMyBatis Mapper、XML Mapper、分页、动态 SQL、事务边界、回滚行为 |
+| 工程治理 | 配置合并、Profile、日志、健康检查、Prometheus、限流、熔断、测试切片 |
+| 安全能力 | JWT、密码加密、SQL 注入防护、CSRF、OAuth2、访问控制与常见错误处理 |
+| AI 生态 | ChatClient、Tools、RAG、Advisor、LangChain、LangGraph、MCP client/server |
+
 [![PyPI](https://img.shields.io/pypi/v/springbootAI)](https://pypi.org/project/springbootAI/)
 [![Python](https://img.shields.io/pypi/pyversions/springbootAI)](https://pypi.org/project/springbootAI/)
 [![CI](https://github.com/YUCONGGEN/springbootAI/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/YUCONGGEN/springbootAI/actions/workflows/ci.yml)
@@ -183,7 +215,7 @@ SpringBootAI 是一个采用 Spring 风格注解和分层结构的 Python 应用
 | AI 与编排 | 模型调用、Tools、RAG、Chain、状态图、MCP client/server | LangChain / LangGraph / 官方 MCP SDK |
 | 生产治理 | 健康检查、Prometheus、限流熔断、追踪、Swagger | prometheus-client / OpenTelemetry / OpenAPI |
 
-当前版本是 `2.3.2`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 对接官方 TC + TCC 回调；`at` 模式通过 ORM 拦截器自动生成 undo_log 实现自动回滚。
+当前版本是 `2.3.5`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 对接官方 TC + TCC 回调；`at` 模式通过 ORM 拦截器自动生成 undo_log 实现自动回滚。
 
 [新手指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md) | [全部文档](https://github.com/YUCONGGEN/springbootAI/tree/master/doc) | [变更日志](https://github.com/YUCONGGEN/springbootAI/blob/master/CHANGELOG.md) | [安全报告](https://github.com/YUCONGGEN/springbootAI/blob/master/SECURITY.md) | [发布检查](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/RELEASE_CHECKLIST.md)
 
@@ -364,10 +396,10 @@ SpringBootAI 是一个 **Python Web 框架**。它把 Java Spring Boot 的"注
 
 | 组件 | 当前版本 |
 |------|----------|
-| `springbootai` 框架 API | 2.3.2 |
-| `springbootai.orm.pymybatis` | 2.3.2 |
-| `springbootai.ai` AI 模块 | 2.3.2 |
-| `springbootai.langchain` LangChain 模块 | 2.3.2 |
+| `springbootai` 框架 API | 2.3.5 |
+| `springbootai.orm.pymybatis` | 2.3.5 |
+| `springbootai.ai` AI 模块 | 2.3.5 |
+| `springbootai.langchain` LangChain 模块 | 2.3.5 |
 | Python | 3.10+ |
 
 ### 1.4 适合什么场景

{springbootai-2.3.4 → springbootai-2.3.5}/README.md

@@ -1,9 +1,41 @@
 # SpringBootAI
 
 <p align="center">
-  <img src="doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
+  <img src="https://raw.githubusercontent.com/YUCONGGEN/springbootAI/master/doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
 </p>
 
+## SpringBootAI 考试认证与证书
+
+SpringBootAI 已提供配套的在线考试认证平台，学习者、团队成员和项目使用方可以通过认证考试检验自己对框架核心能力的掌握情况，并在通过考试后获得对应证书。
+
+认证入口：[http://www.yucg.cn:8230](http://www.yucg.cn:8230)
+
+认证适合以下场景：
+
+- **个人学习证明**：用于记录自己已经系统学习 SpringBootAI 的 Web、IoC、配置、数据访问、AOP、AI 扩展和生产治理等核心内容。
+- **团队能力评估**：团队引入 SpringBootAI 前，可以让成员通过统一考试确认基础概念、开发规范和常见问题处理能力。
+- **项目交付背书**：在培训、内部推广、项目验收或技术选型说明中，证书可作为使用者熟悉框架体系和最佳实践的辅助证明。
+- **持续学习路径**：认证内容覆盖从入门到进阶的关键知识点，适合结合 README、模块文档和示例工程逐步学习后再参加考试。
+
+建议的认证准备流程：
+
+1. 先按 README 中的“10 分钟跑通第一个接口”完成本地环境搭建，确认能够创建应用、启动服务并访问 Swagger。
+2. 阅读 [新手指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md)，理解 `@SpringBootApplication`、`@RestController`、`@Service`、`@Autowired`、配置文件和依赖注入的基本用法。
+3. 根据实际使用方向阅读模块文档，例如 Web MVC、ORM、事务、缓存、安全、配置绑定、测试切片、AI、LangChain、LangGraph、MCP 和 Cloud 微服务等。
+4. 运行示例或编写一个小型业务接口，至少覆盖 Controller、Service、配置读取、异常处理、Swagger 文档和数据访问中的若干能力。
+5. 访问认证平台参加考试，通过后按平台页面提示查看、下载或领取证书。证书信息、考试规则、题量、通过标准和有效期以认证平台展示为准。
+
+认证重点建议关注：
+
+| 方向 | 建议掌握内容 |
+|---|---|
+| 快速入门 | 安装方式、项目结构、启动入口、扫描包、`application.yml`、Swagger 访问 |
+| Web 与 IoC | 路由映射、参数绑定、Controller/Service 分层、Bean 注册、依赖注入、生命周期 |
+| 数据与事务 | PyMyBatis Mapper、XML Mapper、分页、动态 SQL、事务边界、回滚行为 |
+| 工程治理 | 配置合并、Profile、日志、健康检查、Prometheus、限流、熔断、测试切片 |
+| 安全能力 | JWT、密码加密、SQL 注入防护、CSRF、OAuth2、访问控制与常见错误处理 |
+| AI 生态 | ChatClient、Tools、RAG、Advisor、LangChain、LangGraph、MCP client/server |
+
 [![PyPI](https://img.shields.io/pypi/v/springbootAI)](https://pypi.org/project/springbootAI/)
 [![Python](https://img.shields.io/pypi/pyversions/springbootAI)](https://pypi.org/project/springbootAI/)
 [![CI](https://github.com/YUCONGGEN/springbootAI/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/YUCONGGEN/springbootAI/actions/workflows/ci.yml)
@@ -21,7 +53,7 @@ SpringBootAI 是一个采用 Spring 风格注解和分层结构的 Python 应用
 | AI 与编排 | 模型调用、Tools、RAG、Chain、状态图、MCP client/server | LangChain / LangGraph / 官方 MCP SDK |
 | 生产治理 | 健康检查、Prometheus、限流熔断、追踪、Swagger | prometheus-client / OpenTelemetry / OpenAPI |
 
-当前版本是 `2.3.2`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 对接官方 TC + TCC 回调；`at` 模式通过 ORM 拦截器自动生成 undo_log 实现自动回滚。
+当前版本是 `2.3.5`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 对接官方 TC + TCC 回调；`at` 模式通过 ORM 拦截器自动生成 undo_log 实现自动回滚。
 
 [新手指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md) | [全部文档](https://github.com/YUCONGGEN/springbootAI/tree/master/doc) | [变更日志](https://github.com/YUCONGGEN/springbootAI/blob/master/CHANGELOG.md) | [安全报告](https://github.com/YUCONGGEN/springbootAI/blob/master/SECURITY.md) | [发布检查](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/RELEASE_CHECKLIST.md)
 
@@ -202,10 +234,10 @@ SpringBootAI 是一个 **Python Web 框架**。它把 Java Spring Boot 的"注
 
 | 组件 | 当前版本 |
 |------|----------|
-| `springbootai` 框架 API | 2.3.2 |
-| `springbootai.orm.pymybatis` | 2.3.2 |
-| `springbootai.ai` AI 模块 | 2.3.2 |
-| `springbootai.langchain` LangChain 模块 | 2.3.2 |
+| `springbootai` 框架 API | 2.3.5 |
+| `springbootai.orm.pymybatis` | 2.3.5 |
+| `springbootai.ai` AI 模块 | 2.3.5 |
+| `springbootai.langchain` LangChain 模块 | 2.3.5 |
 | Python | 3.10+ |
 
 ### 1.4 适合什么场景

{springbootai-2.3.4 → springbootai-2.3.5}/pyproject.toml

@@ -12,7 +12,7 @@ build-backend = "setuptools.build_meta"
 [project]
 # Distribution name: springbootAI (pip install springbootAI); import package: springbootai.
 name = "springbootAI"
-version = "2.3.4"
+version = "2.3.5"
 description = "Spring-style Python framework with Web, ORM, Cloud and AI integrations"
 readme = "README.md"
 license = "MIT"

{springbootai-2.3.4 → springbootai-2.3.5/springbootAI.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: springbootAI
-Version: 2.3.4
+Version: 2.3.5
 Summary: Spring-style Python framework with Web, ORM, Cloud and AI integrations
 Author-email: YuConggen <1516933915@qq.com>
 License-Expression: MIT
@@ -163,9 +163,41 @@ Dynamic: license-file
 # SpringBootAI
 
 <p align="center">
-  <img src="doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
+  <img src="https://raw.githubusercontent.com/YUCONGGEN/springbootAI/master/doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
 </p>
 
+## SpringBootAI 考试认证与证书
+
+SpringBootAI 已提供配套的在线考试认证平台，学习者、团队成员和项目使用方可以通过认证考试检验自己对框架核心能力的掌握情况，并在通过考试后获得对应证书。
+
+认证入口：[http://www.yucg.cn:8230](http://www.yucg.cn:8230)
+
+认证适合以下场景：
+
+- **个人学习证明**：用于记录自己已经系统学习 SpringBootAI 的 Web、IoC、配置、数据访问、AOP、AI 扩展和生产治理等核心内容。
+- **团队能力评估**：团队引入 SpringBootAI 前，可以让成员通过统一考试确认基础概念、开发规范和常见问题处理能力。
+- **项目交付背书**：在培训、内部推广、项目验收或技术选型说明中，证书可作为使用者熟悉框架体系和最佳实践的辅助证明。
+- **持续学习路径**：认证内容覆盖从入门到进阶的关键知识点，适合结合 README、模块文档和示例工程逐步学习后再参加考试。
+
+建议的认证准备流程：
+
+1. 先按 README 中的“10 分钟跑通第一个接口”完成本地环境搭建，确认能够创建应用、启动服务并访问 Swagger。
+2. 阅读 [新手指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md)，理解 `@SpringBootApplication`、`@RestController`、`@Service`、`@Autowired`、配置文件和依赖注入的基本用法。
+3. 根据实际使用方向阅读模块文档，例如 Web MVC、ORM、事务、缓存、安全、配置绑定、测试切片、AI、LangChain、LangGraph、MCP 和 Cloud 微服务等。
+4. 运行示例或编写一个小型业务接口，至少覆盖 Controller、Service、配置读取、异常处理、Swagger 文档和数据访问中的若干能力。
+5. 访问认证平台参加考试，通过后按平台页面提示查看、下载或领取证书。证书信息、考试规则、题量、通过标准和有效期以认证平台展示为准。
+
+认证重点建议关注：
+
+| 方向 | 建议掌握内容 |
+|---|---|
+| 快速入门 | 安装方式、项目结构、启动入口、扫描包、`application.yml`、Swagger 访问 |
+| Web 与 IoC | 路由映射、参数绑定、Controller/Service 分层、Bean 注册、依赖注入、生命周期 |
+| 数据与事务 | PyMyBatis Mapper、XML Mapper、分页、动态 SQL、事务边界、回滚行为 |
+| 工程治理 | 配置合并、Profile、日志、健康检查、Prometheus、限流、熔断、测试切片 |
+| 安全能力 | JWT、密码加密、SQL 注入防护、CSRF、OAuth2、访问控制与常见错误处理 |
+| AI 生态 | ChatClient、Tools、RAG、Advisor、LangChain、LangGraph、MCP client/server |
+
 [![PyPI](https://img.shields.io/pypi/v/springbootAI)](https://pypi.org/project/springbootAI/)
 [![Python](https://img.shields.io/pypi/pyversions/springbootAI)](https://pypi.org/project/springbootAI/)
 [![CI](https://github.com/YUCONGGEN/springbootAI/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/YUCONGGEN/springbootAI/actions/workflows/ci.yml)
@@ -183,7 +215,7 @@ SpringBootAI 是一个采用 Spring 风格注解和分层结构的 Python 应用
 | AI 与编排 | 模型调用、Tools、RAG、Chain、状态图、MCP client/server | LangChain / LangGraph / 官方 MCP SDK |
 | 生产治理 | 健康检查、Prometheus、限流熔断、追踪、Swagger | prometheus-client / OpenTelemetry / OpenAPI |
 
-当前版本是 `2.3.2`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 对接官方 TC + TCC 回调；`at` 模式通过 ORM 拦截器自动生成 undo_log 实现自动回滚。
+当前版本是 `2.3.5`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 对接官方 TC + TCC 回调；`at` 模式通过 ORM 拦截器自动生成 undo_log 实现自动回滚。
 
 [新手指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md) | [全部文档](https://github.com/YUCONGGEN/springbootAI/tree/master/doc) | [变更日志](https://github.com/YUCONGGEN/springbootAI/blob/master/CHANGELOG.md) | [安全报告](https://github.com/YUCONGGEN/springbootAI/blob/master/SECURITY.md) | [发布检查](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/RELEASE_CHECKLIST.md)
 
@@ -364,10 +396,10 @@ SpringBootAI 是一个 **Python Web 框架**。它把 Java Spring Boot 的"注
 
 | 组件 | 当前版本 |
 |------|----------|
-| `springbootai` 框架 API | 2.3.2 |
-| `springbootai.orm.pymybatis` | 2.3.2 |
-| `springbootai.ai` AI 模块 | 2.3.2 |
-| `springbootai.langchain` LangChain 模块 | 2.3.2 |
+| `springbootai` 框架 API | 2.3.5 |
+| `springbootai.orm.pymybatis` | 2.3.5 |
+| `springbootai.ai` AI 模块 | 2.3.5 |
+| `springbootai.langchain` LangChain 模块 | 2.3.5 |
 | Python | 3.10+ |
 
 ### 1.4 适合什么场景

{springbootai-2.3.4 → springbootai-2.3.5}/springbootAI.egg-info/SOURCES.txt

@@ -76,6 +76,7 @@ springbootai/context/__init__.py
 springbootai/context/application_context.py
 springbootai/context/bean_definition.py
 springbootai/context/bean_factory.py
+springbootai/context/lifecycle.py
 springbootai/context/registry.py
 springbootai/context/scanner.py
 springbootai/core/__init__.py
@@ -268,6 +269,7 @@ tests/test_ai_module.py
 tests/test_annotation_combinations.py
 tests/test_annotations_contract.py
 tests/test_aop_annotations_full.py
+tests/test_aop_pointcut_enhancements.py
 tests/test_audit_time.py
 tests/test_batch.py
 tests/test_bean_utils.py
@@ -296,6 +298,7 @@ tests/test_di_config_event_full.py
 tests/test_excel_module.py
 tests/test_hateoas.py
 tests/test_i18n_module.py
+tests/test_ioc_lifecycle_enhancements.py
 tests/test_jpa_version_transient.py
 tests/test_kafka.py
 tests/test_langchain_comprehensive.py

{springbootai-2.3.4 → springbootai-2.3.5}/springbootai/__init__.py

@@ -19,7 +19,7 @@ from .config import *
 from .utils import *
 from .main import create_app, run, SpringApplication, run_cli
 
-__version__ = "2.3.4"
+__version__ = "2.3.5"
 __author__ = "yuconggen"
 __license__ = "MIT"
 

{springbootai-2.3.4 → springbootai-2.3.5}/springbootai/ai/__init__.py

@@ -54,7 +54,7 @@ from springbootai.ai.observability import AIMetrics, ai_metrics
 from springbootai.ai.autoconfig import AIProperties, bind_ai_config, configure_ai
 from springbootai.ai.annotation_runtime import ContentModerationError
 
-__version__ = "2.3.4"
+__version__ = "2.3.5"
 
 __all__ = [
     # core

{springbootai-2.3.4 → springbootai-2.3.5}/springbootai/annotations/__init__.py

@@ -15,6 +15,7 @@ from .core import (
     Component,
     Aspect,
     Pointcut,
+    Order,
     Before,
     After,
     Around,
@@ -102,6 +103,10 @@ from .conditional import (
     ConditionalOnBean,
     ConditionalOnMissingBean,
     ConditionalOnClass,
+    ConditionalOnMissingClass,
+    ConditionalOnWebApplication,
+    ConditionalOnNotWebApplication,
+    ConditionalOnExpression,
 )
 
 # 可选导入：消息队列注解（RabbitMQ 需要 pika，Kafka 需要 kafka-python）
@@ -174,6 +179,7 @@ __all__ = [
     "Component",
     "Aspect",
     "Pointcut",
+    "Order",
     "Before",
     "After",
     "Around",
@@ -255,6 +261,10 @@ __all__ = [
     "ConditionalOnBean",
     "ConditionalOnMissingBean",
     "ConditionalOnClass",
+    "ConditionalOnMissingClass",
+    "ConditionalOnWebApplication",
+    "ConditionalOnNotWebApplication",
+    "ConditionalOnExpression",
     # 消息队列注解
     "RabbitListener",
     "RabbitTemplate",

{springbootai-2.3.4 → springbootai-2.3.5}/springbootai/annotations/conditional.py

@@ -238,10 +238,118 @@ class ConditionalOnClass(SpringAnnotation):
         return False
 
 
+class ConditionalOnMissingClass(SpringAnnotation):
+    """``@ConditionalOnMissingClass``：类路径中不存在指定类时装配（对齐 Spring Boot）。"""
+
+    _annotation_type = _CONDITIONAL_TYPE
+
+    def __init__(self, name: str, value: Optional[Type] = None):
+        super().__init__(name=name, value=value)
+
+    def matches(self, ctx: Any) -> bool:
+        on_class = ConditionalOnClass(name=self.name, value=self.value)
+        return not on_class.matches(ctx)
+
+
+class ConditionalOnWebApplication(SpringAnnotation):
+    """``@ConditionalOnWebApplication``：Web应用环境下装配（对齐 Spring Boot）。"""
+
+    _annotation_type = _CONDITIONAL_TYPE
+
+    def __init__(self, type: str = "any"):
+        """type: 'servlet' | 'reactive' | 'any'。Python框架统一为reactive(FastAPI)。"""
+        super().__init__(type=type)
+
+    def matches(self, ctx: Any) -> bool:
+        # 判断是否为Web环境：检查是否有WebApplicationContext
+        from springbootai.web.web_context import WebApplicationContext
+        return isinstance(ctx, WebApplicationContext) or hasattr(ctx, 'fastapi_app')
+
+
+class ConditionalOnNotWebApplication(SpringAnnotation):
+    """``@ConditionalOnNotWebApplication``：非Web应用环境下装配。"""
+
+    _annotation_type = _CONDITIONAL_TYPE
+
+    def matches(self, ctx: Any) -> bool:
+        on_web = ConditionalOnWebApplication()
+        return not on_web.matches(ctx)
+
+
+class ConditionalOnExpression(SpringAnnotation):
+    """``@ConditionalOnExpression``：基于SpEL风格表达式的条件装配。
+
+    支持简单表达式：配置属性引用和基本布尔运算。
+    语法：
+        "${property:default}"  - 配置属性值
+        "true" / "false"       - 布尔字面量
+        "property == value"    - 等值比较
+        "!property"            - 逻辑非
+    """
+
+    _annotation_type = _CONDITIONAL_TYPE
+
+    def __init__(self, expression: str):
+        super().__init__(expression=expression)
+
+    def matches(self, ctx: Any) -> bool:
+        loader = getattr(ctx, "config_loader", None)
+        expr = self.expression.strip()
+
+        # 简单布尔字面量
+        if expr.lower() in ("true", "false"):
+            return expr.lower() == "true"
+
+        # 逻辑非
+        if expr.startswith("!"):
+            inner = ConditionalOnExpression(expr[1:])
+            return not inner.matches(ctx)
+
+        # 属性引用 ${...}
+        import re
+        prop_match = re.match(r'^\$\{([^:}]+)(?::(.+))?\}$', expr)
+        if prop_match:
+            key = prop_match.group(1)
+            default = prop_match.group(2)
+            try:
+                value = loader.get(key) if loader is not None else None
+            except Exception:
+                value = None
+            if value is None:
+                value = default
+            return value is not None and str(value).lower() not in ("false", "0", "no", "off", "")
+
+        # 等值比较 prop == value
+        eq_match = re.match(r'^(.+?)\s*==\s*(.+)$', expr)
+        if eq_match:
+            left = eq_match.group(1).strip()
+            right = eq_match.group(2).strip().strip("'\"")
+            if left.startswith("${") and left.endswith("}"):
+                key = left[2:-1].split(":")[0]
+                try:
+                    actual = loader.get(key) if loader is not None else None
+                except Exception:
+                    actual = None
+                return str(actual) == right
+            return left.strip("'\"") == right
+
+        # 简单属性名：存在且不为false即装配
+        if expr and " " not in expr:
+            try:
+                value = loader.get(expr) if loader is not None else None
+            except Exception:
+                value = None
+            return value is not None and str(value).lower() not in ("false", "0", "no", "off", "")
+
+        return False
+
+
 # 供 _matches_conditions 识别的全部条件注解类型
 CONDITION_ANNOTATIONS = (
     Conditional, ConditionalOnProperty, ConditionalOnBean,
     ConditionalOnMissingBean, ConditionalOnClass,
+    ConditionalOnMissingClass, ConditionalOnWebApplication,
+    ConditionalOnNotWebApplication, ConditionalOnExpression,
 )
 
 
@@ -267,6 +375,10 @@ __all__ = [
     "ConditionalOnBean",
     "ConditionalOnMissingBean",
     "ConditionalOnClass",
+    "ConditionalOnMissingClass",
+    "ConditionalOnWebApplication",
+    "ConditionalOnNotWebApplication",
+    "ConditionalOnExpression",
     "CONDITION_ANNOTATIONS",
     "all_conditions_match",
 ]

{springbootai-2.3.4 → springbootai-2.3.5}/springbootai/annotations/core.py

@@ -7,7 +7,7 @@ __all__ = [
     "SpringAnnotation", "get_spring_annotations", "ApplicationEvent", "EventListener",
     "SpringBootApplication", "ComponentScan", "RestController", "Controller",
     "RequestMapping", "GetMapping", "PostMapping", "PutMapping", "PatchMapping",
-    "DeleteMapping", "Service", "Component", "Aspect", "Pointcut", "Before",
+    "DeleteMapping", "Service", "Component", "Aspect", "Pointcut", "Order", "Before",
     "After", "Around", "AfterReturning", "AfterThrowing", "Repository", "Autowired",
     "Qualifier", "Configuration", "Scope", "Bean", "Value", "ConfigurationProperties",
     "RequestParam", "PathVariable", "RequestBody", "RequestPart", "FileUpload",
@@ -265,6 +265,29 @@ class Pointcut(SpringAnnotation):
         super().__init__(value=value.strip())
 
 
+class Order(SpringAnnotation):
+    """声明组件/通知的执行优先级（对齐 Spring ``@Order``）。
+
+    数值越小优先级越高：
+    - 切面通知：优先级高的 @Before 先执行、@After 后执行（对齐 Spring 语义）
+    - BeanPostProcessor / 拦截器：数值小的先执行
+
+    使用示例：
+        @Aspect
+        @Order(1)  # 比 @Order(2) 的通知先执行
+        class LoggingAspect:
+            ...
+    """
+
+    _annotation_type = "order"
+
+    def __init__(self, value: int = 0):
+        super().__init__(value=int(value))
+
+    def get_order(self) -> int:
+        return int(self.value)
+
+
 class _AdviceAnnotation:
     def _init_advice(self, value: str = "", *, pointcut: Optional[str] = None):
         expression = pointcut if pointcut is not None else value

{springbootai-2.3.4 → springbootai-2.3.5}/springbootai/aop/aspect.py

@@ -73,6 +73,19 @@ class _AdviceDefinition:
     annotation: Any
     expression: str
     pointcuts: Dict[str, str]
+    order: int = 0
+
+
+def _aspect_order(aspect_class: type) -> int:
+    """解析切面类上的 ``@Order`` 优先级（默认 0，数值越小优先级越高）。"""
+    for annotation in get_spring_annotations(aspect_class):
+        if type(annotation).__name__ == "Order":
+            value = getattr(annotation, "value", 0)
+            try:
+                return int(value)
+            except (TypeError, ValueError):
+                return 0
+    return 0
 
 
 def is_aspect_class(bean_class: type) -> bool:
@@ -118,6 +131,7 @@ def collect_advice_definitions(bean_factory: Any) -> List[_AdviceDefinition]:
                             annotation=annotation,
                             expression=annotation.value,
                             pointcuts=pointcuts,
+                            order=_aspect_order(aspect_class),
                         )
                     )
     return definitions
@@ -181,6 +195,48 @@ def _execution_pattern(expression: str) -> str:
     return parts[-1]
 
 
+def _annotation_name_matches(annotation: Any, expected: str) -> bool:
+    """判断注解的类名（短名或全限定名）是否匹配期望名。"""
+    return (
+        type(annotation).__name__ == expected
+        or f"{type(annotation).__module__}.{type(annotation).__name__}" == expected
+    )
+
+
+def _method_parameter_types(method: Callable) -> List[Any]:
+    """提取方法的参数类型注解（无注解的参数视为 ``object``）。"""
+    try:
+        signature = inspect.signature(method)
+    except (TypeError, ValueError):
+        return []
+    types_list: List[Any] = []
+    for parameter in signature.parameters.values():
+        if parameter.kind in (
+            inspect.Parameter.VAR_POSITIONAL,
+            inspect.Parameter.VAR_KEYWORD,
+        ):
+            continue
+        annotation = parameter.annotation
+        if annotation is inspect.Parameter.empty:
+            types_list.append(object)
+        else:
+            types_list.append(annotation)
+    return types_list
+
+
+def _type_matches(actual: Any, expected_name: str) -> bool:
+    """判断类型是否匹配期望类型名（短名或全限定名）。"""
+    if actual is None:
+        actual = object
+    try:
+        if actual.__name__ == expected_name:
+            return True
+        module = getattr(actual, "__module__", "")
+        return f"{module}.{actual.__name__}" == expected_name
+    except Exception:
+        return False
+
+
 def _matches_atom(
     expression: str,
     *,
@@ -227,10 +283,55 @@ def _matches_atom(
         if not expected:
             raise ValueError("@annotation pointcut must include an annotation name")
         return any(
-            type(annotation).__name__ == expected
-            or f"{type(annotation).__module__}.{type(annotation).__name__}" == expected
+            _annotation_name_matches(annotation, expected)
             for annotation in get_spring_annotations(method)
         )
+    if expression.startswith("@within(") and expression.endswith(")"):
+        expected = expression[len("@within("):-1].strip()
+        if not expected:
+            raise ValueError("@within pointcut must include an annotation name")
+        return any(
+            _annotation_name_matches(annotation, expected)
+            for annotation in get_spring_annotations(target_class)
+        )
+    if expression.startswith("@target(") and expression.endswith(")"):
+        expected = expression[len("@target("):-1].strip()
+        if not expected:
+            raise ValueError("@target pointcut must include an annotation name")
+        return any(
+            _annotation_name_matches(annotation, expected)
+            for annotation in get_spring_annotations(target_class)
+        )
+    if expression.startswith("args(") and expression.endswith(")"):
+        inner = expression[len("args("):-1].strip()
+        if not inner:
+            raise ValueError("args pointcut must include parameter types")
+        expected_types = [part.strip() for part in inner.split(",") if part.strip()]
+        actual_types = _method_parameter_types(method)
+        # 无类型约束时（空签名）不匹配任何 args 表达式
+        if not actual_types:
+            return False
+        # 参数数量必须一致（或用 .. 表示任意前缀，简化为前缀匹配）
+        if len(expected_types) != len(actual_types):
+            return False
+        return all(
+            _type_matches(actual, expected)
+            for actual, expected in zip(actual_types, expected_types)
+        )
+    if expression.startswith("@args(") and expression.endswith(")"):
+        expected = expression[len("@args("):-1].strip()
+        if not expected:
+            raise ValueError("@args pointcut must include an annotation name")
+        # 匹配方法参数上是否带有指定注解
+        try:
+            signature = inspect.signature(method)
+        except (TypeError, ValueError):
+            return False
+        for parameter in signature.parameters.values():
+            for annotation in get_spring_annotations(parameter.annotation) if isinstance(parameter.annotation, type) else []:
+                if _annotation_name_matches(annotation, expected):
+                    return True
+        return False
     raise ValueError(f"Unsupported pointcut expression: {expression}")
 
 
@@ -395,6 +496,14 @@ def apply_aspects(
         item for item in advice if type(item.annotation) is AfterThrowing
     ]
 
+    # @Order 优先级：before/around 按 order 升序（值小先执行）；
+    # after/after_returning/after_throwing 按 order 降序（值大先执行），形成"洋葱"结构。
+    before.sort(key=lambda item: item.order)
+    around.sort(key=lambda item: item.order)
+    after.sort(key=lambda item: item.order, reverse=True)
+    after_returning.sort(key=lambda item: item.order, reverse=True)
+    after_throwing.sort(key=lambda item: item.order, reverse=True)
+
     def business_args(call_args):
         if call_args and call_args[0] is target:
             return call_args[1:]