Metadata

name: solon-development-skill
description: Specialized knowledge for developing Java applications with the Solon framework. Covers core concepts, web, data, security, remoting, AI, flow orchestration, cloud-native, testing, and more. Solon is an independent Java enterprise framework (NOT based on Spring) with its own annotation system, IoC/AOP container, and plugin ecosystem.

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`

solon-development-skill

安装技能