Spring on F嘉阳

mybatis中遇到的坑

Thu, 27 Dec 2018 12:37:00 +0800

mysql驱动问题

问题描述

问题发生时间（2018-12-27）

环境版本：

SpringBoot 2.1.1
Mybatis 1.3.2

原始配置

spring:
 datasource:
 driver-class-name: com.mysql.jdbc.Driver
 username: hikaricp
 password: hikaricp
 url: jdbc:mysql://localhost:3306/db_test?characterEncoding=utf-8&useSSL=false

报错信息

Registered driver with driverClassName=com.mysql.jdbc.Driver was not found,

报错提示

Loading class `com.mysql.jdbc.Driver'. This is deprecated. The new driver class is `com.mysql.cj.jdbc.Driver'. The driver is automatically registered via the SPI and manual loading of the driver class is generally unnecessary.

解决办法

从提示中可看出，驱动名称有变，更正驱动名称即可

更正后配置

spring:
 datasource:
 driver-class-name: com.mysql.cj.jdbc.Driver
 username: hikaricp
 password: hikaricp
 url: jdbc:mysql://localhost:3306/db_test?characterEncoding=utf-8&useSSL=false

同时若使用IDEA自带提示也可看出问题，有两种驱动都存在的问题，希望后续修复

另一种解决方案，从SpringBoot2.0之后连接池使用hikari，可根据url自动识别驱动，即如下配置也可成功运行

spring:
 datasource:
 username: hikaricp
 password: hikaricp
 url: jdbc:mysql://localhost:3306/db_test?characterEncoding=utf-8&useSSL=false

注解使用简化

前景提要

进入SpringBoot时代后“注解驱动开发”就已经成为趋势，mybatis官方也提供注解替代xml配置的方案

问题描述

问题发现时间（2018-12-27）

环境版本：

SpringBoot 2.1.1
Mybatis 1.3.2

在早期版本的mybatis-starter还需要进行实体映射xml文件配置，这次在使用1.3.2版本时再次查了下官方源码，发现已经无需使用映射文件，其底层会自动通过反射识别对象属性类型，并且去除了不少早期版本使用的注解（当前仍可以使用，但不使用功能正常）

无需手动创建SqlSession或DataSource

官方文档说明：

As you may already know, to use MyBatis with Spring you need at least an SqlSessionFactory and at least one mapper interface.

MyBatis-Spring-Boot-Starter will:

Autodetect an existing DataSource.

Will create and register an instance of a SqlSessionFactory passing that DataSource as an input using the SqlSessionFactoryBean.

Will create and register an instance of a SqlSessionTemplate got out of the SqlSessionFactory.

Autoscan your mappers, link them to the SqlSessionTemplate and register them to Spring context so they can be injected into your beans.

支持版本为Spring 4.3+

You just need to create a normal Spring boot application and let the mapper be injected like follows(available on Spring 4.3+):

@MapperScan -> @Mapper

早期版本需要在启动类上加上@MapperScan(basePackages = "xxx")注解扫描mapper类，新版本可直接在mapper包上使用@Mapper注解即可

The MyBatis-Spring-Boot-Starter will search, by default, for mappers marked with the @Mapper annotation.

除非需要自定义注解或者不使用@Mapper才需要加上@MapperScan

You may want to specify a custom annotation or a marker interface for scanning. If so, you must use the @MapperScan annotation.

@Results与Mapper.xml

早期版本需要手动指定类型映射，并在resources目录下进行xml配置，新版本自动通过反射识别属性类型，无需进行xml配置

Spring Data JPA 知识记录

Sun, 09 Dec 2018 17:04:00 +0800

jpa方法命名规则

