QQ交流群：22200020

solon for java

一个微型Java开发框架。

支持jdk8+；主框架0.1mb；组合不同的插件应对不同需求；方便定制；快速开发。

• 更快、更小、更自由
• 自带IOC & AOP容器，支持MVC
• 采用Handler + Context 架构；强调插件式扩展
• 统一Http（支持 Servlet 或 NoServlet），WebSocket，Socket三种信号接入
• 插件可扩展可切换：启动插件，扩展插件，序列化插件，数据插件，会话状态插件，视图插件(可共存) 等...

Hello world：

//Handler 模式：
public class App{
    public static void main(String[] args){
        XApp app = XApp.start(App.class,args);
        
        app.get("/",(c)->c.output("Hello world!"));
    }
}

//Controller 模式：
@XController
public class App{
    public static void main(String[] args){
        XApp.start(App.class,args);
    }
  
    @XMapping("/")
    public Object home(XContext c){
        return "Hello world!";  
    }
}

主框架及快速集成开发包：

主框架

组件	说明
org.noear:solon-parent	框架版本管理
org.noear:solon	主框架
org.noear:fairy	伴生框架（做为solon rpc 的客户端）

快速集成开发包

组件	说明
org.noear:solon-web	可进行http api, mvc, rpc开发的快速集成包

附1：入门示例

• Web 示例（mvc）

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

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

//资源路径说明（不用配置）
resources/application.properties（或 application.yml） 为应用配置文件
resources/static/ 为静态文件根目标
resources/WEB-INF/view/ 为视图文件根目标（支持多视图共存）

//调试模式：
启动参数添加：-debug=1

public class App{
    public static void main(String[] args){
        XApp.start(App.class, args);
    }
}

/*
 * mvc控制器
 */
@XController
public class DemoController{
    //for http
    @XMapping("/hallo/{u_u}")
    public ModelAndView hallo(String u_u){
        return new ModelAndView("hallo");
    }
    
    /*
    //for web socket （需添加：solon.boot.websocket 插件）
    @XMapping(value="/hallo/{u_u}", method = XMethod.SEND)
    public ModelAndView hallo_ws(String u_u){
        return new ModelAndView("hallo");
    }
    */
}

• Rpc 示例（+验证注解）

// - interface : 定义协议
public interface DemoService{
    void setName(Integer user_id, String name);
}

// - server : 实现协议
@XValid
@XMapping("/demo/*")
@XBean(remoting = true)
public class DemoServiceImp implements DemoService{
    //添加验证注解
    @NotZero("user_id")
    public void setName(int user_id, String name){
        
    }
}

// - client - 简单示例
//注入模式
//@FairyClient("http://127.0.0.1:8080/demo/") 
//DemoService client;

//构建模式
DemoService client = Fairy.builder().upstream(n->"http://127.0.0.1:8080/demo/").create(DemoService.class); 
client.setName(1,'');

• 获取应用配置

//非注入模式
XApp.cfg().get("app_key"); //=>String
XApp.cfg().getInt("app_id",0); //=>int
XApp.cfg().getProp("xxx.datasource"); //=>Properties

//注入模式
@XConfiguration //or @XController, or @XBean
public class Config{
    @XInject("${app_key}")
    String app_key;
}

• 事务与缓存控制

@XController
public class DemoController{
    @Db
    BaseMapper<UserModel> userService;
    
    @XCacheRemove(tags = "user_${user_id}")
    @XTran
    @XMapping("/user/update")
    public void udpUser(int user_id, UserModel user){
        userService.updateById(user);
    }
    
    @XCache(tags = "user_${user_id}")
    public UserModel getUser(int user_id){
        return userService.selectById(user_id);
    }
}

• Servlet 注解支持

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

附2：示例参考

• 项目内的：_test 和 _demo
• 更多示例：solon_demo

附3：插件开发说明

• 新建一个 maven 项目
• 新建一个 java/{包名}/XPluginImp.java （implements XPlugin）
• 新建一个 resources/META-INF/solon/{包名.properties}
• 添加配置：solon.plugin={包名}.XPluginImp

附4：启动顺序参考

• 1.实例化 XApp.global() 并加载配置
• 2.加载扩展文件夹
• 3.扫描插件
• 4.运行builder函数
• 5.运行插件
• 6.扫描并加载java bean
• 7.加载渲染关系
• 8.完成

附5：Helloworld 的单机并发数

机器：2017款 macbook pro 13, i7, 16g, jdk11

测试：wrk -t10 -c200 -d30s --latency "http://127.0.0.1:8080/"

solon 1.0.40	大小	QPS	spring boot 2.3.3	QPS
solon.boot.jlhttp (可独立运行)	0.1m	4.7万左右	/
/			spring-boot-starter-tomcat	3.2万左右
solon.boot.jetty (支持Servlet，可独立运行)	1.8m	10.7万左右	spring-boot-starter-jetty	3.7万左右
solon.boot.undertow (支持Servlet，可独立运行)	4.2m	11.3万左右	spring-boot-starter-undertow	4.4万左右

javalin 3.1.0	大小	QPS
javalin(jetty)	4.8m	9.8万左右