Solon Development Skill
Provide expert guidance for building Java applications with the Solon framework. Solon is an independent, full-scenario Java enterprise application development framework — it is NOT compatible with Spring and has its own architecture, annotations, and ecosystem built from scratch.
Official website: https://solon.noear.org
GitHub: https://github.com/opensolon/solon
License: Apache 2.0
JDK support: Java 8 ~ 25, GraalVM Native Image
Current version: 3.10.x
Critical Rules
- Solon is NOT Spring. Never mix Spring annotations (
@Autowired, @SpringBootApplication, @RestController, @RequestMapping, @Service, @Repository, @Value, @ComponentScan, etc.) into Solon code. Solon has its own complete annotation set. - No Spring dependencies. Never include
spring-boot-starter-, spring-, or any Spring artifact in Solon projects. Solon uses org.noear group ID. - Configuration file is
app.yml (or app.properties), NOT application.yml. - Entry point is
Solon.start(App.class, args), NOT SpringApplication.run(). - All examples must target version 3.10.0 unless the user specifies otherwise.
- Parent POM is
solon-parent with groupId=org.noear. - 中文支持. When the user communicates in Chinese, all responses and code comments must be in Chinese.
Scene Navigation
> 根据用户场景，读取对应的 reference 文件获取详细信息。
基础与核心
| Scenario | Reference File | Grep Keywords |
|---|
| --- | --- | --- |
| 项目初始化 / Maven 配置 / 构建 / 部署 / AOT / Native Image | references/quick_start.md | pom.xml, Solon.start, solon-maven-plugin, solon-aot, native-image |
| 注解对照 / IoC 容器 / 配置系统 / 插件SPI / SnEL表达式 / Spring对比 | references/core_concepts.md | @Inject, @Configuration, app.yml, SnEL, SpiLoader, Spring |
| 依赖选择 (web/lib) / 模块列表 / 序列化 / 视图 / 数据访问 / ORM | references/modules_reference.md | solon-web, solon-lib, SqlUtils, MyBatis |
| 注解完整参考 / 配置文件属性参考 | references/api_annotations.md | @Mapping, @Bean, @Param, server.port |
Web 开发
| Scenario | Reference File | Grep Keywords |
|---|
| --- | --- | --- |
| REST API / MVC / WebSocket / EventBus / Filter / 拦截器 / 定时任务 | references/common_patterns.md | @Controller, @Component, Filter, WebSocket, EventBus, @Mapping, @Scheduled |
| SSE 服务端推送 / Reactive 响应式 / I18n 国际化 | references/web_advanced.md | SseEmitter, Flux, Mono, solon-web-sse, solon-web-rx, I18nUtil |
安全
| Scenario | Reference File | Grep Keywords |
|---|
| --- | --- | --- |
| 认证 / 鉴权 / CORS 跨域 / 角色权限 / 参数校验 / 配置加密 | references/security.md | AuthAdapter, AuthProcessor, @CrossOrigin, @AuthPermissions, @AuthRoles, solon-security |
数据与通信
| Scenario | Reference File | Grep Keywords |
|---|
| --- | --- | --- |
| RPC 调用 / Nami 声明式客户端 / Socket.D 双向通信 / 负载均衡 | references/remoting.md | @NamiClient, @Remoting, Socket.D, LoadBalance, ClientSession |
运维与可观测
| Scenario | Reference File | Grep Keywords |
|---|
| --- | --- | --- |
| 日志配置 / 自定义添加器 / 日志持久化 / Slf4j | references/logging.md | solon-logging, AppenderBase, PersistentAppenderBase, logback |
测试
| Scenario | Reference File | Grep Keywords |
|---|
| --- | --- | --- |
| 单元测试 / 集成测试 / HTTP 接口测试 / Mock | references/testing.md | @SolonTest, HttpTester, @Rollback, @Import, mockito |
云原生 / 微服务
| Scenario | Reference File | Grep Keywords |
|---|
| --- | --- | --- |
| 配置中心 / 注册发现 / 事件总线 / 分布式定时任务 / 文件存储 / 熔断 / 网关 / 链路追踪 / 分布式锁 | references/cloud_native.md | nacos, kafka, minio, xxl-job, CloudClient, @CloudJob, @CloudEvent, CloudGateway |
AI 开发
| Scenario | Reference File | Grep Keywords |
|---|
| --- | --- | --- |
| ChatModel / Tool Call / RAG / MCP / Agent / AI UI / Harness / ACP / A2A | references/ai_development.md | ChatModel, RAG, MCP, ReActAgent, AiSdkStreamWrapper, HarnessEngine, ACP, A2A |
流程编排
| Scenario | Reference File | Grep Keywords |
|---|
| --- | --- | --- |
| Flow 流程编排 (规则引擎 / 工作流 / 状态机 / 图编排) | references/flow_orchestration.md | FlowEngine, FlowContext, Graph, YAML, StateMachine |