@

目录

• 概述
  • 定义
  • 性能
  • 架构
• 实战
  • Solon Web示例
  • Solon Mybatis-Plus示例
  • Solon WebSocket示例
  • Solon Remoting RPC示例
  • Solon Cloud Nacos示例

概述

Solon 官网地址 https://solon.noear.org/

Solon GitHub源码地址 https://github.com/noear/solon

Solon for java，一个更现代感的，轻量级应用开发框架，崇尚克制、简洁、开放、生态设计理念。最新版本为1.10.7

Solon从项目启动以来，参考过大量前人的作品。尤其是 Spring Boot、jFinal、Javalin 和 Asp.Net，吸取了诸多优点，且避开很多繁重的设计。历时多年，内核始终保持 0.1Mb 的身材，超高的跑分，良好而自由的使用体验。

目前支持jdk8、jdk11、jdk17、jdk19四个大版本，开发定制方便，可通过组合不同的插件快速开发不同的需求，开发人员几乎可使用与SpringBoot相似的开发方式。其Solon Cloud 为一系列分布式开发的接口标准和配置规范，相当于DDD模式里的防腐层概念，是 Solon 的微服务架构模式开发解决方案。在开发使用上官方也提供其与SpringBoot、SpringCloud、Dubbo的详细区别，使用时查阅官方文档即可。

Solon 根据官方提供数据，比传统的Java应用特别是Spring生态开发的应用启动快 5 ～ 10 倍，qps 高 2～ 3 倍，运行时内存节省 1/3 ~ 1/2，打包可以缩到 1/2 ~ 1/10。因此成为更现代感的应用开发框架，实现更快、更小、更少、更自由！

• 快：Qps 可达10万之多
• 小：内核 0.1Mb，最小 Web 完整开发单位 1Mb（相比Springboot项目包，小到可以乎略不计了）
• 自由：代码操控自由，除了注解模式之外，还可以按需手动；框架选择自由：可以用 solon-web 这样的快速开发集成包。也可以按项目需要选择不同的插件组装，比如：为非Solon项目添加solon.boot.jlhttp，0.2Mb 即可让项目实现 http+mvc 支持。

• 缘起统一的处理架构想法（俗称：三源合一）：Http、Socket、WebSocket。不同的通讯信号，进行统一架构处理，且小巧。 对于 Socket 和 WebSocket，在原 消息+监听 的模式之外增加了 上下文+处理 模式

• 关于应用内在的启动过程（即：应用的生命周期）：串行的处理过程（含四个事件扩展点 + 两个函数扩展点）

• 请求的处理过程

• Ioc & Aop 内部结构

• 现有家簇成员图谱

实战

下载官方的helloworld示例 体验下Solon 轻量和快。此外还可以下载官网提供丰富的配套示例：

项目

地址

说明

solon-examples

https://gitee.com/noear/solon-examples

配套"学习/科目学习"进行演示

下载完解压后导入Idea中，是个标准的maven项目，pom文件引入solon的父依赖和核心依赖

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

一个配置文件app.yml,一个启动类DemoApp,是不是和SpringBoot很相似，Solon 是一个容器型的应用开发框，在main方法中使用Solon.start启动。app.yml内容如下:

server.port: 8080
solon.app:
  name: demoapp
  group: demo

这里简单修改hello方法的返回结果如下，可以直接运行，也可以先通过mvn clean package -DskipTests打包后再使用java -jar demo.jar运行。

几小行代码一个http接口就完成，启动速度非常快只用3ms，访问http://localhost:8080/hello?name=itxiaoshen 返回正确的结果

环境准备：创建MySQL数据库test、表appx，并插入测试数据

CREATE TABLE `appx` (
  `app_id` INT NOT NULL AUTO_INCREMENT COMMENT '应用ID',
  `app_key` VARCHAR(40) DEFAULT NULL COMMENT '应用访问KEY',
  `akey` VARCHAR(40) DEFAULT NULL COMMENT '（用于取代app id 形成的唯一key） //一般用于推广注册之类',
  `ugroup_id` INT DEFAULT '0' COMMENT '加入的用户组ID',
  `agroup_id` INT DEFAULT NULL COMMENT '加入的应用组ID',
  `name` VARCHAR(50) DEFAULT NULL COMMENT '应用名称',
  `note` VARCHAR(50) DEFAULT NULL COMMENT '应用备注',
  `ar_is_setting` INT NOT NULL DEFAULT '0' COMMENT '是否开放设置',
  `ar_is_examine` INT NOT NULL DEFAULT '0' COMMENT '是否审核中(0: 没审核 ；1：审核中)',
  `ar_examine_ver` INT NOT NULL DEFAULT '0' COMMENT '审核 中的版本号',
  `log_fulltime` DATETIME DEFAULT NULL,
  PRIMARY KEY (`app_id`),
  UNIQUE KEY `IX_akey` (`akey`) USING BTREE
) ENGINE=INNODB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='应用表';

