Solon v3.0.4

wood-solon-plugin [国产]

native </> markdown
<dependency>
    <groupId>org.noear</groupId>
    <artifactId>wood-solon-plugin</artifactId>
</dependency>

1、描述

数据扩展插件,为 Solon Data 提供基于 wood 的框架适配,以提供ORM支持。( Wood 项目仓库: https://gitee.com/noear/wood

提醒:使用时如果不需要 mapper 功能,可以排除掉 “org.noear:wood.plus”。

2、强调多数据源支持

  • 强调多数据源的配置。例:db1,db2(只是示例,具体根据业务取名)
  • 强调带 name 的 DataSource Bean
  • 强调使用 @Db("name") 的数据源注解

@Db 可注入类型:

支持类型说明
Mapper.class注入 Mapper。例:@Db("db1") UserMapper userMapper
DbContext注入 DbContext。例:@Db("db1") DbContext db1

3、应用示例

#数据源配置块(名字按业务需要取,与 @Db 那边对起来就好)
solon.dataSources:
  db1!:
    class: "com.zaxxer.hikari.HikariDataSource"
    jdbcUrl: jdbc:mysql://localhost:3306/rock?useUnicode=true&characterEncoding=utf8&autoReconnect=true&rewriteBatchedStatements=true
    driverClassName: com.mysql.cj.jdbc.Driver
    username: root
    password: 123456
  • 代码应用
//启动应用
@SolonMain
public class DemoApp {
    public static void main(String[] args) {
        Solon.start(DemoApp.class, args, (app) -> {
            if (Solon.cfg().isDebugMode() || Solon.cfg().isFilesMode()) {
                //执行后打印sql
                WoodConfig.onExecuteAft(cmd -> {
                    System.out.println("[Wood]" + cmd.text + "\r\n" + cmd.paramMap());
                });
            }
        });
    }
}

//应用
@Component
public class AppService{
    @Db
    AppMapper appMapper; //xml sql mapper

    @Db
    BaseMapper<App> appBaseMapper; //base mapper

    @Db
    DbContext db;
    
    public void test(){
        //三种不同接口的样例
        App app1 = appMapper.getAppById(12);
        App app2 = appBaseMapper.getById(12);
        App app3 = db.table("app").whereEq("id",12).selectItem("*", App.class);
        
        //关联+分页查询
        List<User> users = db.table("user u")
          .innerJoin("user_ext e").onEq("u.id","e.user_id")
          .whereEq("u.type",11)
          .limit(100,20)
          .selectList("u.*,e.sex,e.label", User.class);
    }
}
  • 支持静态获取
//应用
@Component
public class AppService{
    
    static DbContext db(){
        return DbContext.use("db1"); //不要为字段赋值(赋值时,实例可能还不存在)
    }
    
    public void test(){
        App app3 = db().table("app").whereEq("id",12).selectItem("*", App.class);
    }
}

4、如何从 weed3 升级为 wood ?

采用批量替换的方式进行(要区分大小写):

  • "weed3" 替换为 "wood"
  • "weed" 替换为 "wood"
  • "Weed3" 替换为 "Wood"
  • "Weed" 替换为 "Wood"

具体可参考:

https://gitee.com/noear/solon-examples/tree/main/4.Solon-Data/demo4013-wood