Solon

Solon 开发之常用注解

</> markdown

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

目前常用注解有:

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

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 接口实现类上有效)