关键字	方法命名	sql where字句
And	findByNameAndPwd	where name= ? and pwd =?
Or	findByNameOrSex	where name= ? or sex=?
Is,Equals	findById,findByIdEquals	where id= ?
Between	findByIdBetween	where id between ? and ?
LessThan	findByIdLessThan	where id < ?
LessThanEquals	findByIdLessThanEquals	where id <= ?
GreaterThan	findByIdGreaterThan	where id > ?
GreaterThanEquals	findByIdGreaterThanEquals	where id > = ?
After	findByIdAfter	where id > ?
Before	findByIdBefore	where id < ?
IsNull	findByNameIsNull	where name is null
isNotNull,NotNull	findByNameNotNull	where name is not null
Like	findByNameLike	where name like ?
NotLike	findByNameNotLike	where name not like ?
StartingWith	findByNameStartingWith	where name like ‘?%’
EndingWith	findByNameEndingWith	where name like ‘%?’
Containing	findByNameContaining	where name like ‘%?%’
OrderBy	findByIdOrderByXDesc	where id=? order by x desc
Not	findByNameNot	where name <> ?
In	findByIdIn(Collection c)	where id in (?)
NotIn	findByIdNotIn(Collection c)	where id not in (?)
TRUE	findByAaaTue	where aaa = true
FALSE	findByAaaFalse	where aaa = false
IgnoreCase	findByNameIgnoreCase	where UPPER(name)=UPPER(?)

常用注解

自动生成时间和修改者

@CreatedDate、@CreatedBy、@LastModifiedDate、@LastModifiedBy

在spring jpa中，支持在字段或者方法上进行注解@CreatedDate、@CreatedBy、@LastModifiedDate、@LastModifiedBy，从字面意思可以很清楚的了解，这几个注解的用处。

@CreatedDate 表示该字段为创建时间时间字段，在这个实体被insert的时候，会设置值

@CreatedBy 表示该字段为创建人，在这个实体被insert的时候，会设置值

@LastModifiedDate、@LastModifiedBy同理。

自动建表引擎设置

使用SpringDataJpa自动建表默认为MyISAM，而主流大多数场景都需要使用InnoDB，可通过配置文件配置即可

spring:
 jpa:
 database-platform: org.hibernate.dialect.MySQL55Dialect

注意：类名有所变化

早期通过网上搜索的类名都说为org.hibernate.dialect.MySQL5InnoDBDialect，当实际测试时发现引擎依然为MyISAM，通过进一步查询源码发现早期类名已经弃用

/*
 * Hibernate, Relational Persistence for Idiomatic Java
 *
 * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
 * See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
 */
package org.hibernate.dialect;

/** A Dialect for MySQL 5 using InnoDB engine
 *
 * @author Gavin King,
 * @author Scott Marlow
 * @deprecated Use "hibernate.dialect.storage_engine=innodb" environment variable or JVM system property instead.
 */
@Deprecated
public class MySQL5InnoDBDialect extends MySQL5Dialect {

	@Override
	protected MySQLStorageEngine getDefaultMySQLStorageEngine() {
		return InnoDBStorageEngine.INSTANCE;
	}
}

但注释里并没有指明新的替代类名，而是建议通过配置实现，但SpringDataJpa自动装配的类里没有支持该配置，故如果不单独引入hibernate依赖是无法使用该配置的

最后在stackoverflow上看到解决方案：where to put hibernate.dialect.storage_engine property

即使用新的类名org.hibernate.dialect.MySQL55Dialect替换即可，尽管两个类名初看没差别，实际上差了一个数字5，影响比较大

MySQL驱动变化

在使用了新版的驱动类后，不管是MyBatis还是Jpa，都会报时区不一致和报错信息乱码的错误需要将连接URL更新

新配置

spring:
 datasource:
 driver-class-name: com.mysql.cj.jdbc.Driver
 username: root
 password: 
 url: jdbc:mysql://localhost/pw_manager?useSSL=false&useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC

原配置

spring:
 datasource:
 driver-class-name: com.mysql.jdbc.Driver
 username: cmsspringcloud
 password: cmsdbadmin
 url: jdbc:mysql://localhost:3306/cms_springcloud?characterEncoding=utf-8&useSSL=false