mapper-spring-boot-starter 应用研究

置顶：Mybatis通用Mapper3，一个权威的文档https://mapperhelper.github.io/docs/
————————————

18.1.26
继承了Mapper<T>。
其中save和insertOrUpdate方法，会忽略mysql中设置的默认值。
使用insertSelective方法，就不会忽略默认值。
//插入一条数据,只插入不为null的字段,不会影响有默认值的字段
//支持Oracle序列,UUID,类似Mysql的INDENTITY自动增长(自动回写)
//优先使用传入的参数值,参数值空时,才会使用序列、UUID,自动增长
int insertSelective(T record);
参考：http://blog.csdn.net/isea533/article/details/41457529。
————————————
注意：在SpringBoot中使用通用Mapper。
Spring-boot启动类，@MapperScan仅扫描业务接口包，不能扫描本地通用Mapper接口包，否则报java.lang.ClassCastException: sun.reflect.generics.reflectiveObjects.TypeVariableImpl cannot be cast to java.lang.Class异常。
17.12.27
下面26日写的只是写代码流程的简介。
这里写一些具体的注意事项，当然也都是从别人的博客摘抄的。

泛型(实体类)<T>的类型必须符合要求
实体类按照如下规则和数据库表进行转换,注解全部是JPA中的注解:

1. 表名默认使用类名,驼峰转下划线(只对大写字母进行处理),如UserInfo默认对应的表名为user_info。
2. 表名可以使用@Table(name = “tableName”)进行指定,对不符合第一条默认规则的可以通过这种方式指定表名.
3. 字段默认和@Column一样,都会作为表字段,表字段默认为Java对象的Field名字驼峰转下划线形式.
4. 可以使用@Column(name = “fieldName”)指定不符合第3条规则的字段名
5. 使用@Transient注解可以忽略字段,添加该注解的字段不会作为表字段使用.
6. 建议一定是有一个@Id注解作为主键的字段,可以有多个@Id注解的字段作为联合主键.
   7.默认情况下,实体类中如果不存在包含@Id注解的字段,所有的字段都会作为主键字段进行使用(这种效率极低).
   8.实体类可以继承使用,可以参考测试代码中的com.github.abel533.model.UserLogin2类.
   9.由于基本类型,如int作为实体类字段时会有默认值0,而且无法消除,所以实体类中建议不要使用基本类型。
   除了上面提到的这些,Mapper还提供了序列(支持Oracle)、UUID(任意数据库,字段长度32)、主键自增(类似Mysql,Hsqldb)三种方式，其中序列和UUID可以配置多个，主键自增只能配置一个。
   参考文章：http://blog.csdn.net/xfz0330/article/details/52275192

————————————
17.12.26
新项目打算使用通用mapper，针对mybatis，原来写xml的方式面对众多文件和sql总是感觉乱糟糟的。使用通用mapper就可以省去很多写mapper和sql的时间，即不需要写Mapper.xml。
1、引入mapper-spring-boot-starter
去maven repository里面找适合的版本。
2、mapper也就是dao，需要一个具体dao接口继承Mapper<T>。泛型就是对应的domain。必须指定泛型实体<T>
这种写法完全不需要dao接口的实现类。
@Repository
public interface UserDao extends Mapper<User>{
public User selectUserByUserName(User user) throws Exception;
}
3、对于domain，与数据库表对应的注解一个不能少。
在类上面加@Table(name = "authority_user")。指定对应表明。
在属性上面加@Column(name = "name")。指定对应的字段名。
在主键id上面加
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
如果存在数据库表中不存在的属性，需要用@Transient注解，否则会报错与数据表不对应之类的问题吧。
@Table(name = "authority_user")
public class User implements Serializable{
private static final long serialVersionUID = 1L;
/** 用户id /
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
/ 用户名称 /
@Column(name = "name")
private String name;
/ 用户密码 **/
@Column(name = "password")
private Integer password;
--省略set/get方法--
}
4、在启动类上面需要加扫描注解
@MapperScan(basePackages = { "com.example.test.dao" }) //扫描mapper
如果不加就是报错，找不到dao对应的bean
5、写测试
@RunWith(SpringRunner.class)
@SpringBootTest
public class SpringBootMyBatisApplicationTests {

@Autowired
private UserDao mapper;

// 插入一条新记录
@Test
public void insertOne() {
    User newUser = new User();
    
    newUser.setName("测试用户特朗普");
    newUser.setPassword(123);
    mapper.insertSelective(newUser);
    System.out.println("插入成功");
}

}
以上运行一下应该没问题。不过我写的也是过于简略了。
————————
补充。
接口可以多继承。可以写一个更高级的mapper接口。
public interface TkMapper<T> extends Mapper<T>, MySqlMapper<T> {

}
其中
Mapper接口：基本的增、删、改、查方法
MySqlMapper：针对MySQL的额外补充接口，支持批量插入