Solon詳解(一)- 快速入門

Solon詳解系列文章:
Solon詳解(一)- 快速入門
Solon詳解(二)- Solon的核心
Solon詳解(三)- Solon的web開發

一、Solon

最近號稱小而美的的Solon框架,終於得空,搞了一把,發覺Solon確實好用,那Solon到底是什麼,又是怎麼好用呢?

什麼是Solon?

Solon參考過Spring boot 和 Javalin 的設計。吸取了兩者的的優點,避開了很多繁重的設計,使其支持http, websocket, socket 三種通訊信號接入。Solon 2M即可支撐起普通的mvc開發了,0.1秒就可以完成啟動;相對於言,Spring boot 的一個普通mvc項目,基本上20M起步,5秒左右完成啟動。

總體來說,Solon 有着類似於 Spring boot的開發體驗。

Solon的優缺點

優點

  1. 小巧美麗
  2. 快速構建項目
  3. 項目可獨立運行,不需要外部的web容器(jar直接部署)
  4. 部署效率高

缺點

  1. 文檔很少
  2. 第三方項目的適配少(與Spring生態沒法比)

二、快速入門

1、Solon的Java配置方式

使用Solon,可以零配置就讓你的項目快速運行起來,完全使用代碼和註解取代配置。使用java代碼方式可以更好的理解你配置的Bean,下面就先來看看兩個最基本的注釋:

1)@XConfiguration 和 @XBean

Solon的java配置方式是通過@XConfiguration 和 @XBean這兩個注釋實現的:

  • @XConfiguration 作用於類上,對Bean進行配置
  • @XBean 用在類上,也可以作用在 @XConfiguration 類的方法上
2)示例

該示例將通過java配置方式配置Bean,實現Solon IOC功能。

下面是一個簡單的模擬從數據庫獲取User數據的Dao類(使用了@XBean註解,說明它將交給Solon容器管理)。

@XBean 
public class UserDao {
    public List<String> queryUserList() {
        //為省事兒,此處不操作數據庫
        List<String> list = new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            list.add("User " + i);
        }
        return list;
    }
}

//也可以通過配置器構建Bean
//
//@XConfiguration
//public class SolonConfig {
//    @XBean
//    public UserDao getUserDao() {
//        return new UserDao();
//    }
//}

然後是一個最最常見的Service,通過注入UserDao,使用UserDao的方法獲取用戶數據。

@XBean
public class UserService {

    @XInject
    UserDao userDao;

    public void getUserList() {
        List<String> list = userDao.queryUserList();
        for (int i = 0; i < list.size(); i++) {
            System.out.println(list.get(i));
        }
    }

}

接下來就是啟動Solon的容器服務, 然後從容器中拿到UserService,並調用其獲取用戶數據的方法,代碼如下:

public class Test {
    public static void main(String[] args) {
        //啟動容器服務
        XApp.start(Test.class, args);
        
        //通過Aop對象獲取Bean(或者註解方式)//可以用代碼的方式獲取託管bean
        //
        UserService userService = Aop.get(UserService.class);
        userService.getUserList();
    }
}

像普通的java程序一樣,直接運行Test類中的main方法即可在控制台看到用戶數據輸出了。

應該可以發現了,以往的Spring boot 很像,又很不一樣。

2、第一個Web應用

通過上面的示例,我們已經知道了Solon的java配置方式是怎麼回事了,那接下來便正式開始使用Solon來開發我們的第一個web應用了.

1)pom.xml配置

設置solon的parent

<parent>
    <groupId>org.noear</groupId>
    <artifactId>solon-parent</artifactId>
    <version>1.0.13</version>
</parent>

設置solon的parent配置不是必須的,但包含了大量默認的配置,可簡化我們的開發。

導入solon的web支持

<dependency>
    <groupId>org.noear</groupId>
    <artifactId>solon-web</artifactId>
    <type>pom</type>
</dependency>

通過上面簡單的2步配置,Solon就配置完畢了,是相當簡潔的呢?

2)小示例
@XController    //這標明是一個solon的控制器
public class HelloApp {
    public static void main(String[] args) {    //這是程序入口
        XApp.start(HelloApp.class, args);
    }

    @XMapping("/hello")
    public String hello(String name){
        return "Hello world!";
    }
}

Solon 程序的重點是要:在main函數的入口處,通過XApp.start(…) 啟動Solon的容器服務,進而啟動它的所有機能。

運行HelloApp中的main()方法,啟動該web應用後,在地址欄輸入”//localhost:8080/hello“,就可以看到輸出結果了。

Hello world!

三、疑問

到這裡是不是已經大概感覺到了Solon的高效和簡潔了?配置就是如此簡單,功能就是如此強大,但通過上面一系列的講解,是不是也會產生一些疑惑呢,比如:

  1. Solon啟動的過程,都幹了啥?
  2. WEB應用的默認端口就是8080,那這個端口要怎麼修改呢?
  3. 我們定義的配置要如何讀出來?

淡定,後續文章將會對一些常見的問題展開說明。