wood-solon-plugin [国产]

<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 可注入类型：

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