Solon 框架详解（一）- 快速入门

曹涵润

2023-12-01

Solon详解系列文章：
Solon详解（一）- 快速入门
 Solon详解（二）- Solon的核心
 Solon详解（三）- Solon的web开发
 Solon详解（四）- Solon的事务传播机制
 Solon详解（五）- Solon扩展机制之Solon Plugin
Solon详解（六）- Solon的校验框架使用、定制与扩展
 Solon详解（七）- Solon Ioc 的注解对比Spring及JSR330
Solon详解（八）- Solon的缓存框架使用和定制
 Solon详解（九）- 渲染控制之定制统一的接口输出
 Solon详解（十）- 怎么用 Solon 开发基于 undertow jsp tld 的项目？

一、Solon

最近号称 Spring boot 轻量替代框架的 Solon。得空搞了一把，确实好用，小巧而快速。那Solon到底是什么，又是怎么好用呢？

什么是Solon?

Solon是参考 Spring boot 和 Javalin 而设计。吸取了两者的的优点，避开了很多繁重的设计，使其支持 http, websocket, socket 三种通讯信号接入。Solon 2m即可支撑起完整的mvc开发了，0.1秒就可以完成启动；相对于言，Spring boot 的一个普通mvc项目，基本上20M起步，启动要3秒以上，而且qps也弱了很多。

总体来说，Solon 有着类似于 Spring boot的开发体验；故而入坑成本极低，替代很方便。

项目源码：https://gitee.com/noear/solon

Solon能干些什么?

Web 开发（Mvc）
Job 定时任务开发
Remoting 开发（Socket 、Rpc…）
Cloud 分布式开发或微服务开发
等…

Solon的优缺点

优点

更小、更快、更自由
支持注解与手动两种模式，按需自由操控
自带IOC & AOP容器，支持PRC、REST API、MVC开发
集合 Handler + Context 和 Listener + Message 两种架构模式；强调插件式扩展；适应不同的应用场景
统一 Http、WebSocket、Socket 三种信号的开发体验
插件可扩展可切换：启动插件，扩展插件，序列化插件，数据插件，会话状态插件，视图插件(可共存) 等…
使用感觉与 Spring Boot 近似，迁移成本低

缺点

新框架的通病，文档相对较少
第三方项目的适配较少

二、快速入门

1、Solon的Java bean配置方式

使用Solon，可以零配置就让你的项目快速运行起来，完全使用代码和注解取代配置。使用java代码方式可以更好的理解你配置的Bean，下面就先来看看两个最基本的注释：

1）纯手动方式

Aop.wrapAndPut(UserDao.class);

//或
Aop.wrapAndPut(UserDao.class, new UserDao());

2）@Configuration + @Bean 方式

Solon 的java配置方式是通过@Configuration 和 @Bean这两个注释实现的（没有xml方案）：

@Configuration
public class SolonConfig {
    @Bean
    public UserDao getUserDao() {
        return new UserDao();
    }
}

3）@Component

该示例将通过java配置方式配置Component，实现Solon IOC功能。

下面是一个简单的模拟从数据库获取User数据的Dao类（使用了@Component注解，说明它将交给Solon容器管理）。

@Component 
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;
    }
}

然后是一个最最常见的Service，通过注入UserDao，使用UserDao的方法获取用户数据。

@Component
public class UserService {

    @Inject
    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) {
        //启动容器服务
        Solon.start(Test.class, args);
        
        //或通过Aop对象获取托管的Bean（或者注解方式）
        //
        UserService userService = Aop.get(UserService.class);
        userService.getUserList();
    }
}

像普通的java程序一样，直接运行Test类中的main方法即可在控制台看到用户数据输出了。

可以发现和以往的Spring boot 很像；又有点不一样，尤其是手写AOP模式。

2、第一个Web应用

通过上面的示例,我们已经知道了Solon的java配置方式是怎么回事了,那接下来便正式开始使用Solon来开发我们的第一个web应用了.

1）pom.xml配置

设置solon的parent

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

设置solon的parent配置不是必须的，但包含了大量默认的配置，可简化我们的开发。

导入solon的web支持

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

通过上面简单的2步配置,Solon就配置完毕了,是相当简洁的呢？

2）小示例

@Controller    //这标明是一个solon的控制器
public class HelloApp {
    public static void main(String[] args) {    //这是程序入口
        Solon.start(HelloApp.class, args);
    }

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

Solon 程序的重点是要：在main函数的入口处，通过 Solon.start(…) 启动Solon的容器服务，进而启动它的所有机能。

运行HelloApp中的main()方法，启动该web应用后，在地址栏输入"http://localhost:8080/hello"，就可以看到输出结果了。

Hello world!

三、疑问

到这里是不是已经大概感觉到了Solon的高效和简洁了？配置就是如此简单，功能就是如此强大，但通过上面一系列的讲解，是不是也会产生一些疑惑呢，比如：

Solon启动的过程，都干了啥？
WEB应用的默认端口就是8080，那这个端口要怎么修改呢？
我们自定义的配置要如何读出来？
页面重定向用什么接口？
等等…

淡定，后续文章将会对一些常见的问题展开说明。

附：Solon项目地址

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