```xml
<dependency>
    <groupId>com.ibeetl</groupId>
    <artifactId>sql-solon-plugin</artifactId>
    <version>最新版本</version>
</dependency>
```

#### 1、描述

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


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

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


@Db 可注入类型：

| 支持类型 | 说明 | 
| -------- | -------- | 
| Mapper.class     | 注入 Mapper。例：`@Db("db1") UserMapper userMapper`     | 
| SQLManager     | 注入 SQLManager。例：`@Db("db1") SQLManager 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
  db2:
    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
  

# 配置印射的是 SQLManagerBuilder 字段（1.10.3 开始支持）
beetlsql.db1:
  slaves: "db2"  #快捷配置：从库配置（可选）//上面配置的数据源名字
  dev: true  #快捷配置：是否调试模式
  nc: "org.beetl.sql.core.DefaultNameConversion" #字段映射
  dbStyle: "org.beetl.sql.core.db.MySqlStyle" #方言
  inters: #字段映射
    - "org.beetl.sql.ext.DebugInterceptor" #与 dev 效果相同
    - "org.beetl.sql.ext.Slf4JLogInterceptor"
```


* 代码应用


```java
//数据源相关的定制（可选）
@Configuration
public class Config {
    //尽量使用配置解决，如果配置解决不了的，用接口定制
    //@Bean
    //public void db2Init(@Db("db2") SQLManager sqlManager) {
        //sqlManager.setNc(new DefaultNameConversion());
        //sqlManager.setDbStyle(new MySqlStyle());
        //sqlManager.setInters(new Interceptor[]{});
    //}
}

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

    @Db
    BaseMapper<App> appBaseMapper; //base mapper
    
    public void test(){
        //三种不同接口的样例
        App app1 = appMapper.getAppById(12);
        App app2 = appBaseMapper.getById(12);
    }
}
```

#### 4、分页查询

模板示例（下面的 \ 要去掉）

```
appx_getlist_page
===
\```sql
select
    -- @pageTag(){
    app_id,name
    -- @} 
from appx where app_id > #{app_id}
\```
```

代码示例：

```java
public class PageService {
    @Db
    SqlMapper sqlMapper;

    public PageRequest<AppxModel> page() throws Exception{
        //分页查询
        PageRequest pageRequest = DefaultPageRequest.of(1,10);
        return sqlMapper.appx_getlist_page(pageRequest, 1);
    }
}
```


**具体可参考：**

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