Solon 特性简集，相较于 Springboot 有什么区别？

Solon 是一个轻量级的Java基础开发框架。借签了很多前人的成果，吸收了很多新理念。内核仅0.1m大小，超高的Qps跑分，体验类似Springboot。Solon 强调：克制 + 简洁 + 开放的原则；力求：更小、更快、更自由的体验。

所谓更小：

内核0.1m，最小Web开发单位0.2m（相比Springboot项目包，小到可以乎略不计了）。

具用户反映，某些项目切换到Solon后，可以缩减到原来10%的包大小。

所谓更快：

本机helloworld测试，启动最快可达0.1s，Qps可达12万之多。可参考：《helloworld_wrk_test》。

所谓更自由：

• 代码操控自由：

// 除了注解模式之外，还可以按需手动
//
//手动获取配置（Props 为 Properties 增强版）
Props db = Solon.cfg().getProp("db");

//手动获取容器里的Bean
UserService userService = Aop.get(UserService.class);

//手动监听http post请求
Solon.global().post("/user/update", x-> userService.updateById(x.paramMap()));

//手动添加个RPC服务
Solon.global().add("/rpc/", HelloService.class, true);

//手动获取一个RPC服务消费端
HelloService helloService = Nami.builder().create(HelloService.class);

//手动为容器添加组件
Aop.wrapAndPut(DemoService.class);

• 框架选择自由：

可以用 solon-web 这样的快速开发集成包。也可以按项目需要选择不同的插件组装，比如：为非 Solon 项目添加 solon.boot.jlhttp，0.2m即可让项目实现 http+rpc 开发；还可以用 MVC 开发 Socket 应用。

特性简集：

1、与 Springboot 的常用注解比较

Solon 1.10.1	Springboot 2.3.3	说明
@Inject *	@Autowired	注入Bean（by type）
@Inject("name")	@Qualifier+@Autowired	注入Bean（by name）
@Inject("${name}")	@Value("${name}")	注入配置
@Component	@Component	托管组件
@Singleton	@Scope(“singleton”)	单例（Solon 默认是单例）
@Singleton(false)	@Scope(“prototype”)	非单例
@Import	@Import + @ComponentScan	导入或扫描组件
@Init *	@PostConstruct	构造完成并注入后的初始化
@Configuration	@Configuration	配置类
@Bean	@Bean	配置Bean
@Mapping ...	@RequestMapping,@GetMapping...	映射
@Param	@RequestParam	请求参数
@Body	@RequestBody	请求体
@Controller	@Controller,@RestController	控制器类
@Service	@Service	服务类
@Dao	@Dao	数据访问类

• Solon 的 @Inject 算是： Spring 的@Value、@Autowired、@Qualifier 三者的结合，但又不完全等价
• Solon 的 @Import 同时有导入和扫描的功能
• Solon 托管的 Bean 初始化顺序：new() - > @Inject - > @Init
• 注1：Method@Bean，只执行一次（只在 @Configuration 里有效）
• 注2：@Inject 的参数注入，只在 Method@Bean 上有效
• 注3：@Inject 的类注入，只在 @Configuration类 上有效
• 注4：@Import 只在 主类上 或者 @Configuration类 上有效

2、重要的区别，Solon 不是基于 Servlet 的开发框架

• 与 Springboot 相似的体验，但使用 Context 包装请求上下文（底层为：Context + Handler 架构）。Helloworld 效果如下：

@Controller
public class App{
    public static void main(String[] args){
        Solon.start(App.class, args);
    }
    
    @Inject("${app.name}")
    String appName;
  
    @Mapping("/")
    public Object home(String name){
        return  appName + ": Hello " + name;  
    }
}

• Solon 适配有：jlhttp、smarthttp、jetty、undertow、netty、websocket 等各种通讯容器。

3、Solon 不支持构造函数注入与属性设置注入

• 不支持的：

@Component
public class Demo{
    private A a;
    private B b;
    
    public Demo(@Inject A a){
        this.a = a;
    } 
    
    public void setB(@Inject B b){
        this.b = b;
    }
}

• 支持的：

@Component
public class Demo{
    @Inject
    private A a;
    
    @Inject
    private B b;
    
    //@Init
    //public void initDo(){
    //    //Solon 的注入是异步的。想要对注入的 bean 进行实始化，需要借用 @Init 函数
    //}
}

4、Solon 可以更自由获取配置

@Component
public class Demo{
    //注入配置
    @Inject("${user.name}")
    private String userName;
    
    //手动获取配置
    private String userName = Solon.cfg().get("user.name");
}

5、Solon 的 @Component 与 @Service 是有区别的

• @Component 注解的组件，不会被动态代理。由内核提供的注解
  • 不支持拦截处理
  • 支持 Graalvm Native 打包
  • 支持函数被注解提取
  • 支持形态提取
• @Service 注解的组件，会被动态代理。由 solon.aspect 提供的注解
  • 支持拦截处理
  • 但，不支持 Graalvm Native 打包

6、与 Springboot 相似的事务支持 @Tran

