MyBatis入门全面解析和常见错误处理

MyBatis入门全面解析和常见错误处理

MyBatis简介
MyBatis入门
MyBatis常见错误的处理

Mybatis简介

MyBatis时apache的一个开源项目，前身角iBatis,2010年改为MyBatis。

MyBatis是基于Java的持久层框架，提供的持久层框架包括SQL Maps和Data Access Objects（DAO层）。

MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架。
MyBatis 避免了几乎所有的 JDBC 代码和手工设置参数以及抽取结果集。
MyBatis 使用简单的 XML 或注解来配置和映射基本体，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。

半自动化：需要手写SQL语句。

JDBC–>dbutils–>MyBatis–>Hibernate(过于自动化)

1、Mybatis实现了接口绑定，使用更加方便。

2、对象关系映射的改进，效率更高

3、MyBatis采用功能强大的基于OGNL的表达式来消除其他元素。

优点

1、简单易学

2、灵活

3、解除sql与程序代码的耦合

4、提供映射标签，支持对象与数据库的orm字段关系映射

5、提供对象关系映射标签，支持对象关系组建维护

6、提供xml标签，支持编写动态sql

MyBatis入门

引入依赖

使用maven在pom.xml中引入对应的jar包；

【mybatis】
mybatis-3.5.6.jar


【MYSQL 驱动包】
mysql-connector-java-8.0.21-bin.jar


【Lombok 注解工具】

lombok-1.18.21.jar

【log4j日志】

log4j-1.2.12.jar

MySQL驱动，mybatisjar包，Lombok实体类注解，junit测试单元

<dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
    </dependency>

    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>3.5.6</version>
    </dependency>
    
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>8.0.21</version>
    </dependency>
    
    <dependency>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
      <version>1.2.12</version>
    </dependency>
    
    <dependency>
      <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
      <version>1.18.16</version>
      <scope>provided</scope>
    </dependency>


  </dependencies>

首先创建数据库连接池

jdbc.droverName=com.mysql.jdbc.Driver
<!--引入属性文件的内容如果导入的MySQLjar包版本大于本机MySQL版本，后面追加时区：?serverTimezone=Asia/Shanghai-->
jdbc.url=jdbc:mysql://localhost:3306/mybatis?serverTimezone=Asia/Shanghai
jdbc.username=【连接MySQL的账户】
jdbc.password=【连接MySQL的密码】

创建mybatis的配置文件

	在resources下创建

mybatis-config.xml配置如下

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <!--导入数据库连接池-->
    <properties resource="db.properties"/>
    <!--为实体类起别名-->
    <typeAliases>
        <!--为单个类起别名-->
        <!-- <typeAlias type="com.ykq.entity.Users" alias="u"/>-->
        <!--为指定包下的类起别名 就是类的名称-->
        <package name="com.aaa.entity"/>
    </typeAliases>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC" />
            <dataSource type="POOLED">
                <!--引入属性文件的内容-->
                <property name="driver" value="${jdbc.droverName}" />
                <property name="url" value="${jdbc.url}" />
                <property name="username" value="${jdbc.username}" />
                <property name="password" value="${jdbc.password}" />
            </dataSource>
        </environment>
    </environments>
    <!--引入sql查询语句文件-->
    <mappers>
        <mapper resource="mapper/XXXMapper.xml"/>
    </mappers>
</configuration>

创建log4j.xml配置文件

log4j.rootLogger=DEBUG, Console
#Console
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n
log4j.logger.java.sql.ResultSet=INFO
log4j.logger.org.apache=INFO
log4j.logger.java.sql.Connection=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG

创建学生实体类Student

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Student {
    private Integer sId;
    private String sName;
    private String sSex;
    private String sAge;
}

创建老师实体类Teacher

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Teacher {
    private Integer tId;
    private String tName;
    private String tSex;
    private String tAge;
}

创建班级实体类Clazz

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Clazz {
    private Integer cId;
    private String cName;
    private List<Student> students;
    private Teacher teacher;
}

创建Dao层接口

public interface ClazzDao {
    public Clazz selectClazz(int id,String name);
}

创建mapper目录；

放入sql语句文件

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--namespace必须和接口的全路径匹配-->
<mapper namespace="com.aaa.dao.ClazzDao">

    <!--联表查询得到的结果-->
    <!--type返回类型该实体类类型-->
    <resultMap id="ClazzMap" type="com.aaa.entity.Clazz">
        <!--该属性的名称与字段的对应关系-->
        <!--column：为数据库字段名，property：为对应实体类属性名-->
        <id column="c_id" property="cId"/>
        <result column="c_name" property="cName"/>
		<!--association是用于一对一和多对一，而collection是用于一对多的关系-->
        <!--javaType:表示属性名对应的java实体类类型 -->
        <association property="teacher" javaType="com.aaa.entity.Teacher">
            <id column="t_id" property="tId"/>
            <result column="t_name" property="tName"/>
            <result column="t_sex" property="tSex"/>
            <result column="t_age" property="tAge"/>
        </association>


        <!--ofType:表示集合的泛型-->
        <collection property="students" ofType="com.aaa.entity.Student">
            <id column="s_id" property="sId"/>
            <result column="s_name" property="sName"/>
            <result column="s_sex" property="sSex"/>
            <result column="s_age" property="sAge"/>
        </collection>


    </resultMap>
	<!--查询语句，id对应的接口方法名，resultMap对应着返回类型-->
    <select id="selectClazz" resultMap="ClazzMap">
        select * from student s,teacher t,clazz c where s.s_class=c.c_id
         and s.s_class=c.c_id and c.c_id=#{param1} and c.c_name=#{param2}
    </select>
    
</mapper>

创建测试类

public class Test {
    public static void main(String[] args) throws Exception {
        /*读取配置文件信息*/
        Reader reader = Resources.getResourceAsReader("mybatis-config.xml");
        /*获取SqlSession工厂*/
        SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader);
        /*获取SqlSession对象*/
        SqlSession sqlSession = sessionFactory.openSession();
        /*反射获取接口名*/
        StudentDao mapper = sqlSession.getMapper(StudentDao.class);
        /*使用该接口方法*/
        Clazz clazz = mapper.selectClass(1,"一班");
        System.out.println(clazz);
    }
}

提示：接口方法多参数传入时有两种方法匹配sql

1、参数列表对应的参数写注解@param("参数名")

2、sql语句写#{param1~param n}

常见错误的处理

1、mysql错误

解决方案

jdbc.url=jdbc:mysql://localhost:3306/mybatis?serverTimezone=Asia/Shanghai

2、sql语句错误

解决方案

sql转义字符

3、association和collection顺序错误问题

错误顺序

正确顺序