INSERT appx(app_key,akey,ugroup_id,agroup_id,NAME,note,ar_is_setting,ar_is_examine,ar_examine_ver,log_fulltime)
VALUES('asdfghjk','aaaaabbbbb',100,1001,'抖音','时尚短视频',0,1,1,NOW());
INSERT appx(app_key,akey,ugroup_id,agroup_id,NAME,note,ar_is_setting,ar_is_examine,ar_examine_ver,log_fulltime)
VALUES('sdfsdf','ccccdddd',102,1002,'招行','储蓄',0,1,1,NOW());
INSERT appx(app_key,akey,ugroup_id,agroup_id,NAME,note,ar_is_setting,ar_is_examine,ar_examine_ver,log_fulltime)
VALUES('34543','eeeegggg',103,1003,'有道词典','翻译',0,1,1,NOW());

添加mybatis-plus和mysql相关依赖如下：

        <dependency>
            <groupId>org.noear</groupId>
            <artifactId>mybatis-plus-extension-solon-plugin</artifactId>
        </dependency>

        <dependency>
            <groupId>com.zaxxer</groupId>
            <artifactId>HikariCP</artifactId>
            <version>4.0.3</version>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.18</version>
        </dependency>

app.yml文件增加数据源和mybatis-plus的配置

test.db1:
    schema: rock
    jdbcUrl: jdbc:mysql://192.168.40.100:3308/test?useUnicode=true&characterEncoding=utf8&autoReconnect=true&rewriteBatchedStatements=true
    driverClassName: com.mysql.cj.jdbc.Driver
    username: root
    password: 123456

##默认
mybatis.db1:
    typeAliases:    #支持包名 或 类名（.class 结尾）
        - "demo4031.model"
    mappers:        #支持包名 或 类名（.class 结尾）或 xml（.xml结尾 或 *.xml 结尾）
        - "demo4031.dso.mapper"
#        - "demo4031/dso/*.xml"
    configuration:
        cacheEnabled: false
        mapUnderscoreToCamelCase: true
        logImpl: org.apache.ibatis.logging.nologging.NoLoggingImpl
    globalConfig:
        banner: false
        metaObjectHandler: "demo4031.dso.MetaObjectHandlerImpl"
        dbConfig:
            logicDeleteField: "deleted"
            logicDeleteValue: "2"

mapper接口和mapper.xml文件与Spring整合Mybatis基本相同

@Mapper
public interface AppxMapper {
    AppxModel appx_get();
    Page<AppxModel> appx_get_page(Page<AppxModel> page);
    AppxModel appx_get2(int app_id);
    void appx_add();
    Integer appx_add2(int v1);

    @Select("SELECT * FROM INFORMATION_SCHEMA.TABLES")
    List<DbTable> listTables();
}

再添加业务的Service和实现类，最后添加PlusController控制器实现

@Mapping("/plus/")
@Controller
public class PlusController {
    @Inject
    AppServicePlus appServicePlus;

    @Mapping("test")
    public AppxModel test() {
        return appServicePlus.getById(2);
    }
}

添加mybatis-plus分页的PageController控制器实现

@Mapping("/page/")
@Controller
public class PageController {
    @Db
    AppxMapper appxMapper;

    @Mapping("test")
    public Object test() throws Throwable {
        Page<AppxModel> page = new Page<>(2, 2);
        return appxMapper.appx_get_page(page);
    }
}

启动程序后日志输出如下

访问http://localhost:8080/plus/test，返回正确的结果

访问http://localhost:8080/page/test ，返回正确的分页结果

引入依赖

        <dependency>
            <groupId>org.noear</groupId>
            <artifactId>nami</artifactId>
        </dependency>
        <dependency>
            <groupId>org.noear</groupId>
            <artifactId>solon.socketd.client.websocket</artifactId>
        </dependency>

简单几行代码就实现WebSocket的服务端编程

@ServerEndpoint(value = "/ws/demo/{id}")
public class WebSocket implements Listener {
    @Override
    public void onOpen(Session session) {
        //path var
        String id = session.param("id");
        //query var
        String token = session.param("token");
        /*此处可以做签权；会话的二次组织等...*/
    }

