Solon

beetlsql-solon-plugin

v2.7.3 </> markdown
<dependency>
    <groupId>org.noear</groupId>
    <artifactId>beetlsql-solon-plugin</artifactId>
</dependency>

1、描述

数据扩展插件,为 Solon Data 提供基于 beetlsql(代码仓库)的框架适配,以提供ORM支持。

2、强调多数据源支持

  • 强调多数据源的配置。例:demo.db1...,demo.db2...
  • 强调带 name 的 DataSource Bean
  • 强调使用 @Db("name") 的数据源注解

@Db 可注入类型:

支持类型说明
Mapper.class注入 Mapper。例:@Db("db1") UserMapper userMapper
SQLManager注入 SQLManager。例:@Db("db1") SQLManager db1 (不推荐直接使用)

3、应用示例

  • 数据源配置
demo.db1:
  schema: rock
  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,db3"  #快捷配置:从库配置(可选)
  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"
  • 代码应用
//配置数据源
@Configuration
public class Config {
    //此下的 db1 与 beetlsql.db1 将对应在起来 //可以用 @Db("db1") 注入mapper
    //typed=true,表示默认数据源。@Db 可不带名字注入 
    @Bean(name="db1", typed=true)
    public DataSource db1(@Inject("${demo.db1}") HikariDataSource ds) {
        return ds;
    }
    
    @Bean("db2")
    public DataSource db2(@Inject("${demo.db2}") HikariDataSource ds) {
        return ds;
    }
    
    //尽量使用配置解决,如果配置解决不了的,用接口定制
    //@Bean
    //public void db2Init(@Db("db2") SQLManager sqlManager) {
        //sqlManager.setNc(new DefaultNameConversion());
    //}
}

//应用
@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}
\```

代码示例:

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