Solon v3.0.1

::sagacity-sqltoy-solon-plugin [国产]

native </> markdown

此插件，由社区成员（夜の孤城、rabbit）贡献

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

1、描述

数据扩展插件，为 Solon Data 提供基于 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、应用示例

#数据源配置块（名字按业务需要取，与 @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 配置说明：与官方配置项上基本一致，且默认无需配置
# 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
  • 代码应用
//数据源相关的定制（可选）
@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;

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

具体可参考：