    @Override
    public void onMessage(Session session, Message message) throws IOException {
        //message.setHandled(true); //设为true，则不进入mvc路由
        session.send("你发了：" + message.bodyAsString());
    }
}

然后通过一个debug.htm通过javascript实现WebSocket收发功能，App启动类开启enableWebSocket

public class App {
    public static void main(String[] args) {
        //
        // 启动Solon，并开启WebSocket监听；同时添加/路径跳转
        //
        Solon.start(App.class, args, app -> app.enableWebSocket(true)).get("/", c -> {
            c.redirect("/debug.htm");
        });
    }
}

启动App后日志输出如下

访问http://localhost:8080/ 输入发送信息后服务端打印收到的输入信息

RPC的实现分为3个模块，RPC提供者的实现、公共模块、服务消费者，公共模块存放数据模型和接口，可以同时提供给提供者和消费者引用。

服务提供者添加solon-rpc依赖

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

服务提供者通过@Remoting注解实现RPC服务，代码如下

@Mapping("/user/")
@Remoting
public class UserServiceImpl implements UserService {
    @Override
    public UserModel getUser(Integer userId) {
        UserModel model = new UserModel();
        model.setId(userId);
        model.setName("user-" + userId);
        return model;
    }
}

服务消费者添加如下依赖

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

        <dependency>
            <groupId>org.noear</groupId>
            <artifactId>solon.cloud</artifactId>
        </dependency>

app.yml配置文件配置服务发现的地址，也即是服务提供者提供的地址

server.port: 8080

solon.app:
  name: demoapp
  group: demo

solon.cloud.local:
  discovery:
    service:
      local:
        - "http://localhost:8081"

通过@NamiClient注解实现RPC远程方法的调用

@Controller
public class UserController {
    //使用负载
    @NamiClient(name = "local",path = "/user/")
    UserService userService;

    @Mapping("test")
    public UserModel test() {
        UserModel user = userService.getUser(100);
        System.out.println(user);
        return user;
    }
}

启动服务提供者和服务消费者

访问服务消费者测试Controller的测试接口，http://localhost:8080/test ，返回正确结果

引入依赖

        <dependency>
            <groupId>org.noear</groupId>
            <artifactId>nacos-solon-cloud-plugin</artifactId>
        </dependency>

先准备好Nacos Server,这里就直接使用前面文章已部署好的Nacos，创建好nacos的test命名空间，为了演示读取nacos的配置，在test下创建一个组为demo的test.properties，并添加db1.url的键值对。

然后在服务注册端的本地app.yml配置文件添加相关nacos的配置信息

server.port: 7112
solon.app:
  namespace: test
  group: demo
  name: helloapi    #发现服务使用的应用名（在Demo，将被NimaClient引用）
solon.cloud.nacos:
  server: 192.168.50.95:8848   #nacos服务地址
  username: nacos             #nacos链接账号
  password: nacos             #nacos链接密码

声明HelloService接口，服务注册方实现接口，服务端的工作就完成了

@Mapping("/rpc/")@Remotingpublic class HelloServiceRemoteImp implements HelloService {    @Override    public String hello() {        return "remote: hello";    }}

作为服务发现的客户端本地app.yml配置文件添加相关nacos的配置信息如下

solon.app:  namespace: test  group: demo       #配置服务使用的默认组  name: helloapp    #发现服务使用的应用名solon.cloud.nacos:  server: 192.168.50.95:8848   #nacos服务地址  username: nacos             #nacos链接账号  password: nacos             #nacos链接密码  config:    load: "test.properties"

测试的客户端中也是通过注解@NamiClient注入HelloService接口，添加一个测试controller控制器演示

@Controllerpublic class TestController {    //这是远程的    @NamiClient    HelloService helloService;    @Mapping("/test")    public String test() throws Exception {        helloService.hello();        String temp = helloService.hello();        System.out.println("helloService return"+temp);        return temp + "," + Solon.cfg().get("db1.url");    }}

已启动服务注册serverApp和服务发现ClientApp

查看Nacos服务管理可以看下服务名已经正常注册了

访问测试地址http://localhost:8080/test，可以看到成功调用服务注册方的方法，也打印从Nacos配置中心的配置项值，至此，已经实现基于Nacos的配置、服务注册和发现的基本功能。

**本人博客网站 **IT小神 www.itxiaoshen.com