SqlHelper发布——比Mybatis-PageHelper性能更高
起源
前段时间开启了一个新的项目,在选择分页插件时,发现github上很流行的一个是pagehelper,在百度上搜索了一下,使用量。由于项目紧急,所先拿来用了。但是我知道它并不适合我们。原因是它有如下几个缺点:
1) 对国产数据库支持不足
2) 扩展不方便
3) 配置复杂
4) 性能底下 (不要喷我, 因为它不是用的占位符?,发挥不了PrepareSatement的优势)
5) 只支持MyBatis
鉴于它的这些不足,我就趁闲暇时间新开发了一款解决上述缺点的分页工具,它已经在公司里的两个项目得到了验证。但它不仅仅是个分页工具那么简单,目前支持的特性有Pagination、UrlParser,未来会支持更多特性。
关键特性
- 支持MyBatis, JFinal,Ebean,Mango
- 支持 90+ 种数据库, 支持列表参见 here. 包含了几乎所有的国产数据库:
- TiDB (北京平凯星辰科技))
- Doris (Apache Doris,百度研发)
- MaxCompute (阿里巴巴)
- K-DB (浪潮)
- GBase (南大通用)
- DM (达梦)
- OSCAR (神州通用)
- HighGo (瀚高)
- KingBase (金仓)
- OpenBase (东软)
- SequoiaDB (巨杉)
如果你想知道所有的数据库排名的话,你可以在这里找到: DB Engines.
- 同一个应用中支持多种数据库
- 不需要配置dialect,可以自动的获取。
- 比 Mybatis-PageHelper性能更高, 原因是limit , offset等参数使用 PrepareStatement placeholder '?' , Mybatis是硬编码拼接的
- 通过Java SPI的方式支持了插件
- 支持 spring boot 1.x , 2.x
- 支持 mybatis 3.x
- 支持 JDK6+
Vs Pagehelper
metric |
mybatis-pagehelper |
sqlhelper |
databases |
13 |
90+ |
multiple databases in runtime |
√ |
√ |
auto detect dialect |
√ |
√ |
plugin |
√ |
√ |
PrepareStatement with '?' |
X |
√ |
mybatis |
3.x |
3.x |
spring boot |
1.x, 2.x |
1.x, 2.x |
JDK |
1.6+ |
1.6+ |
jFinal |
X |
√ |
EBean |
X |
√ |
Mango |
X |
√ |
国产数据库 |
X |
√ (参见上述列表) |
安装
可以在多种场景下使用,支持MyBatis,JFinal,EBean等。先就说说MyBatis下如何使用:
1) 与Mybatis + SpringBoot结合使用
此应用环境下,只需导入下列包即可:
<dependency> <groupId>com.github.fangjinuo.sqlhelpergroupId> <artifactId>sqlhelper-mybatis-spring-boot-autoconfigureartifactId> <version>${sqlhelper.version}version> dependency> <dependency> <groupId>com.github.fangjinuo.sqlhelpergroupId> <artifactId>sqlhelper-mybatis-spring-boot-starterartifactId> <version>${sqlhelper.version}version> dependency>
2)与MyBatis (无spring boot)结合使用
此应用环境下,使用也不麻烦。
第一步,导入依赖:
<dependency> <groupId>com.github.fangjinuo.sqlhelpergroupId> <artifactId>sqlhelper-dialectartifactId> <version>${sqlhelper.version}version> dependency>
第二步:配置插件:
<configuration> ... <databaseIdProvider type="DB_VENDOR"> <property name="SQL Server" value="sqlserver"/> <property name="DB2" value="db2"/> <property name="Oracle" value="oracle" /> databaseIdProvider> ... <settings> ... <setting name="defaultScriptingLanguage" value="com.github.fangjinuo.sqlhelper.mybatis.plugins.pagination.CustomScriptLanguageDriver" /> ... settings> ... configuration> <plugins> <plugin interceptor="com.github.fangjinuo.sqlhelper.mybatis.plugins.pagination.MybatisPaginationPlugin" /> plugins>
使用
@GetMapping
public PagingResult list(){
User queryCondtion = new User();
queryCondtion.setAge(10);
PagingRequest request = new PagingRequest()
.setPageNo(1)
.setPageSize(10);
PagingRequestContextHolder.getContext().setPagingRequest(request);
List users = userDao.selectByLimit(queryCondtion);
request.getResult().setItems(users);
return request.getResult();
}
从mybatis-pagehelper迁移
为了兼容已有的应用,特意提供了从mybatis-pagehelper迁移工具。使用也很简单,把mybatis-pagehelper.jar移除,导入下面的包即可。
<dependency> <groupId>com.github.fangjinuo.sqlhelpergroupId> <artifactId>sqlhelper-mybatis-over-pagehelperartifactId> <version>${sqlhelper.version}version> dependency>
支持
https://github.com/fangjinuo/sqlhelper