```xml
<dependency>
    <groupId>net.hasor</groupId>
    <artifactId>dbvisitor-solon-plugin</artifactId>
    <version>最新版</version>
</dependency>
```

#### 1、描述

数据扩展插件，为 Solon Data 提供基于 dbvisitor（[代码仓库](https://gitee.com/zycgit/dbvisitor)）的框架适配，以提供ORM支持。（原 hasordb 更名为：dbvisitor）

#### 2、强调多数据源支持

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


@Db 可注入类型：

| 支持类型 | 说明 | 
| -------- | -------- | 
| Mapper.class     | 注入 Mapper。例：`@Db("db1") UserMapper userMapper`     | 
| WrapperAdapter     | 注入 WrapperAdapter。例：`@Db("db1") WrapperAdapter db1` | 
| JdbcTemplate     | 注入 JdbcTemplate。例：`@Db("db1") JdbcTemplate db1` | 
| DalSession     | 注入 DalSession。例：`@Db("db1") LambdaTemplate 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
    
dbvisitor:
  db1:   # 对应的数据源名称
    mapperLocations: classpath:demo4072/dso/mapper/*.xml
    mapperPackages: demo4072.dso.mapper.*
    dialect: mysql
```


* 代码应用

```java
//Mapper
@RefMapper("/demo4072/dso/mapper/AppxMapper.xml")
public interface AppxMapper {
    Appx appx_get();
    List<Appx> appx_get_page(Page pageInfo);
    Appx appx_get2(int app_id);
    void appx_add();
    Integer appx_add2(int v1);

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


//应用
@Component
public class AppService{
    //可用 @Db 或 @Db("db1")  注入
    @Db
    AppxMapper appMapper; //xml sql mapper 
    
    @Db
    JdbcTemplate jdbcTemplate;
    
    @Db
    WrapperAdapter wrapperAdapter;
    
    public void test(){
        //三种不同接口的样例
        App app1 = appMapper.getAppById(12);
        
        //
        jdbcTemplate.queryForMap("select * from appx where id=12");
    }
}
```

**具体可参考：**

[https://gitee.com/noear/solon-examples/tree/main/4.Solon-Data/demo4072-dbvisitor](https://gitee.com/noear/solon-examples/tree/main/4.Solon-Data/demo4072-dbvisitor)

[https://www.dbvisitor.net/](https://www.dbvisitor.net/)