• 采用 Springboot 相同的事件传播机制及隔离级别。但回滚时，不需要指定异常类型

@Controller
public class DemoController{
    @Db
    BaseMapper<UserModel> userService;
    
    @Tran
    @Mapping("/user/update")
    public void udpUser(long user_id, UserModel user){
        userService.updateById(user);
    }
}

7、与 Springboot 不同的较验方案 @Valid

• Solon 的方案更侧重较验参数（及批量较验），且强调可见性（即与处理函数在一起）。同时也支持实体的较验

@Valid  
@Controller
public class DemoController {

    @NoRepeatSubmit
    @NotNull({"name", "icon", "mobile"})
    @Mapping("/valid")
    public String test(String name, String icon, @Pattern("13\\d{9}") String mobile) {
        return "OK";
    }

    @Whitelist
    @Mapping("/valid/test2")
    public String test2() {
        return "OK";
    }
    
    @Mapping("/valid/test3")
    public String test3(@Validated UserModel user) {
        return "OK";
    }
}

8、基于标签管理的缓存支持 @Cache，与 Springboot 略有不同

• 支持Key的缓存管理。同时增加了基于标签的缓存管理，避免不必要的Key冲突

@Controller
public class DemoController{
    @Db
    BaseMapper<UserModel> userService;
    
    @CacheRemove(tags = "user_${user_id}")
    @Mapping("/user/update")
    public void udpUser(int user_id, UserModel user){
        userService.updateById(user);
    }
    
    @Cache(tags = "user_${user_id}")
    public UserModel getUser(int user_id){
        return userService.selectById(user_id);
    }
}

9、相似的 @Bean 设计

• 相似的特性。且，需与 @Configuration 协同使用

//
// 一个数据主从库的示例
//
@Configuration
public class Config {
    @Bean(name = "db1", typed = true)
    public DataSource db1(@Inject("${test.db1}") HikariDataSource dataSource) {
        return dataSource;
    }

    @Bean("db2")
    public DataSource db2(@Inject("${test.db2}") HikariDataSource dataSource) {
        return dataSource;
    }
}

• 使用 @Bean(typed=true) 做为某种类型的默认Bean

10、支持数据渲染（或输出格式化）的自我控制支持

• 定制特定场景的控制器基类，负责统一格式化输出

//示例：定制统一输出控制基类，并统一开启验证
//
@Valid
public class ControllerBase implements Render {
    @Override
    public void render(Object obj, Context ctx) throws Throwable {
        if (obj == null) {
            return;
        }

        if (obj instanceof String) {
            ctx.output((String) obj);
        } else {
            if (obj instanceof ONode) {
                ctx.outputAsJson(((ONode) obj).toJson());
            } else {
                if (obj instanceof UapiCode) {
                    //此处是重点，把一些特别的类型进行标准化转换
                    //
                    UapiCode err = (UapiCode) obj;
                    obj = Result.failure(err.getCode(), UapiCodes.getDescription(err));
                }

                if (obj instanceof Throwable) {
                    //此处是重点，把异常进行标准化转换
                    //
                    Throwable err = (Throwable) obj;
                    obj = Result.failure(err.getMessage());
                }

                ctx.outputAsJson(ONode.stringify(obj));
            }
        }
    }
}

11、不基于 Servlet，却很有 Servlet 亲和度。当使用 servlet 相关的组件时（也支持jsp + tld）

• 支持 ServletContainerInitializer 配置

@Configuration
public class DemoConfiguration implements ServletContainerInitializer{
    @Override
    public void onStartup(Set<Class<?>> set, ServletContext servletContext) throws ServletException {
        //...
    }
}

• 支持 Servlet api 注解

@WebFilter("/demo/*")
public class DemoFilter implements Filter {
    @Override
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain filterChain) throws IOException, ServletException {
        res.getWriter().write("Hello，我把你过滤了");
    }
}

12、为服务开发而生的 SockeD 组件，实现 http, socket, websocket 相同的信号处理。

• 支持 MVC+RPC 开发模式

//[服务端]
@Socket
@Mapping("/demoe/rpc")
@Remoting
public class HelloRpcServiceImpl implements HelloRpcService {
    public String hello(String name) {
        return "name=" + name;
    }
}

//[客户端] 
var rpc = SocketD.create("tcp://localhost:28080", HelloRpcService.class);
System.out.println("RPC result: " + rpc.hello("noear"));

• 支持单链接双向 RPC 开发模式（基于上例扩展）

//[服务端]
@Socket
@Mapping("/demoe/rpc")
@Remoting
public class HelloRpcServiceImpl implements HelloRpcService {
    public String hello(String name) {
        //
        //[服务端] 调用 [客户端] 的 rpc，从而形成单链接双向RPC
        //
        NameRpcService rpc = SocketD.create(Context.current(), NameRpcService.class);
        name = rpc.name(name);
        
        
        return "name=" + name;
    }
}

• 支持消息发送+监听开发模式

