```xml
<dependency>
    <groupId>org.noear</groupId>
    <artifactId>wood-solon-plugin</artifactId>
</dependency>
```

#### 1、描述

数据扩展插件，为 Solon Data 提供基于 wood 的框架适配，以提供ORM支持。（ Wood 项目仓库： [https://gitee.com/noear/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、应用示例


* 数据源配置与构建（具体参考：[《数据源的配置与构建》](/article/794)）

```yml
#数据源配置块（名字按业务需要取，与 @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
```


* 代码应用

```java
//启动应用
@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);
    }
}
```

* 支持静态获取

```java
//应用
@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](https://gitee.com/noear/solon-examples/tree/main/4.Solon-Data/demo4013-wood)