初识MyBatis（一）基于配置文件下的一些增删改查-Toy模板网

这篇具有很好参考价值的文章主要介绍了初识MyBatis（一）基于配置文件下的一些增删改查。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

MyBatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO（Plain Old Java Objects，普通的Java对象）映射成数据库中的记录

MyBatis 是一个半自动的ORM（Object Relation Mapping）框架

创建好maven工程（设置打包方式为jar，引入依赖）

创建MyBatis的核心配置文件（主要用于配置连接数据库的环境以及MyBatis的全局配置信息，存放的位置是src/main/resources目录下

习惯上命名为mybatis-config.xml（将来整合Spring 之后，这个配置文件可以省略

如上在该配置文件的内容

（其中如下路径方式是以main\resources目录为准，如果UserMapper.xml在resources目录下的话，则直接写其名字即可。下面可以看出我的文件路径路径是main\resources\mappers\UserMapper.xml）
<mapper resource="mappers\UserMapper.xml"/>
创建mapper接口：MyBatis中的mapper接口相当于以前的dao。但是区别在于，mapper仅仅是接口，我们不需要提供实现类，只需要创建接口，通过mybatis的一些功能来创建一些代理实现类，当我们调用接口中的方法，直接对应其中的sql语句并执行。
public interface UserMapper {
    int insertUser();
    void updateUser();
    int deleteUser();
    User getUserById();
    List<User> getAllUser();
}
（上图的方法，都是下面增删改使用到的方法）

创建完接口后，创建mybatis的映射文件

1、映射文件的命名规则：表所对应的实体类的类名+Mapper.xml 例如：表t_user，映射的实体类为User，所对应的映射文件为UserMapper.xml
（下为UserMapper.xml文件内容
?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">
       
<mapper namespace="personal.august.mybatis.mapper.UserMapper">
   
    
    <insert id="insertUser">
        insert into t_user values(1,'wang','12345',22,'男','1@q.com')
    </insert>
</mapper>
MyBatis映射文件存放的位置是src/main/resources/mappers目录下

（无论映射文件的存放位置如何，都需要在MyBatis的配置文件中正确地指定映射文件的位置。在MyBatis的配置文件中可以使用 <mappers> 元素来指定映射文件或映射器接口的位置。
public class MybatisTest {
   @Test
   public void testInsert() throws IOException {
      //读取MyBatis的核心配置文件
      InputStream resourceAsStream = Resources.getResourceAsStream("mybatis-comfig.xml");
      //创建SqlSessionFactoryBuilder对象
      SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
      //通过核心配置文件所对应的字节输入流创建工厂类SqlSessionFactory，生产SqlSession对象
      SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(resourceAsStream);
      //创建SqlSession对象，此时通过SqlSession对象所操作的sql都必须手动提交或回滚事务
      //SqlSession sqlSession = sqlSessionFactory.openSession();
      //创建SqlSession对象，此时通过SqlSession对象所操作的sql都会自动提交
      SqlSession sqlSession = sqlSessionFactory.openSession(true);
      //通过代理模式创建UserMapper接口的代理实现类对象
      UserMapper mapper = sqlSession.getMapper(UserMapper.class);
      //调用UserMapper接口中的方法，就可以根据UserMapper的全类名匹配元素文件，通过调用的方法名匹配
      //映射文件中的SQL标签，并执行标签中的SQL语句
      int result = mapper.insertUser();
     
      //提供sql以及的唯一标识找到sql并执行，唯一标识是namespace.sqlId（记得用双引号引起）
//      int result = sqlSession.insert("personal.august.mybatis.mapper.UserMapper.insertUser");
      System.out.println(result);
      sqlSession.close();
   }
}
（补充：

SqlSession：代表Java程序和数据库之间的会话。（HttpSession是Java程序和浏览器之间的会话）

SqlSessionFactory：是“生产”SqlSession的“工厂”。

工厂模式：如果创建某一个对象，使用的过程基本固定，那么我们就可以把创建这个对象的相关代码封装到一个“工厂类”中，以后都使用这个工厂类来“生产”我们需要的对象。

navicat中在表名那里右键点击设计表则可以设置表结构