//[服务端]
@ServerEndpoint
public class ServerListener implements Listener {
    @Override
    public void onMessage(Session session, Message message) {
        if(message.flag() == MessageFlag.heartbeat){
            System.out.println("服务端：我收到心跳");
        }else {
            System.out.println("服务端：我收到：" + message);
            //session.send(Message.wrapResponse(message, "我收到了"));
        }
    }
}

//[客户端]
var session = SocketD.createSession("tcp://localhost:28080");
session.send("noear");
//session.sendAndCallback("noear", (rst)->{});   //发送并异步回调
//var rst = session.sendAndResponse("noear");   //发送并等待响应

System.out.println(rst);

• 支持消息订阅开发模式

//[客户端]
@ClientEndpoint(uri = "tcp://localhost:28080")
public class ClientListener implements Listener {
    @Override
    public void onMessage(Session session, Message message) {
        //之后，就等着收消息
        System.out.println("客户端2：我收到了：" + message);
    }
}

13、专属 RPC 客户端组件：Nami

• 类似于 Springboot + Feign 的关系，但 Nami 更简洁且支持 socket 通道（ Solon 也可以用 Feign ）

//[定义接口]，一般情况下不需要加任何注解
//
public interface UserService {
    UserModel getUser(Integer userId);
}

//[服务端] @Remoting，即为远程组件
//
@Mappin("user")
@Remoting
public class UserServiceImpl implements UserService{
    public UserModel getUser(Integer userId){
        return ...;
    }
}


//[消费端]
//
@Mapping("demo")
@Controller
public class DemoController {

    //直接指定服务端地址
    @NamiClient("http://localhost:8080/user/")
    UserService userService;

    //使用负载
    @NamiClient(name="local", path="/user/")
    UserService userService2;

    @Mapping("test")
    public void test() {
        UserModel user = userService.getUser(12);
        System.out.println(user);

        user = userService2.getUser(23);
        System.out.println(user);
    }
}

/**
 * 定义一个负载器（可以对接发现服务）
 * */
@Component("local")
public class RpcUpstream implements LoadBalance {
    @Override
    public String getServer() {
        return "http://localhost:8080";
    }
}

14、Solon 的加强版SPI扩展机制 - 以增加注解为例

• 新建模块，并实现Plugin接口（以增加 @Service 注解支持为例）

public class XPluginImp implements Plugin {
    @Override
    public void start(AopContext context) {
        //添加 @Servcie bean builder
        context.beanBuilderAdd(Service.class, (clz, bw, anno) -> {
            BeanProxy.binding(bw);
        });
    }
}

• 增加配置文件

src/main/resources/META-INF/solon/solon.aspect.properties

• 增加配置内容，打包发布即可

solon.plugin=org.noear.solon.aspect.XPluginImp

15、Solon内部的事件总线EventBus的妙用

• 通过事件总线收集异常

//[收集异常]（不建议业务使用）
EventBus.push(err);

//[订阅异常]
EventBus.subscribe(Throwable.class,(event)->{
            event.printStackTrace();
        });
        
//或通过SolonApp订阅
app.onEvent(Throwable.class, (err)->{
            err.printStackTrace();
        });
        
//或通过组件订阅        
@Component
public class ErrorListener implements EventListener<Throwable> {
    @Override
    public void onEvent(Throwable err) {
        err.printStackTrace();
    }
}        
        

• 通过事件总线扩展配置对象

//
// 插件开发时，较常见
//
SqlManagerBuilder builder = new SqlManagerBuilder(ds);
EventBus.push(builder);

16、Aop 扩展，扫描一次 + 注册处理（也是启动快的原因之一）

• 注册‘构建器’处理。以注册 @Controller 构建器为例：

Solon.context().beanBuilderAdd(Controller.class, (clz, bw, anno) -> {
    //内部实现，可参考项目源码 //构建器，可以获取类型并进行加工
    new HandlerLoader(bw).load(Solon.global());
});

//效果
@Controller
public class DemoController{
}

• 注册'注入器'处理。以注册 @Inject 注入器为例：

Solon.context().beanInjectorAdd(Inject.class, ((fwT, anno) -> {
    //内部实现，可参考项目源码 //注入器，可以根据目标生成需要的数据并赋值
    beanInject(fwT, anno.value(), anno.autoRefreshed());
}));

//效果
@Controller
public class DemoController{
    @Inject
    UserService userService;
}

• 注册'拦截器'处理。以注册 @Tran 拦截器为例：

//拦截器，可以获取执行动作链
Solon.context().beanAroundAdd(Tran.class, new TranInterceptor(), 120);

//效果
@Service
public class UserService{
    @Tran
    public void addUser(User user){
    }
}

• 注册'提取器'处理。以注册 @CloudJob 提取器为例：

//内部实现，可参考项目源码 //提取器，可以提取被注解的函数
Solon.context().beanExtractorAdd(CloudJob.class, CloudJobExtractor.instance);

//效果 //提取器只对组件有效
@Component
public class Job{
    @CloudJob
    public void statUserJob(){
    }
}

附：Solon项目地址

• gitee: https://gitee.com/noear/solon
• github: https://github.com/noear/solon