Mybatis 通用Crud

前言(说明)

源码地址：https://github.com/LittleNewbie/portal

mybatis版本 3.2.6

mybatis crud 较为简陋，请移步至mybatis jpa :https://my.oschina.net/LittleNewbie/blog/895198

实现功能：

1.对单条数据的查询、插入、更新、删除。

2.批量插入，根据条件删除，根据条件更新指定的列名-字段值。

<!-- 2017-02-18更新  start-->

1 主键类型不作限制；

2 增长对Boolean类型、Number类型、Date类型的处理；

3 代码优化；

<!-- 2017-02-18更新  end-->

<!-- 2016-11-13更新  start-->

1 新增批量操做数据方法：批量插入，根据条件删除，根据条件更新指定的列名-字段值。

2 新增高级查询方法：可设置查询列，查询条件，排序，分页。

3 根据一、2更新接口。

<!-- 2016-11-13更新  end-->

<!-- 2016-11-17更新  start-->

感谢@疯狂的逍遥 提出的问题和建议

1. GeneralMapper.xml文件移动至resources/mapping目录下。

问题描述：

[classpath:com/svili/portal/mapping/*.xml]:
 class path resource [com/svili/portal/mapping/] cannot be resolved to URL because it does not exist

缘由：IDEA编译时，src/java目录下非.java文件不会写入到容器。

2. GeneralMapper.xml文件修改，修复错误代码。

缘由：缘由是笔者提交了测试代码。

代码明细：

<!-- 原代码 -->
<insert id="insertSelective" parameterType="link">
<insert id="insertBatch" parameterType="link">

<!-- 修改后代码 -->
<insert id="insertSelective" parameterType="map">
<insert id="insertBatch" parameterType="map">

<!-- 2016-11-17更新  end-->

约束：

1.全面支持MySQL数据库，Oracle目前只支持selectByPrimaryKey()，insert()。

2.java 实体类字段名为驼峰风格，数据库字段名为下划线风格。

3.每张表都必需要有一个主键字段，字段类型无限制。

4.必须在实体类中注明主键，表名(可选)，使用JPA注解。

5.对于枚举类型的处理，以枚举ordinal()值，存取到数据库中。

/**
*需引入JPA jar包 javax.persistence
*/
@Table(name="user")
public class User {
	
	@Id
	private Integer userId;
    ...
}

接口预览

public interface CrudServiceInter {

	/**
	 * 根据主键查询
	 * @param <T> pojo类
	 * @param clazz pojo类-class对象
	 * @param primaryValue  主键值
	 * @return pojo对象
	 */
	<T> T selectByPrimaryKey(Class<T> clazz, Object primaryValue) throws Exception;

	/**
	 * 插入数据
	 * <p>实际调用insertSelective</p>
	 * @param <T> pojo类
	 * @param t  pojo对象
	 * @return 数据条数
	 */
	<T> int insert(T t) throws Exception;

	/**
	 * 插入数据
	 * @param <T>  pojo类
	 * @param t  pojo对象
	 * @return 数据条数
	 */
	<T> int insertSelective(T t) throws Exception;

	/**
	 * 删除
	 * <p>根据主键删除 </p>
	 * @param <T> pojo类
	 * @param clazz  pojo类-class对象
	 * @param primaryValue 主键值
	 * @return 数据条数
	 */
	<T> int deleteByPrimaryKey(Class<T> clazz, Object primaryValue);

	/**
	 * 更新
	 * <p> 根据主键更新 </p>
	 * <p> 更新pojo的全部字段，包括空值(null值)字段 </p>
	 * @param <T>  pojo类
	 * @param t  pojo对象
	 * @return 数据条数
	 */
	<T> int updateByPrimaryKey(T t) throws Exception;

	/**
	 * 更新
	 * <p>根据主键更新</p>
	 * <p> 更新pojo的非空字段 </p>
	 * @param <T> pojo类
	 * @param t  pojo对象
	 * @return 数据条数
	 */
	<T> int updateByPrimaryKeySelective(T t) throws Exception;

   //2016-11-13更新
   /**
	 * 批量插入
	 *@param list 数据集
	 *@return 数据条数
	 *@throws Exception
	 */
	<T> int insertBatch(List<T> list) throws Exception;

   /**
	 * 删除
	 * <p> 根据条件删除</p>
	 * @param <T> pojo类
	 * @param clazz pojo类-class对象
	 * @param conditionExp 查询条件 where 表达式 @see GeneralQueryParam
	 * @param conditionParam 查询条件 where 表达式中的参数集 @see GeneralQueryParam
	 * @return 数据条数
	 */
	<T> int deleteByCondition(Class<T> clazz, String conditionExp, Map<String, Object> conditionParam);
   
   /**
	 * 更新
	 * <p>根据条件更新 </p>
	 * <p> 更新pojo的指定字段集</p>
	 * @param clazz  pojo类-class对象
	 * @param columnValueMapping   须要更新的列名-值,注意列名必须与数据库中列名一致
	 * @param conditionExp  查询条件 where 表达式 @see GeneralQueryParam
	 * @param conditionParam  查询条件 where 表达式中的参数集 @see GeneralQueryParam
	 * @return 数据条数
	 */
	<T> int updateByConditionSelective(Class<T> clazz, Map<String, Object> columnValueMapping, String conditionExp,
			Map<String, Object> conditionParam) throws Exception;

   /**
	 * 高级查询
	 * @param clazz pojo类-class对象
	 * @param queryParam 查询参数
	 */
	<T> List<T> selectAdvanced(Class<T> clazz, GeneralQueryParam queryParam) throws Exception;

	/**
	 * 高级查询,指定返回列
	 * 
	 * @param clazz pojo类-class对象
	 * @param queryParam 查询参数
	 */
	<T> List<Map<String, Object>> selectAdvancedByColumn(Class<T> clazz, GeneralQueryParam queryParam) throws Exception;
}

使用中遇到的问题概括

1.java.lang.IllegalArgumentException:

Can not set java.lang.Integer field com.svili.portal.pojo.User.userId to java.lang.Long

缘由：mysql 中INT() UNSIGNED 无符号整型 会被mybatis自动映射为Long类型，为何？算下长度哈。

<!-- 2017-02-18更新start -- >

代码对Number类型作了处理，会根据java实体类字段类型进行匹配。

<!-- 2017-02-18更新 end  -- >

2.查询数据时，枚举类型不能匹配。

缘由：mysql TINYINT(1) 会被mybatis自动映射为boolean值，也就是说0-false，1-true。

布尔值怎么和枚举匹配噢！

解决方案：改下长度，如改成TINYINT(2)，不要把TINYINT类型的长度设为1。

 

关于设计思路

设计思路博文地址：https://my.oschina.net/LittleNewbie/blog/786783

欢迎探讨！