<mark>此插件，主要社区贡献人（夜の孤城、rabbit）</mark>

```xml
<dependency>
    <groupId>com.sagframe</groupId>
    <artifactId>sagacity-sqltoy-solon-plugin</artifactId>
    <version>最新版本</version>
</dependency>
```

#### 1、描述

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


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

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


@Db 可注入类型：

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


* sqltoy 配置说明：与官方配置项上基本一致，且默认无需配置

```yml
# sqltoy 在 spring boot 中的配置方式（仅作为对比参考）
#spring.sqltoy.sqlResourcesDir: classpath:com/sqltoy/quickstart
#spring.sqltoy.translateConfig: classpath:sqltoy-translate.xml


# sqltoy 在 solon 中的配置方式及默认值
sqltoy.sqlResourcesDir: classpath:sqltoy
sqltoy.translateConfig: classpath:sqltoy-translate.xml

# 缓存类型,默认为Solon提供的缓存，即由CacheService提供
sqltoy.cacheType: solon
```


* 代码应用

```java
//数据源相关的定制（可选）
@Configuration
public class Config {
    @Bean
    public void db1Init(@Db("db1") SqlToyLazyDao dao){
        //做个初始化，或者给什么静态字段赋值
    }
}

//应用
@Component
public class AppService{
    @Db
    private SqlToyLazyDao db1;
    
    @Db("db2")//多数据源
    private SqlToyLazyDao db2;

    //@Transaction 使用Transaction
    public void test(){
        db1.save(entity);
        //其他dao操作
    }
}
```

**具体可参考：**

- [https://gitee.com/noear/solon-examples/tree/main/4.Solon-Data/demo4061-sqltoy](https://gitee.com/noear/solon-examples/tree/main/4.Solon-Data/demo4061-sqltoy)
- [https://gitee.com/sagacity/sagacity-sqltoy](https://gitee.com/sagacity/sagacity-sqltoy)
- [sqltoy-online-doc](https://www.kancloud.cn/hugoxue/sql_toy/2390352)