net.sohelp.boot.admin.core.db

类 MybatisHelper

java.lang.Object

net.sohelp.boot.admin.core.db.MybatisHelper

@Component
public class MybatisHelper
extends Object

Mybatis辅助工具类，提供数据库操作相关的通用方法。 包括数据源切换、分页查询、增删改查等基础功能。

从以下版本开始:

2024/3/30 18:09

作者:

AaronFung

构造器概要

构造器

构造器和说明
MybatisHelper(org.mybatis.spring.SqlSessionTemplate sqlSessionTemplate) 构造函数，初始化SqlSessionTemplate实例。

方法概要

限定符和类型	方法和说明
int	delete(String namespace, Map<String,Object> paramMap) 删除符合条件的记录。
double	getDouble(String namespace, Map<String,Object> paramMap) 查询单个双精度浮点数。
int	getInt(String namespace, Map<String,Object> paramMap) 查询单个整型数值。
double	getLong(String namespace, Map<String,Object> paramMap) 查询单个长整型数值。
Map	getMap(String namespace, Map<String,Object> paramMap) 查询单条记录并以Map形式返回。
Object	getObject(String namespace, Map<String,Object> paramMap) 查询单个值并以Object类型返回。
String	getString(String namespace, Map<String,Object> paramMap) 查询单个字符串类型的值。
int	insert(String namespace, Map<String,Object> paramMap) 插入一条记录。
List<Map>	list(String namespace, Map<String,Object> paramMap) 查询多条记录并以List
List<Map>	page(String namespace, Map<String,Object> paramMap) 根据请求中的分页参数（offset和limit）执行分页查询。
List<Map>	page(String namespace, Map<String,Object> paramMap, int offset, int limit) 执行带偏移量和限制数量的分页查询。
int	update(String namespace, Map<String,Object> paramMap) 更新记录信息。
MybatisHelper	use(String datasource) 切换当前使用的数据源，并返回新的MybatisHelper实例。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

MybatisHelper

public MybatisHelper(org.mybatis.spring.SqlSessionTemplate sqlSessionTemplate)

构造函数，初始化SqlSessionTemplate实例。

参数:

sqlSessionTemplate - MyBatis的SqlSession模板对象

方法详细资料

use

@Comment(value="\u5207\u6362\u6570\u636e\u6e90")
public MybatisHelper use(String datasource)
                                                                    throws Exception

切换当前使用的数据源，并返回新的MybatisHelper实例。

参数:

datasource - 要切换到的数据源名称

返回:

新创建的MybatisHelper实例，使用指定数据源对应的SqlSessionTemplate

抛出:

Exception - 获取新数据源会话模板时可能抛出异常

page

@Comment(value="\u81ea\u52a8\u5206\u9875")
public List<Map> page(String namespace,
                                                                  Map<String,Object> paramMap)

根据请求中的分页参数（offset和limit）执行分页查询。 支持通过page参数替代limit进行兼容性处理。

参数:

namespace - MyBatis映射文件中定义的SQL语句ID

paramMap - 查询条件参数集合

返回:

查询结果列表

page

@Comment(value="\u5206\u9875")
public List<Map> page(String namespace,
                                                      Map<String,Object> paramMap,
                                                      int offset,
                                                      int limit)

执行带偏移量和限制数量的分页查询。

参数:

namespace - MyBatis映射文件中定义的SQL语句ID

paramMap - 查询条件参数集合

offset - 偏移量，表示从第几条记录开始取

limit - 限制数量，表示最多取出多少条记录

返回:

查询结果列表

list

@Comment(value="\u67e5\u8be2")
public List<Map> list(String namespace,
                                                      Map<String,Object> paramMap)

查询多条记录并以List

参数:

namespace - MyBatis映射文件中定义的SQL语句ID

paramMap - 查询条件参数集合

返回:

查询结果列表

insert

@Comment(value="\u63d2\u5165")
public int insert(String namespace,
                                                  Map<String,Object> paramMap)

插入一条记录。

参数:

namespace - MyBatis映射文件中定义的SQL语句ID

paramMap - 插入所需字段及值组成的参数集合

返回:

受影响的行数

update

@Comment(value="\u66f4\u65b0")
public int update(String namespace,
                                                  Map<String,Object> paramMap)

更新记录信息。

参数:

namespace - MyBatis映射文件中定义的SQL语句ID

paramMap - 更新所需的字段及新值组成的参数集合

返回:

受影响的行数

delete

@Comment(value="\u5220\u9664")
public int delete(String namespace,
                                                  Map<String,Object> paramMap)

删除符合条件的记录。

参数:

namespace - MyBatis映射文件中定义的SQL语句ID

paramMap - 删除条件组成的参数集合

返回:

受影响的行数

getMap

@Comment(value="\u83b7\u53d6\u5355\u6761\u6570\u636e")
public Map getMap(String namespace,
                                                                          Map<String,Object> paramMap)

查询单条记录并以Map形式返回。

参数:

namespace - MyBatis映射文件中定义的SQL语句ID

paramMap - 查询条件参数集合

返回:

查询结果Map或null（如果没有匹配记录）

getObject

@Comment(value="\u83b7\u53d6\u5355\u6761\u6570\u636e")
public Object getObject(String namespace,
                                                                                Map<String,Object> paramMap)

查询单个值并以Object类型返回。

参数:

namespace - MyBatis映射文件中定义的SQL语句ID

paramMap - 查询条件参数集合

返回:

查询结果的第一个字段值或null（如果没有匹配记录）

getString

@Comment(value="\u83b7\u53d6\u5b57\u7b26\u4e32")
public String getString(String namespace,
                                                                          Map<String,Object> paramMap)

查询单个字符串类型的值。

参数:

namespace - MyBatis映射文件中定义的SQL语句ID

paramMap - 查询条件参数集合

返回:

查询结果转换成String的结果，默认为空字符串

getInt

@Comment(value="\u83b7\u53d6\u6574\u6570")
public int getInt(String namespace,
                                                              Map<String,Object> paramMap)

查询单个整型数值。

参数:

namespace - MyBatis映射文件中定义的SQL语句ID

paramMap - 查询条件参数集合

返回:

查询结果转换成int的结果

getDouble

@Comment(value="\u83b7\u53d6\u6d6e\u70b9\u6570")
public double getDouble(String namespace,
                                                                          Map<String,Object> paramMap)

查询单个双精度浮点数。

参数:

namespace - MyBatis映射文件中定义的SQL语句ID

paramMap - 查询条件参数集合

返回:

查询结果转换成double的结果

getLong

@Comment(value="\u83b7\u53d6\u957f\u6574\u6570")
public double getLong(String namespace,
                                                                        Map<String,Object> paramMap)

查询单个长整型数值。

参数:

namespace - MyBatis映射文件中定义的SQL语句ID

paramMap - 查询条件参数集合

返回:

查询结果转换成long的结果