因为sqlSession的获取是固定的写法，在下面的增删改查操作中会很频繁的使用，所以我们将其创建过程的代码封装成一个工具类
public class SqlSessionUtil {
    public static SqlSession getSqlSession()  {
        SqlSession sqlSession = null;
        try {
            //获取核心配置文件的输入流
            InputStream resourceAsStream = Resources.getResourceAsStream("mybatis-comfig.xml");
            //获取SqlSessionFactoryBuilder
            SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
            //获取SqlSessionFactory
            SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(resourceAsStream);
            //获取SqlSession对象
            sqlSession = sqlSessionFactory.openSession(true);
        } catch (IOException e) {
           e.printStackTrace();
        }
        return sqlSession;
    }
}

加入log4j日志功能

在pom.xml文件中加入相关依赖

加入log4j的配置文件

log4j的配置文件名为log4j.xml，存放的位置是src/main/resources目录下

创建文件发现点小问题，发现后缀为tld，

可以按照如图去创建xml文件的模板。下次新建则可以使用自己创建的模板

新建log4j.xml后将如下内容放入
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
    <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
        <param name="Encoding" value="UTF-8" />
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS}
%m (%F:%L) \n" />
        </layout>
    </appender>
    <logger name="java.sql">
        <level value="debug" />
    </logger>
    <logger name="org.apache.ibatis">
        <level value="info" />
    </logger>
    <root>
        <level value="debug" />
        <appender-ref ref="STDOUT" />
    </root>
</log4j:configuration>
（补充：日志级别

FATAL(致命)>ERROR(错误)>WARN(警告)>INFO(信息)>DEBUG(调试) 从左到右打印的内容越来越详细

Mybatis的增删改查

update更新修改：将wang改为today，密码改为123

在UserMapper中声明方法updateUser（）

在UserMapper.xml文件中的对应的namespace下增加sql语句（下图对应id=updateUser（方法名）
<mapper namespace="personal.august.mybatis.mapper.UserMapper">
 public void testUpdate(){
      SqlSession sqlSession = SqlSessionUtil.getSqlSession();
      UserMapper mapper = sqlSession.getMapper(UserMapper.class);
      mapper.updateUser();
      sqlSession.close();
}
调用自己封装的工具类SqlSessionUtil创建SqlSession,生成代理类对象mapper，调用updateUser方法。得到如下预期中的修改结果

delete删除：删除id=1的记录

得到如下图的预期结果

select查询：

如果查询结果为一条数据则可以转换为实体类对象，如果是多条数据则转换为实体类对象的集合

查询一个实体类对象

按照之前的增删改操作去实现查询出现如上报错（我们未获得对应的结果集

如下修改（在select的标签下设置resultType属性，如果是多个字段要用resultMap属性

（resultType的类要有唯一路径说明

修改后得到如下正确结果

查询集合（查询所有数据）

（这里resultType的值和上面一样是一个类而不是最后呈现的类型list，因为是先把数据先转换为实体类对象后再放入集合）

得到如下查询结果

（注意：

1、查询的标签select必须设置属性resultType或resultMap，用于设置实体类和数据库表的映射关系

resultType：自动映射，用于属性名和表中字段名一致的情况

