跳到主要内容

3.4 Solon 整合

什么是 Solon​

面向全场景的 Java 企业级应用开发框架：克制、高效、开放、生态！并发高 300%；内存省 50%；启动快 10 倍； 打包小 90%；同时兼容 java8 ~ java23。（可替换 Spring）

dbvisitor-solon 特性​

  • 自动配置数据源
  • Mapper 接口注入
  • 支持多数据源
  • 支持事务控制

配置方法​

首先引入依赖包，当前版本：6.0.4

Maven 依赖
<dependency>
    <groupId>net.hasor</groupId>
    <artifactId>dbvisitor-solon-plugin</artifactId>
    <version>最新版本的版本号</version>
</dependency>
选用 HikariCP 作为数据库链接池
<dependency>
    <groupId>com.zaxxer</groupId>
    <artifactId>HikariCP</artifactId>
    <version>4.0.3</version>
</dependency>
配置文件
solon.dataSources:
  default!:  # 数据源名称（尾部 ! 标识默认数据源）
    class: "com.zaxxer.hikari.HikariDataSource"
    jdbcUrl: "jdbc:mysql://127.0.0.1:13306/devtester?allowMultiQueries=true&user=root&password=123456"
dbvisitor:
  default:   # 对应的数据源名称
    mapperLocations: classpath:dbvisitor/mapper/*.xml
    mapperPackages: net.hasor.dbvisitor.test.dao.*
注入 Mapper
@Controller
public class HelloController {
  @Inject
  private UserMapper userMapper;

  @Get
  @Mapping("/hello")
  public String hello(String name) {
    return ...
  }
}
Example

Example 工程

可注入类型​

  • JdbcOperations 接口，JdbcTemplate 是它的实现类
  • LambdaOperations 接口，LambdaTemplate 是它的实现类
  • Configuration 配置类
  • Session 类
  • 自定义 Mapper
注入提示
  • 以上注入的类型支持 @Db、@Inject 注解
  • @Db 可以通过 @Db("name") 在多数据源下指定数据源名称

使用事务​

通过 @Tran 注解进行事务控制
import org.noear.solon.data.annotation.Tran;

public class TxExample {
    @Tran(policy = TranPolicy.required)
    public void exampleMethod() throws SQLException {
      ...
    }
}

配置项说明​

属性名描述
mapperLocations可选 要扫描加载的 Mapper 映射文件所在路径，默认值为 dbvisitor/mapper/*.xml
mapperPackages可选 要扫描加载的 Mapper 接口定义所在的包名，如果有多个包使用 , 号分割
mapperDisabled可选 使用 true/false 表示是否禁用 dbvisitor.mapper-packages 扫描到的 Mapper 接口。
默认值为 false 当与某些框架合用同一个 mapper 文件时如果遇到冲突可考虑设置为 true
markerAnnotation可选 设置一个扫描路径当扫描到的 Mapper 接口身上标有某个特定类型的注解时才会被认作 Mapper 接口类。默认为：net.hasor.dbvisitor.mapper.MapperDef
markerInterface可选 设置一个扫描路径当扫描到的 Mapper 接口实现了某个特定接口时才会被认作 Mapper 接口类。默认为：net.hasor.dbvisitor.mapper.Mapper
autoMapping可选 是否将类型下的所有字段都自动和数据库中的列进行映射匹配，true 表示自动。false 表示必须通过 @Column 注解声明
camelCase可选 表名和属性名，根据驼峰规则转换为带有下划线的表名和列名
useDelimited可选 强制在生成 表名/列名/索引名 时候增加标识符限定，例如：通过设置该属性来解决列名为关键字的问题。默认是 false 不设置。
caseInsensitive可选 是否对表名列名敏感，默认 true 不敏感
ignoreNonExistStatement可选 在 Mapper 接口方法映射到 XML 过程中是否忽略缺失的映射。默认是 false，遇到缺失会报错。
dialect可选 默认使用的数据库方言