Solon

Solon 开发之常用注解

</> json </> markdown

本系列提供Solon 注解方面的知识。且对关键注解会有详细说明。

目前常用注解有：

注解说明
@Inject *注入托管对象（by type）
@Inject("name")注入托管对象（by name）
@Inject("${name}")注入配置（可由基础类型或结构体接收）
@Singleton单例申明（Solon 默认是单例）
@Singleton(false)非单例
@Import配置组件导入或扫描（作用在启动主类上或 @Configuration 类上，才有效）
@PropertySource配置属性源（作用在启动主类上或 @Configuration 类上，才有效）
@Configuration托管配置组件类（与 @Inject, @Bean 共同完成初始化配置、构建托管对象等）
@Bean配置托管对象（作用在 @Configuration 类的函数上，才有效）
@Condition配置条件（v2.1.0 支持）
@Component托管组件（支持自动代理，v2.5.2 开始支持自动代理）
@SolonMainSolon 主类标识（即 main 函数所在类）
@TestPropertySource配置测试属性源
@TestRollback执行测试回滚

托管组件的初始化顺序：new() - > @Inject -> afterInjection()- > start() -> stop()

MVC / RPC 常用注解：

注解说明
@Controller控制器组件类（支持函数拦截）
@Remoting远程控制器类（有类代理；即RPC服务端）
@Mapping...映射（可附加 @Get、@Post、@Socket、@Produces、@Consumes 等限定注解）
@Param请求参数（一般没什么用处，需要默认值或名字不同时用）
@Header请求Header
@Cookie请求Cookie
@Path请求 path 变量（因为框架会自动处理，所以这个只是标识下方便文档生成用）
@Body请求体（一般会自动处理。仅在主体的 String, InputSteam, Map 时才需要）

WebSocket / SocketD 常用注解：

注解说明
@ServerEndpointWebSocket 与 Socket 的服务端注解（作用在 Listener 接口实现类上有效）
@ClientEndpointWebSocket 与 Socket 的客户端端注解（作用在 Listener 接口实现类上有效）