Solon 特性簡集,相較於 Springboot 有什麼區別?

Solon 是一個相似Springboot的微型開發框架,也是一個不基於Servlet的開發框架。項目從2018年啓動以來,參考過大量前人做品;歷時兩年,3500屢次的commit;內核保持0.1m的身材,超高的Web跑分,良好的使用體驗。java

Solon 強調:剋制 + 簡潔 + 開放的原則;力求:更小、更快、更自由的體驗。git

所謂更小:

內核0.1m,最小Web開發單位0.2m(相比Springboot項目包,小到能夠乎略不計了)。github

具用戶反映,某些項目切換到Solon後,能夠縮減到原來10%的包大小。web

所謂更快:

本機helloworld測試,啓動最快可達0.09s,Qps可達12萬之多。可參考:《helloworld_wrk_test》。spring

所謂更自由:

  • 代碼操控自由:
// 除了注入模式以外,還能夠按需手動
//
//手動獲取配置
String userName = Solon.cfg().get("user.name");
Properties dbcfg = Solon.cfg().getProp("db");
//手動獲取容器裏的Bean
UserService userService = Aop.get(UserService.class);
//手動監聽http post請求
Solon.global().post("/user/update", x-> userService.updateById(x.paramMap()));
  • 框架選擇自由:

能夠用solon-web這樣的快速開發集成包。也能夠按項目須要選擇不一樣的插件組裝,好比:爲非Solon項目添加solon.boot.jlhttp,0.2m便可讓項目實現http+rpc開發;還能夠用MVC開發Socket應用。api

特性簡集:

一、與Springboot的經常使用註解比較

Solon 1.2.12 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」) 非單例
@Init * @PostConstruct 構造完成並注入後的初始化
@Configuration @Configuration 配置類
@Bean @Bean 配置組件
@Mapping @RequestMapping,@GetMapping... 映射
@Param @RequestParam 請求參數
@Controller @Controller,@RestController 控制器類
@Service @Service 服務類
@Dao @Dao 數據訪問類
  • Solon 的 @Inject 算是: Spring 的@Value、@Autowired、@Qualifier 三者的結合,但又不徹底等價
  • Solon 託管的 Bean 初始化順序:new() - > @Inject - > @Init
  • 注1:@Inject 的參數注入,只在Method@Bean上有效
  • 注2:@Inject 的類型注入,只在@Configuration類上有效

二、重要的區別,Solon不是基於Servlet的開發框架

  • 與Springboot類似的體驗,但使用Context包裝請求上下文。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(Context c, @Param(defaultValue="noear") String name){
        return  appName + ": Hello " + name;  
    }
}

三、與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);
    }
}

四、與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";
    }
}

五、基於標籤管理的緩存支持@Cache,與Springboot略有不一樣

  • 基於標籤管理,避免沒必要要的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);
    }
}

六、具有語義特性的Bean定義,實現更多可能性

  • 經過語義特性,爲Bean增長特性描述;從而實現一些附加的能力
//
// 一個數據主從庫的示例
//
@Configuration
public class Config {
    //申明 db2 是 db1 爲的從庫
    @Bean(value = "db1", attrs = { "slaves=db2" })
    public DataSource db1(@Inject("${test.db1}") HikariDataSource dataSource) {
        return dataSource;
    }

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

七、支持數據渲染(或輸出格式化)的自我控制支持

  • 定製特定場景的控制器基類,負責統一格式化輸出
//示例:定製統一輸出控制基類,並統一開啓驗證
//
@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));
            }
        }
    }
}

八、不基於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,我把你過濾了");
    }
}

九、爲服務開發而生的SockeD組件,實現http,socket,websocket相同的信號處理。

  • 支持MVC+RPC開發模式
//[服務端]
@Mapping(value = "/demoe/rpc", method = MethodType.SOCKET)
@Component(remoting = true)
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開發模式(基於上例擴展)
//[服務端]
@Mapping(value = "/demoe/rpc", method = MethodType.SOCKET)
@Component(remoting = true)
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);
    }
}

十、專屬RPC客戶端組件:Nami

  • 相似於Springboot + Feign的關係,但Nami更簡潔(Solon 也能夠用Feign)
//[定義接口],通常狀況下不須要加任何註解
//
public interface UserService {
    UserModel getUser(Integer userId);
}

//[服務端] Component.remoting = true,即爲組件開啓遠程服務
//
@Mappin("user")
@Component(remoting = true)
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("local:/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";
    }
}

十一、Solon的增強版SPI擴展機制 - 以增長註解爲例

  • 1.新建個模塊,實現Plugin接口(以增長@Service註解支持爲例)
public class XPluginImp implements Plugin {
    @Override
    public void start(SolonApp app) {
        Aop.context().beanBuilderAdd(Service.class, (clz, bw, anno) -> {
            bw.proxySet(BeanProxyImp.global());

            Aop.context().beanRegister(bw, "", true);
        });
    }
}
  • 2.增長配置文件
src/main/resources/META-INF/solon/solon.extend.aspect.properties
  • 3.增長配置內容,打包發佈便可
solon.plugin=org.noear.solon.extend.aspect.XPluginImp

十二、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);

附:Solon項目地址

相關文章
相關標籤/搜索