resultMap：自定义映射，用于一对多或多对一或字段名和属性名不一致的情况(下面内容会涉及）

2、当查询的数据为多条时，不能使用实体类作为返回值，只能使用集合，否则会抛出异常 TooManyResultsException；但是若查询的数据只有一条，可以使用实体类或集合作为返回值

核心配置文件（以我取名示例mybatis-config.xml）

可以创建properties文件方式来写配置文件

（在文件中的内容，不要故意空格，如上加了jdbc的后缀，为了标识和易于理解，如果出现多个相同内容，也可以很好的区分，This is a good habit）

用文件方式来完善内容，则要引入到配置文件中，用标签properties
<configuration>
    
    <properties resource="mappers/jdbc.properties"></properties>
 <environments default="development">
        <environment id="development" >
             <transactionManager type="JDBC"/>
               <dataSource type="POOLED">
                
                <property name="driver" value="${jdbc.driver}"/>
                
                <property name="url" value="${jdbc.url}"/>
                
                <property name="username" value="${jdbc.username}"/>
                
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>
    
    <mappers>
        <mapper resource="mappers\UserMapper.xml"/>
    </mappers>
</configuration>
（<properties resource="mappers/jdbc.properties"></properties>，如果文件在resources目录下，则直接写文件名即可）

在配置文件中的其他标签

typeAliases
<typeAliases>
        
        <typeAlias type="personal.august.mybatis.pojo.User"></typeAlias>
        
        

    </typeAliases>
（<typeAlias type="personal.august.mybatis.pojo.User"></typeAlias>，未指定别名，则默认为类名User，且不区分大小写）

设置别名后，我们在UserMapper.xml文件中引用确切的类时，则可以简写。下图对应如上我们设置的别名
核心配置文件中的标签必须按照固定的顺序：
    properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,
reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?
<mappers> 在mybatis-config.xml文件中映射文件的引用
<mappers>
    <mapper resource="mappers\UserMapper.xml"/>
</mappers>
在此之前我们是这样引入的，但是，按照这样的方式会比较麻烦，因为一个类对应一个配置文件，这样要写很多如果后面需要的话。

则我们可以通过包来引入配置文件，注意：

映射文件所在的包和mapper接口所在的包一样

只有用/分开去建文件才可以，因为我们点的是新建目录。personal/august/mybatis这样写才可以得到和接口所在一样的包。如果是用personal.august.mybatis则如下图

可以发现在idea中看不出，但实际上是一整个文件夹名，而不是和接口所在包相同。

如上图，根据我们UserMapper接口所在的包，我们为配置文件也创建相同的包，并放入。
以包的方式引入映射文件，必须满足两个条件
1、mapper接口和映射文件所在的包必须一致
2、mapper接口和映射文件的名字必须一致
在满足上述条件后，我们则可以这样引入配置文件（直接写配置文件所在包名即可，且后面还有在该包下的配置文件，也可不必修改。

设置同样的包是为了文件可以在加载完成后放在一起

MyBatis获取参数值的两种方式：${}和#{}
${}的本质就是字符串拼接，#{}的本质就是占位符赋值
${}使用字符串拼接的方式拼接sql，若为字符串类型或日期类型的字段进行赋值时，需要手动加单引号；但是#{}使用占位符赋值的方式拼接sql，此时为字符串类型或日期类型的字段进行赋值时，可以自动添加单引号。

我们要做的就是在映射文件中获取sql语句对应方法的参数，然后拼接到sql语句中

1、单个字面量类型的参数
若mapper接口中的方法参数为单个的字面量类型
此时可以使用${}和#{}以任意的名称获取参数的值，注意${}需要手动加单引号
在UserMapper接口中创建该查询方法：
User getUserByUsername(String username);
创建测试类（同名包下）ParameterTest创建测试方法：
public void testGetUserByUsername(){
    SqlSession sqlSession = SqlSessionUtil.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    User today = mapper.getUserByUsername("today");
    System.out.println(today);
}
（如上图是使用#{}，且查询到的是一条数据的情况，下面会讲到多条数据的处理，
select * from t_user where username=#{username};#里的username可以是任意名字，因为我们获取的参数值，不会识别这个名字，所以即使是abc也可，建议取的有意义一些（但是不同版本mybatis可能不同
如果是使用${}则要加‘’，如下
select * from t_user where username='${username}';
2、多个字面量类型的参数

按照第一种情况（只有一个字面量去操作时出现如下报错
在UserMapper接口中创建该查询方法：
User checklogin(String username, String password);
创建测试方法：
public void testcheckelogin(){
    SqlSession sqlSession = SqlSessionUtil.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    User user = mapper.checklogin("haha", "111");
    System.out.println(user);
}
若mapper接口中的方法参数为多个时

此时MyBatis会自动将这些参数放在一个map集合中，

以arg0,arg1...为键，以参数为值；以param1,param2...为键，以参数为值；

因此只需要通过${}和#{}访问map集合的键就可以获取相对应的值，注意${}需要手动加单引号

可知如下是可以的
select * from t_user where username = #{arg0} and password = #{arg1};
select * from t_user where username = #{param1} and password = #{param2};
上图知，效果等价于：
select * from t_user where username = #{arg0} and password = #{arg0};
而如果想混搭arg和param的正确写法为
select * from t_user where username = #{arg0} and password = #{param2};
select * from t_user where username = #{param1} and password = #{arg1};
（注意param是从1开始，arg是0）
如果是${},则记得要加‘’，如下
select * from t_user where username = '${arg0}' and password = '${arg1}';
3、map集合类型的参数
若mapper接口中的方法需要的参数为多个时

此时可以手动创建map集合，将这些数据放在map中。只需要通过${}和#{}访问map集合的键就可以获取相对应的值，注意${}需要手动加单引号
在UserMapper接口中
User checkLoginByMap(Map<String, Object> map);
创建测试方法：
public void testcheckeLoginByMap(){
    SqlSession sqlSession = SqlSessionUtil.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    HashMap<String, Object> map = new HashMap<>();
    map.put("username", "haha");
    map.put("password","111");
    User user = mapper.checkLoginByMap(map);
    System.out.println(user);
}
上图可知我们得要使用我们自己设置得参数名才可以，

如果是${},则记得要加‘ ’，如下
select * from t_user where username = '${username}' and password = '${password}';
4、实体类类型的参数
若mapper接口中的方法参数为实体类对象时
此时可以使用${}和#{}，通过访问实体类对象中的属性名获取属性值，注意${}需要手动加单引号
在UserMapper接口中
void insertUser(User user);
创建测试方法：
public void testinsertUser(){
    SqlSession sqlSession = SqlSessionUtil.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    User user= new User(1, "saturday", "1234567", 22, "女", "99@qq.com");
    mapper.insertUser(user);
}
在UserMapper.xml中
<insert id="insertUser" >
    insert t_user values(null,#{username},#{password},#{age},#{gender},#{email});
</insert>
5、使用@Param标识参数
可以通过@Param注解标识mapper接口中的方法参数
此时，会将这些参数放在map集合中，以@Param注解的value属性值为键，以参数为值；以
param1,param2...为键，以参数为值；只需要通过${}和#{}访问map集合的键就可以获取相对应的值，注意${}需要手动加单引号
在UserMapper接口中
void checkLoginByParam(@Param("username")String username,@Param("password")String password);
创建测试方法：
public void testcheckLoginByParam(){
    SqlSession sqlSession = SqlSessionUtil.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    User user = mapper.checklogin("what", "234");
    System.out.println(user);
}
在这种方法中，我们有两种访问方式（username，password）（param1，param2）

所以（username，param2）（param1，password）也是可以的
select * from t_user where username = #{username} and password = #{password};
select * from t_user where username = #{param1} and password = #{param2};

MyBatis的各种查询功能

1、查询一个实体类对象

在SelectMapper接口中
User getUserById(@Param("id")Integer id);
List<User> getAllUser();

创建测试类（同名包下）SelectMapperTest 创建测试方法：
public void testGetUserById(){
    SqlSession sqlSession = SqlSessionUtil.getSqlSession();
    SelectMapper mapper = sqlSession.getMapper(SelectMapper.class);
    User user = mapper.getUserById(1);
    System.out.println(user);
}

public void testGetALLUser(){
    SqlSession sqlSession = SqlSessionUtil.getSqlSession();
    SelectMapper mapper = sqlSession.getMapper(SelectMapper.class);
    List<User> allUser = mapper.getAllUser();
    allUser.forEach(System.out::println);
}

在SelectMapper.xml中
 <!--User getUserById(@Param("id")Integer id);-->
    <select id="getUserById" resultType="User">
        select * from t_user where id = #{id};
    </select>

    <!--List<User> getAllUser();-->
    <select id="getAllUser" resultType="User">
        select * from t_user;
    </select>

这个其实就是上面出现过的查询，要注意的是，当我们查询的是多条数据时，返回类型不能是一个实体类。

2、查询单个数据

在SelectMapper接口中
Integer getCount();

创建测试方法：
public void testGetCount(){
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        SelectMapper mapper = sqlSession.getMapper(SelectMapper.class);
        Integer count = mapper.getCount();
        System.out.println(count);
    }

在SelectMapper.xml中
 <select id="getCount" resultType="java.lang.Integer">
        select count(*) from t_user;
    </select>

select count(*) from t_user;
其中的*可以是任意的数值，但是如果是字段则要注意，当该字段下的值为null时，不计数， <select id="getCount" resultType="java.lang.Integer">
其中 resultType的值可以是int，integer，大小写不区分
因为在MyBatis中，对于Java中常用的类型都设置了类型别名
* 例如：java.lang.Integer-->int|integer
* 例如：int-->_int|_integer
* 例如：Map-->map,List-->list

（补充，在看到用integer当方法返回值类型，而不是int时，有点疑惑，于是

包装类型和基本类型的差别(由方法返回值想到的问题)_boolean传参传基本类型还是包装类型_早点起床晒太阳的博客-CSDN博客

3、查询一条数据为map集合

在SelectMapper接口中
Map<String,Object> getUserByIdMap(@Param("id")Integer id);

创建测试方法：
public void testgetUserByIdMap(){
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        SelectMapper mapper = sqlSession.getMapper(SelectMapper.class);
        Map<String, Object> userByIdMap = mapper.getUserByIdMap(2);
        System.out.println(userByIdMap);
    }

在SelectMapper.xml中
 <select id="getUserByIdMap" resultType="map">
        select * from t_user where id = #{id};
    </select>